mirror of https://github.com/actions/setup-java.git synced 2024-12-25 00:12:17 -05:00

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

Find a file

Bryan Clark 495409509c parent 52c60e0768c1c2fabcab3acf97aa77c5dbc32dfa author Bryan Clark <clarkbw@github.com> 1573862473 -0800 committer Bryan Clark <clarkbw@github.com> 1574976093 -0800 Adding maven auth support ignore vscode directory move required parameters to auth module username and password are required from within the auth module now. Update the tests to ensure this is the case. Add generated auth and setup-java Move auth to the bottom of setup Support ids generated and pretty files use server-id instead of ambigous id Use console.log where appropriate Adding maven auth support ignore vscode directory move required parameters to auth module username and password are required from within the auth module now. Update the tests to ensure this is the case. Add generated auth and setup-java Move auth to the bottom of setup generated and pretty files use server-id instead of ambigous id		2019-11-28 13:35:47 -08:00
.github	Create lint-yaml.yml	2019-11-25 12:16:39 -05:00
__tests__	Support ids	2019-11-28 13:35:47 -08:00
dist	Update gitattributes and remove lib files	2019-11-28 13:35:47 -08:00
docs	Update contributors.md	2019-11-25 11:36:48 -05:00
lib	parent 52c60e0768c1c2fabcab3acf97aa77c5dbc32dfa	2019-11-28 13:35:47 -08:00
src	Use console.log where appropriate	2019-11-28 13:35:47 -08:00
.gitattributes	Update gitattributes and remove lib files	2019-11-28 13:35:47 -08:00
.gitignore	ignore vscode directory	2019-11-28 13:35:47 -08:00
.prettierrc.json	Populate repo	2019-07-10 10:54:25 -04:00
action.yml	Update action.yml	2019-11-25 10:21:42 -05: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	Cleanup	2019-11-25 10:12:17 -05:00
package.json	Cleanup	2019-11-25 10:12:17 -05:00
README.md	Update README.md	2019-11-22 16:26:10 -05:00
tsconfig.json	Populate repo	2019-07-10 10:54:25 -04:00
yaml-lint-config.yml	Create yaml-lint-config.yml	2019-11-25 12:15:12 -05:00

README.md

setup-java

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

optionally downloading and caching a requested version of java by version and adding to PATH. Default downloads are populated from the Zulu Community distribution of OpenJDK
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). To specify a specific version for JDK 8 or older use the following pattern (8.0.x)
    java-package: jdk # (jre, jdk, or jdk+fx) - defaults to jdk
    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 found on Zulu Community CDN
- run: java -cp java HelloWorldApp

Matrix Testing:

jobs:
  build:
    runs-on: ubuntu-16.04
    strategy:
      matrix:
        # test against latest update of each major Java version, as well as specific updates of LTS versions:
        java: [ 1.6, 6.0.83, 7, 7.0.181, 8, 8.0.192, 9.0,x, 10, 11.0.x, 11.0.3, 12, 13 ]
    name: Java ${{ matrix.java }} sample
    steps:
      - uses: actions/checkout@master
      - name: Setup java
        uses: actions/setup-java@v1
        with:
          java-version: ${{ matrix.java }}
      - 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