setup-java

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 distributions
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 vs V1

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 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

Input distribution is mandatory. See Supported distributions section for the list of available options.

Basic

steps:
- uses: actions/checkout@v2
- uses: actions/setup-java@v2-preview
  with:
    distribution: 'adoptium' # See 'Supported distributions' for available options
    java-version: '11'
- run: java -cp java HelloWorldApp

Supported version syntax

Input 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

Supported distributions

Currently, the following distributions 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.

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

License

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

Contributions

Contributions are welcome! See Contributor's Guide

3.9 KiB Raw Blame History