Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion docs/changes.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

What changed in each release, as a user notices it. GitHub's release pages list the pull requests.

## Unreleased
## 0.6.6 (2026-11-10)

- `vfox link --detect java` adopts the JDKs that are already on the machine instead of downloading another copy: Gradle's, IntelliJ IDEA's, the system directories, SDKMAN, asdf, mise, jabba, Homebrew, Scoop, the CI runner tool cache and `JAVA_HOME`. It needs vfox 1.1.0 or later. See [link.md](link.md).

Expand Down
2 changes: 1 addition & 1 deletion docs/development.md
Original file line number Diff line number Diff line change
Expand Up @@ -173,7 +173,7 @@ The documentation marks what is newer than the last release with "Unreleased" ("

1. Move those entries in [changes.md](changes.md) under the new version, with the date of the release, and take the remarks out, in both languages: `grep -rn -i -e unreleased -e 未发布 docs README*`.
2. Search for the number of the previous release: a few sentences compare against it without saying "Unreleased".
3. Pages that quote Foojay give the day the data was taken. Bring up to date the quotes that name the newest release of something (`21.0.13+9-tem` on 2026-11-03), and check the tables against Foojay again, see [Refreshing the platform table](#refreshing-the-platform-table).
3. Pages that quote Foojay give the day the data was taken. Bring up to date the quotes that name the newest release of something (`21.0.13+9-tem` on 2026-11-10), and check the tables against Foojay again, see [Refreshing the platform table](#refreshing-the-platform-table).

## Writing the docs

Expand Down
10 changes: 5 additions & 5 deletions docs/distributions.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

[中文](zh-CN/distributions.md) | [English](distributions.md)

The plugin gets the releases and download links of these 31 distributions from [Foojay](foojay.md), all that Foojay lists on 2026-11-03. The short name or the long name goes wherever a distribution does: `21-tem`, `21-temurin`, `temurin-21`, `vfox search java tem`.
The plugin gets the releases and download links of these 31 distributions from [Foojay](foojay.md), all that Foojay lists on 2026-11-10. The short name or the long name goes wherever a distribution does: `21-tem`, `21-temurin`, `temurin-21`, `vfox search java tem`.

| Short name | Long name | Distribution | Maintained by |
| --- | --- | --- | --- |
Expand Down Expand Up @@ -44,7 +44,7 @@ Which operating systems and CPUs each distribution covers is in [platforms.md](p

## Short names and SDKMAN

The short names follow the identifiers of [SDKMAN](https://sdkman.io/), where Temurin 21.0.8 is `21.0.8-tem` too. These are the differences, against SDKMAN's list of 2026-11-03:
The short names follow the identifiers of [SDKMAN](https://sdkman.io/), where Temurin 21.0.8 is `21.0.8-tem` too. These are the differences, against SDKMAN's list of 2026-11-10:

- JetBrains Runtime is `jb`, which SDKMAN calls `jbr`, and BiSheng is `bsg`, which SDKMAN calls `bisheng`, the plugin's long name for it. A `.sdkmanrc` takes SDKMAN's spellings, see [sdkmanrc.md](sdkmanrc.md).
- SDKMAN no longer lists Dragonwell, TravaOpenJDK, AdoptOpenJDK, Gluon GraalVM or the GraalVM CE builds numbered after GraalVM. It called the last three `adpt`, `gln` and `grl`, and wrote the virtual machine or the JDK into the version: `11.0.10.hs-adpt` with HotSpot, `11.0.10.j9-adpt` with OpenJ9, `22.3.3.r17-grl` on JDK 17. Here each Foojay distribution has a name of its own, so that part moved into the name: `11.0.10-adpt`, `11.0.10-adptj9`, `22.3.3-grl17`. A `.sdkmanrc` with SDKMAN's spelling selects them.
Expand Down Expand Up @@ -154,11 +154,11 @@ GraalVM Community Edition up to 22.3, from before it numbered its releases after

### Behavior of Oracle GraalVM and GraalVM Community

- Since 25.1 (June 2026) GraalVM puts out a feature release every month next to its 25.0 line: `25.1.3`, `25.2.4`, `25.3.4.1`, `25.4.4.1.1`. Each is replaced within about a month. Foojay marks Oracle GraalVM's STS, but GraalVM Community's LTS where it lists them the old way round (see below), as the JDK they build on is LTS. `vfox search` leaves the LTS note off them all.
- Since 25.1 (June 2026) GraalVM puts out a feature release every month next to its 25.0 line: `25.1.3`, `25.2.4`, `25.3.4.1`, `25.4.4.1.1`, `25.5.5.0.3`. Each is replaced within about a month. Foojay marks Oracle GraalVM's STS, but GraalVM Community's LTS where it lists them the old way round (see below), as the JDK they build on is LTS. `vfox search` leaves the LTS note off them all.
- Releases are named after GraalVM's own version, which Foojay gives as `distribution_version`. Foojay's `java_version` is the JDK's version, which a feature release shares with the 25.0 line: `25.4.4.1.1-graal`, `25.3.4.1-graal`, `25.0.4.1.1-graal` and `25.0.4.1-graal` all have the `java_version` 25.0.4.1.
- Foojay lists GraalVM Community's feature releases under GraalVM's version too, as it did before October 2026, with downloads from GitHub. So `java@25.4.4.1-graalce`, the name release 0.6.2 gives the 25.4.4.1.1 build, still installs it from GitHub, while `java@25.4.4.1.1-graalce` gets the same file from Oracle's GraalVM Download Service.
- `java@25-graal` installs the newest build of the 25.0 line (`25.0.5.0.3-graal` on 2026-11-03), the line Oracle's own `25/latest` download follows. A feature release needs its full version: `java@25.4.4.1.1-graal`. `vfox use java@25-graal` and `java=25-graal` in a `.sdkmanrc` select the newest installed build of that line too, and a feature release only where nothing else of 25 is installed.
- GraalVM Community's 25.0 line ended with `25.0.2`, and the feature releases are all it still ships. `java@25-graalce` installs the newest of them, `25.4.4.1.1-graalce` on 2026-11-03.
- `java@25-graal` installs the newest build of the 25.0 line (`25.0.5.0.3-graal` on 2026-11-10), the line Oracle's own `25/latest` download follows. A feature release needs its full version: `java@25.5.5.0.3-graal`. `vfox use java@25-graal` and `java=25-graal` in a `.sdkmanrc` select the newest installed build of that line too, and a feature release only where nothing else of 25 is installed.
- GraalVM Community's 25.0 line ended with `25.0.2`, and the feature releases are all it still ships. `java@25-graalce` installs the newest of them, `25.5.5.0.3-graalce` on 2026-11-10.
- The plugin sets `JAVA_HOME` and `PATH`, and no `GRAALVM_HOME`. A `GRAALVM_HOME` that points at a GraalVM of your own stays as it is, and the native-image build plugins fall back to `JAVA_HOME` when it is unset.
- There is no Windows ARM64 and no Alpine build, and Intel Macs get nothing after 25.0.1. See [platforms.md](platforms.md#graalvm).

Expand Down
4 changes: 2 additions & 2 deletions docs/e2e.md
Original file line number Diff line number Diff line change
Expand Up @@ -286,7 +286,7 @@ JDK, so `java` can only come from what vfox installs:
and no mirror that works is run.
3. On the GraalVM Community rows, Oracle GraalVM's bare major `25-graal`
installs the newest build of its 25.0 line (`25.0.5.0.3-graal` on
2026-11-03), the line Oracle's own `25/latest` download follows, not one
2026-11-10), the line Oracle's own `25/latest` download follows, not one
of the monthly feature releases listed before it (`25.4.4.1.1-graal`).
`vfox search java graal` must list those under GraalVM's own version,
and mark the other releases of 25 alike, as in item 5. The plugin used to
Expand Down Expand Up @@ -360,7 +360,7 @@ JDK, so `java` can only come from what vfox installs:

The install itself must also have verified the download. Foojay lists a
checksum for the pinned release of every default distribution on every
runner (2026-11-03), and `vfox install` must print `Verifying checksum
runner (2026-11-10), and `vfox install` must print `Verifying checksum
<digest>...` with a digest of a length vfox supports, not `WARNING:
Checksum is not provided, skip verify...`, which every install ended with
until the plugin passed Foojay's checksums on. The digests come in four
Expand Down
6 changes: 3 additions & 3 deletions docs/foojay.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ curl -s 'https://api.foojay.io/disco/v3.0/packages/jdks?version=27&latest=availa
| jq -r '.result[].distribution' | sort -u
```

On 2026-11-03 this printed `corretto liberica oracle semeru zulu`. Temurin and OpenJDK were not among them: they stopped at 26 there. Use `latest=available` for a bare major, as the plugin does, and leave it out for a longer version.
On 2026-11-10 this printed `corretto liberica oracle semeru zulu`. Temurin and OpenJDK were not among them: they stopped at 26 there. Use `latest=available` for a bare major, as the plugin does, and leave it out for a longer version.

## The versions of one distribution

Expand Down Expand Up @@ -153,7 +153,7 @@ So the plugin asks for every package of these two, as `vfox search` does, and pi

## Checksums

The record that `links.pkg_info_uri` points to also says how to check the download. `checksum_type` is the algorithm, and the digest is in the record as `checksum`, or in a file of the vendor that `checksum_uri` points to. GraalVM Community 25.0.2 has the file only (2026-11-03):
The record that `links.pkg_info_uri` points to also says how to check the download. `checksum_type` is the algorithm, and the digest is in the record as `checksum`, or in a file of the vendor that `checksum_uri` points to. GraalVM Community 25.0.2 has the file only (2026-11-10):

```bash
curl -s 'https://api.foojay.io/disco/v3.0/packages/jdks?distribution=graalvm_community&version=25.0.2&architecture=amd64&operating_system=linux&lib_c_type=glibc&archive_type=tar.gz&directly_downloadable=true' \
Expand All @@ -176,7 +176,7 @@ The digest in Foojay's record goes first. It comes from Foojay and not from the

A file that lists several packages gives the line of the one being installed. One that lists others only gives none: Microsoft's file for its EA build of 11.0.14 for macOS names the GA build, and that digest would fail an install that is fine.

Which packages come with a checksum varies by release, and Foojay holds none for some distributions. For the newest releases (2026-11-03):
Which packages come with a checksum varies by release, and Foojay holds none for some distributions. For the newest releases (2026-11-10):

| Foojay lists | Short names |
| --- | --- |
Expand Down
2 changes: 1 addition & 1 deletion docs/install-from-source.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ vfox use --global java@21-tem
java -version
```

`vfox install java@21-tem` installs the newest Temurin 21, `21.0.13+9-tem` on 2026-11-03.
`vfox install java@21-tem` installs the newest Temurin 21, `21.0.13+9-tem` on 2026-11-10.

## When java is already added

Expand Down
2 changes: 1 addition & 1 deletion docs/javafx.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ A build with JavaFX lists `javafx.base` and the others, one without lists none.

## Where JavaFX builds exist

As of 2026-11-03 four distributions have them, and not for every platform. The table lists the LTS releases that have a JavaFX build. The releases in between have some too, with gaps. For Liberica NIK it gives the Java version, not the GraalVM version in its names (see [distributions.md](distributions.md#behavior-of-mandrel-and-liberica-nik)): its JavaFX builds for Java 21 are `23.1.x-nik-fx`.
As of 2026-11-10 four distributions have them, and not for every platform. The table lists the LTS releases that have a JavaFX build. The releases in between have some too, with gaps. For Liberica NIK it gives the Java version, not the GraalVM version in its names (see [distributions.md](distributions.md#behavior-of-mandrel-and-liberica-nik)): its JavaFX builds for Java 21 are `23.1.x-nik-fx`.

| Distribution | Linux x64 | Linux arm64 | Alpine x64 | macOS Intel | macOS Apple silicon | Windows x64 | Windows arm64 |
| --- | --- | --- | --- | --- | --- | --- | --- |
Expand Down
2 changes: 1 addition & 1 deletion docs/mirror.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Then install as usual, `vfox install java@21-tem`. To go back to github.com, uns

Only requests for `https://github.com/`: the downloads, and the checksum files on GitHub that the plugin reads for them (see [Notes](#notes)). A JDK on any other host downloads from there as before, and the requests to Foojay do not change.

Where Foojay links each distribution (2026-11-03):
Where Foojay links each distribution (2026-11-10):

| Short names | Download from |
| --- | --- |
Expand Down
4 changes: 2 additions & 2 deletions docs/platforms.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ The plugin asks Foojay for packages of the platform it runs on: the operating sy
No JDK found for 21-bsg on darwin/arm64. Please check available versions with 'vfox search java'
```

The table shows which platforms each distribution has packages for, as Foojay lists them on 2026-11-03. ✅ means Foojay lists at least one package the plugin can install there, ❌ means none.
The table shows which platforms each distribution has packages for, as Foojay lists them on 2026-11-10. ✅ means Foojay lists at least one package the plugin can install there, ❌ means none.

| Distribution | Linux x64 | Linux arm64 | Alpine x64 | Alpine arm64 | macOS Intel | macOS Apple silicon | Windows x64 | Windows arm64 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
Expand Down Expand Up @@ -50,7 +50,7 @@ Foojay changes, and the table with it. To get the current one, ask Foojay the wa

## Only some releases

A ✅ does not mean every release is there. As of 2026-11-03:
A ✅ does not mean every release is there. As of 2026-11-10:

- Windows on ARM64 has no Java 8 from anyone. Temurin has 21 and 23 there, Zulu 16 to 19, 21, 25 and 27, Liberica 11 and 16 to 27, Microsoft 11, 16, 17, 21 and 25, and JetBrains Runtime 17, 21 and 25.
- On Apple silicon Java 8 comes from Zulu, Liberica, Corretto and Kona. Temurin and Semeru have 11 and 17 to 27 there, and OpenJDK 17 to 27. Mandrel has releases 23.1 to 25, for Java 21 to 25, and Liberica NIK 22.2 to 25, for Java 11, 17 and 20 to 25 (see [their numbers](distributions.md#behavior-of-mandrel-and-liberica-nik)). Gluon GraalVM has 22.1.0.1 and 23+25, GraalVM CE 11 and 17 have GraalVM 22.1 to 22.3.1, and GraalVM CE 19 has 22.3 and 22.3.1.
Expand Down
4 changes: 2 additions & 2 deletions docs/sdkman.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,8 +39,8 @@ The scopes of `vfox use` correspond to SDKMAN's: `--session`, the default, to `s
## What differs

- **Identifiers.** SDKMAN's `21.0.8-tem` goes after `java@` as it is, and the short names are SDKMAN's, with a few exceptions such as `jb`, which SDKMAN calls `jbr`, see [distributions.md](distributions.md#short-names-and-sdkman). A release padded with a zero, as in SDKMAN's current identifiers (`25.0.5.0+8-tem`), is accepted. JavaFX is `-fx` at the end, `21.0.12-zulu-fx`. SDKMAN's `21.0.12.fx-zulu` is not a spec that `vfox install` takes, though a `.sdkmanrc` can hold it, see [sdkmanrc.md](sdkmanrc.md#sdkmans-spellings).
- **A bare major.** `vfox install java@21-tem` installs the newest Temurin 21, `21.0.13+9-tem` on 2026-11-03. SDKMAN's `21-tem` is one release, the GA build `21+35`.
- **No default JDK.** `sdk install java` installs SDKMAN's default, a Temurin LTS release (`25.0.5.0+8-tem` on 2026-11-03). `vfox install java` has none: in a terminal it asks you to pick a version, in a script it fails. A version without a distribution (`java@21`) is OpenJDK from jdk.java.net, which has nothing newer than 21.0.2 for 21. Write `java@21-tem`, see [versions.md](versions.md#without-a-distribution).
- **A bare major.** `vfox install java@21-tem` installs the newest Temurin 21, `21.0.13+9-tem` on 2026-11-10. SDKMAN's `21-tem` is one release, the GA build `21+35`.
- **No default JDK.** `sdk install java` installs SDKMAN's default, a Temurin LTS release (`25.0.5.0+8-tem` on 2026-11-10). `vfox install java` has none: in a terminal it asks you to pick a version, in a script it fails. A version without a distribution (`java@21`) is OpenJDK from jdk.java.net, which has nothing newer than 21.0.2 for 21. Write `java@21-tem`, see [versions.md](versions.md#without-a-distribution).
- **Installing does not select.** After `sdk install`, SDKMAN asks whether the JDK becomes the default. `vfox install` only installs, and `vfox use` selects.
- **Two lists.** `sdk list java` shows every vendor's JDKs. `vfox search java` lists OpenJDK only, so name a distribution (`vfox search java tem`) or write `all`. `vfox list java` shows what is installed. The versions come from [Foojay](foojay.md).
- **Installed names carry the build number.** `vfox list java` shows `21.0.8+9-tem`, which `vfox uninstall` and `vfox info` need in full, while `vfox use java@21.0.8-tem` finds it without the build, see [versions.md](versions.md#installed-names).
Expand Down
Loading
Loading