setup-java/docs/switching-to-v2.md
2021-03-08 18:49:54 +03:00

1.5 KiB

Switching to V2

Java distribution

The major breaking change in V2 is the new mandatory input distribution. This field should be specified with one of supported distributions. See Supported distributions section for the list of available options.
Use zulu keyword if you would like to continue using the same distribution as in the V1.

steps:
- uses: actions/checkout@v2
- uses: actions/setup-java@v2-preview
  with:
    distribution: 'zulu'
    java-version: '11'
    java-package: jdk # optional (jdk or jre) - defaults to jdk
- run: java -cp java HelloWorldApp

General recommendation — configure CI with the same distribution that is used on your local dev machine.

Installing custom Java distribution from local file

Since distribution input is required in V2, you should specify it as jdkFile to continue installing Java from local file

steps:
- run: |
    download_url="https://github.com/AdoptOpenJDK/openjdk11-binaries/releases/download/jdk-11.0.10%2B9/OpenJDK11U-jdk_x64_linux_hotspot_11.0.10_9.tar.gz"
    wget -O $RUNNER_TEMP/java_package.tar.gz $download_url    
- uses: actions/setup-java@v2-preview
  with:
    distribution: 'jdkFile'
    jdkFile: ${{ runner.temp }}/java_package.tar.gz
    java-version: '11.0.0'
    architecture: x64

Dropping legacy Java version syntax 1.x

V1 supported legacy Java syntax like 1.8 (same as 8), 1.8.0.212 (same as 8.0.212). V2 dropped support of old syntax so workflows should be changed accordingly.