804a60faf9
* add overwrite-settings parameter * fix e2e tests * print debug * fix e2e tests * add comment * remove comment |
||
|---|---|---|
| __tests__ | ||
| .github | ||
| .licenses/npm | ||
| dist | ||
| docs | ||
| src | ||
| .gitattributes | ||
| .gitignore | ||
| .licensed.yml | ||
| .prettierrc.json | ||
| action.yml | ||
| CONTRIBUTING.md | ||
| jest.config.js | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| tsconfig.json | ||
| yaml-lint-config.yml | ||
setup-java
This action provides the following functionality for GitHub Actions runners:
- Downloading and setting up a requested version of Java. See Usage for a list of supported distributions
- Extracting and caching custom version of Java from a local file
- Configuring runner for publishing using Apache Maven
- Configuring runner for publishing using Gradle
- Configuring runner for using GPG private key
- Registering problem matchers for error output
V2 vs V1
- V2 supports custom distributions and provides support for Zulu OpenJDK and Adopt OpenJDK out of the box. V1 supports only Zulu OpenJDK
- V2 requires you to specify distribution along with the version. V1 defaults to Zulu OpenJDK, only version input is required. Follow the migration guide to switch from V1 to V2
Usage
Inputs java-version and distribution are mandatory. See Supported distributions section for a list of available options.
Basic
Adopt OpenJDK
steps:
- uses: actions/checkout@v2
- uses: actions/setup-java@v2-preview
with:
distribution: 'adopt' # See 'Supported distributions' for available options
java-version: '11'
- run: java -cp java HelloWorldApp
Zulu OpenJDK
steps:
- uses: actions/checkout@v2
- uses: actions/setup-java@v2-preview
with:
distribution: 'zulu' # See 'Supported distributions' for available options
java-version: '11'
- run: java -cp java HelloWorldApp
Supported version syntax
The java-version input supports an exact version or a version range using SemVer notation:
- major versions:
8,11,15 - more specific versions:
11.0,11.0.4,8.0.232,8.0.282+8 - early access (EA) versions:
15-ea,15.0.0-ea,15.0.0-ea.2,15.0.0+2-ea
Note: 4-digit notation will always force action to skip checking pre-cached versions and download version in runtime.
Supported distributions
Currently, the following distributions are supported:
| Keyword | Distribution | Official site | License |
|---|---|---|---|
zulu |
Zulu OpenJDK | Link | Link |
adopt |
Adopt OpenJDK | Link | Link |
NOTE: The different distributors can provide discrepant list of available versions / supported configurations. Please refer to the official documentation to see the list of supported versions.
Testing against different Java versions
jobs:
build:
runs-on: ubuntu-20.04
strategy:
matrix:
java: [ '8', '11', '13', '15' ]
name: Java ${{ matrix.Java }} sample
steps:
- uses: actions/checkout@v2
- name: Setup java
uses: actions/setup-java@v2-preview
with:
distribution: '<distribution>'
java-version: ${{ matrix.java }}
- run: java -cp java HelloWorldApp
Advanced
- Selecting a Java distribution
- Installing custom Java package type
- Installing custom Java architecture
- Installing custom Java distribution from local file
- Testing against different Java distributions
- Testing against different platforms
- Publishing using Apache Maven
- Publishing using Gradle
License
The scripts and documentation in this project are released under the MIT License
Contributions
Contributions are welcome! See Contributor's Guide