Skip to content

docs: note jdkfile approach for Early Access / unreleased JDK builds #1058

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
brunoborges merged 5 commits into from
Jun 23, 2026
+20 −0
Merged

docs: note jdkfile approach for Early Access / unreleased JDK builds #1058

Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
8d6a81a
docs: note jdkfile approach for Early Access / unreleased JDK builds
brunoborges Jun 23, 2026
9c56b21
Potential fix for pull request finding
brunoborges Jun 23, 2026
ca0aaa4
Merge branch 'main' into docs/jdkfile-early-access
brunoborges Jun 23, 2026
8d61966
Apply suggestions from code review
brunoborges Jun 23, 2026
7eabafc
Merge branch 'main' into docs/jdkfile-early-access
brunoborges Jun 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
docs: note jdkfile approach for Early Access / unreleased JDK builds 
Clarify in advanced-usage that the existing 'jdkfile' distribution can be
used to install Early Access (EA) or other unreleased JDK builds not
provided directly by setup-java, by downloading the archive in a prior
step and pointing jdkFile at it. Adds a concrete EA example.

Addresses #612.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  • Loading branch information
@brunoborges
brunoborges and Copilot committed Jun 23, 2026
commit 8d6a81aeae1dd4eac7f2166d7fbc23e6a619332f
20 changes: 20 additions & 0 deletions docs/advanced-usage.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -270,6 +270,9 @@ steps:
## Installing Java from local file
If your use-case requires a custom distribution or a version that is not provided by setup-java, you can download it manually and setup-java will take care of the installation and caching on the VM:

> [!NOTE]
> This approach also lets you use builds that setup-java does not provide directly, such as **Early Access (EA)** or other unreleased JDK builds (for example, an upcoming feature release or a loom/valhalla preview build). Download the desired archive in a prior step and point `jdkFile` at it; setup-java will extract, install, and cache it just like a supported distribution. When targeting multiple architectures, select the correct binary per architecture in your workflow (for example, with a build matrix).
Comment thread
brunoborges marked this conversation as resolved.
Outdated

Comment thread
brunoborges marked this conversation as resolved.
```yaml
steps:
- run: |
Expand All @@ -285,6 +288,23 @@ steps:
- run: java --version
```

For example, to use an **Early Access** build (such as an upcoming feature release from [jdk.java.net](https://jdk.java.net/)) that is not yet available through a regular distribution:

Comment thread
brunoborges marked this conversation as resolved.
Outdated
```yaml
steps:
- run: |
download_url="https://download.java.net/java/early_access/jdk25/36/GPL/openjdk-25-ea+36_linux-x64_bin.tar.gz"
wget -O $RUNNER_TEMP/java_package.tar.gz $download_url
- uses: actions/setup-java@v5
with:
distribution: 'jdkfile'
jdkFile: ${{ runner.temp }}/java_package.tar.gz
java-version: '25-ea'
architecture: x64
Comment thread
brunoborges marked this conversation as resolved.
Comment thread
brunoborges marked this conversation as resolved.

- run: java --version
```

If your use-case requires a custom distribution (in the example, alpine-linux is used) or a version that is not provided by setup-java and you want to always install the latest version during runtime, then you can use the following code to auto-download the latest JDK, determine the semver needed for setup-java, and setup-java will take care of the installation and caching on the VM:

```yaml
Expand Down