This action provides the following functionality for GitHub Actions runners:
- Downloading and setting up a requested version of Java. See Usage section for the list of supported distributors
- Extracting and caching custom version of Java from 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 has support of custom distributions and provides support of Zulu OpenJDK and Adoptium (former AdoptOpenJDK) out of the box. V1 supports only Zulu OpenJDK
- V2 requires you to specify distributor along with the version. V1 defaults to Zulu OpenJDK, only version input is required. Follow the migration guide to switch from V1 to V2
Input distribution is mandatory. See Supported distributions section for the list of available options.
steps:
- uses: actions/checkout@v2
- uses: actions/setup-java@v2-preview
with:
distribution: 'adoptium' # See 'Supported distributions' for available options
java-version: '11.x'
- run: java -cp java HelloWorldAppInput java-version supports version range or exact version in SemVer format:
- major versions:
8,11,15,11.x - more specific versions:
8.0.232,11.0.4,11.0,11.0.x - an early access (EA) versions:
15-ea,15.0.0-ea,15.0.0-ea.2
Currently, the following distributors are supported:
| Keyword | Distribution | Official site | License |
|---|---|---|---|
zulu |
Zulu (Zulu OpenJDK) | Link | Link |
adoptium |
Adoptium (former 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.
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- Selecting 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
The scripts and documentation in this project are released under the MIT License
Contributions are welcome! See Contributor's Guide