mirror of https://github.com/actions/setup-java.git synced 2024-11-06 00:55:54 -05:00

Set up your GitHub Actions workflow with a specific version of Java

Find a file

Konrad Pabjan b02f296bae Merge pull request #28 from actions/ethomson/update_description Update description		2019-11-19 17:49:22 -05:00
.github	steps not actions	2019-07-25 22:59:48 -04:00
__tests__	Fix build. (#11 )	2019-07-30 14:01:45 -04:00
docs	Populate repo	2019-07-10 10:54:25 -04:00
lib	Use java-version (#14 )	2019-08-13 16:24:39 -04:00
node_modules	Consume toolkit from npmjs (#16 )	2019-08-20 10:26:11 -04:00
src	Use java-version (#14 )	2019-08-13 16:24:39 -04:00
.gitignore	Update .gitignore (#17 )	2019-08-27 11:14:19 -04:00
.prettierrc.json	Populate repo	2019-07-10 10:54:25 -04:00
action.yml	Update action.yml	2019-11-08 16:40:12 +00:00
jest.config.js	Populate repo	2019-07-10 10:54:25 -04:00
LICENSE	Populate repo	2019-07-10 10:54:25 -04:00
package-lock.json	Consume toolkit from npmjs (#16 )	2019-08-20 10:26:11 -04:00
package.json	Consume toolkit from npmjs (#16 )	2019-08-20 10:26:11 -04:00
README.md	Update README	2019-11-08 16:40:52 +00:00
tsconfig.json	Populate repo	2019-07-10 10:54:25 -04:00

README.md

setup-java

This action sets up a java environment for use in actions by:

optionally downloading and caching a version of java by version and adding to PATH. Downloads from Azul's Zulu distribution.
registering problem matchers for error output

Usage

See action.yml

Basic:

steps:
- uses: actions/checkout@v1
- uses: actions/setup-java@v1
  with:
    java-version: '9.0.4' // The JDK version to make available on the path. Takes a whole or semver JDK version, or 1.x syntax (e.g. 1.8 => JDK 8.x)
    architecture: x64 // (x64 or x86) - defaults to x64
- run: java -cp java HelloWorldApp

From local file:

steps:
- uses: actions/checkout@v1
- uses: actions/setup-java@v1
  with:
    java-version: '4.0.0'
    architecture: x64
    jdkFile: <path to jdkFile> # Optional - jdkFile to install java from. Useful for versions not supported by Azul
- run: java -cp java HelloWorldApp

Matrix Testing:

jobs:
  build:
    runs-on: ubuntu-16.04
    strategy:
      matrix:
        java: [ '1.6', '9.0.x', '12.0.2' ]
    name: Java ${{ matrix.java }} sample
    steps:
      - uses: actions/checkout@master
      - name: Setup java
        uses: actions/setup-java@v1
        with:
          java-version: ${{ matrix.java }}
          architecture: x64
      - run: java -cp java HelloWorldApp

License

The scripts and documentation in this project are released under the MIT License

Contributions

Contributions are welcome! See Contributor's Guide