From 35ac2e3c6a022a3469a4719b65ad896a321a8e75 Mon Sep 17 00:00:00 2001 From: Qiheng He Date: Tue, 10 Nov 2026 14:06:42 +0800 Subject: [PATCH] docs: move the unreleased changes under 0.6.6 and bring the dated claims up to date After the release: - docs/changes.md and its translation: Unreleased becomes 0.6.6 (2026-11-10). - Verified against Foojay on 2026-11-10: platform table, JavaFX table, mirror hosts, checksum table, Intel Mac Java 27, Windows ARM64 list, Temurin 21 newest (21.0.13+9), SDKMAN short names and 31 distributions are unchanged; dates move from 2026-11-03 to 2026-11-10. - Updated quotes that name the newest release of something: Temurin search now starts with 27.0.1, EA newest is 28-ea+23, GraalVM feature releases add 25.5.5.0.3 and graalce newest is 25.5.5.0.3-graalce. --- docs/changes.md | 2 +- docs/development.md | 2 +- docs/distributions.md | 10 +++++----- docs/e2e.md | 4 ++-- docs/foojay.md | 6 +++--- docs/install-from-source.md | 2 +- docs/javafx.md | 2 +- docs/mirror.md | 2 +- docs/platforms.md | 4 ++-- docs/sdkman.md | 4 ++-- docs/versions.md | 13 +++++++------ docs/zh-CN/changes.md | 2 +- docs/zh-CN/development.md | 2 +- docs/zh-CN/distributions.md | 10 +++++----- docs/zh-CN/e2e.md | 4 ++-- docs/zh-CN/foojay.md | 6 +++--- docs/zh-CN/install-from-source.md | 2 +- docs/zh-CN/javafx.md | 2 +- docs/zh-CN/mirror.md | 2 +- docs/zh-CN/platforms.md | 4 ++-- docs/zh-CN/sdkman.md | 4 ++-- docs/zh-CN/versions.md | 13 +++++++------ 22 files changed, 52 insertions(+), 50 deletions(-) diff --git a/docs/changes.md b/docs/changes.md index c8dbc11..77b4f8d 100644 --- a/docs/changes.md +++ b/docs/changes.md @@ -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). diff --git a/docs/development.md b/docs/development.md index 4f9fe89..65d38f0 100644 --- a/docs/development.md +++ b/docs/development.md @@ -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 diff --git a/docs/distributions.md b/docs/distributions.md index 9b5e383..f4a7e95 100644 --- a/docs/distributions.md +++ b/docs/distributions.md @@ -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 | | --- | --- | --- | --- | @@ -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. @@ -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). diff --git a/docs/e2e.md b/docs/e2e.md index 9073c4b..e0d33a7 100644 --- a/docs/e2e.md +++ b/docs/e2e.md @@ -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 @@ -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 ...` 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 diff --git a/docs/foojay.md b/docs/foojay.md index 9a69679..7dc92da 100644 --- a/docs/foojay.md +++ b/docs/foojay.md @@ -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 @@ -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' \ @@ -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 | | --- | --- | diff --git a/docs/install-from-source.md b/docs/install-from-source.md index 7623e92..86ef8b3 100644 --- a/docs/install-from-source.md +++ b/docs/install-from-source.md @@ -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 diff --git a/docs/javafx.md b/docs/javafx.md index 45d5ebb..e6d81d2 100644 --- a/docs/javafx.md +++ b/docs/javafx.md @@ -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 | | --- | --- | --- | --- | --- | --- | --- | --- | diff --git a/docs/mirror.md b/docs/mirror.md index 97355d8..aab5c35 100644 --- a/docs/mirror.md +++ b/docs/mirror.md @@ -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 | | --- | --- | diff --git a/docs/platforms.md b/docs/platforms.md index 281b33c..58321c6 100644 --- a/docs/platforms.md +++ b/docs/platforms.md @@ -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 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | @@ -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. diff --git a/docs/sdkman.md b/docs/sdkman.md index ba0ee7f..9f53511 100644 --- a/docs/sdkman.md +++ b/docs/sdkman.md @@ -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). diff --git a/docs/versions.md b/docs/versions.md index e17904e..5ee1e38 100644 --- a/docs/versions.md +++ b/docs/versions.md @@ -23,11 +23,11 @@ The distribution is a short name (`tem`) or a long name (`temurin`). Both lists `vfox install` asks the plugin which package matches, then vfox downloads and unpacks it. -- A bare major (`21`, `21-tem`) installs the newest release of that major the distribution lists, for example `21.0.13+9-tem` on 2026-11-03. +- A bare major (`21`, `21-tem`) installs the newest release of that major the distribution lists, for example `21.0.13+9-tem` on 2026-11-10. - A longer version must match a release the distribution lists. `21.0.8-tem` installs `21.0.8+9-tem`, the newest build of 21.0.8. A release nobody published fails with `No JDK found for 21.0.99-tem on linux/amd64`. - A build number selects that build: `21.0.5+63130-jb`. - A release padded with zeros, as SDKMAN writes it, is accepted: `27.0.0-librca` installs `27+36-librca`. -- Oracle GraalVM's bare major installs the newest build of its 25.0 line, not one of the monthly feature releases, which have to be named in full (`25.4.4.1.1-graal`). See [GraalVM](distributions.md#graalvm-family). +- Oracle GraalVM's bare major installs the newest build of its 25.0 line, not one of the monthly feature releases, which have to be named in full (`25.5.5.0.3-graal`). See [GraalVM](distributions.md#graalvm-family). - With `-fx` only JavaFX builds are considered, without it only builds without JavaFX. The two are never mixed. - Mandrel and Liberica NIK go by the GraalVM version they carry, for a bare major too: `java@23-mandrel` installs `23.1.12.1-mandrel`, which runs Java 21. See [Mandrel and Liberica NIK](distributions.md#behavior-of-mandrel-and-liberica-nik). - On Windows a release shipped as zip and as tar.gz installs from the zip. @@ -49,7 +49,7 @@ The plugin names an install after the `java_version` that Foojay reports, or the | `25.0.4+9-librca-fx` | Liberica with JavaFX | | `25.0.2+10` | OpenJDK, no suffix | | `17.0.12-graal` | GraalVM, which has no build number | -| `25.4.4.1.1-graal` | GraalVM's version, not `java_version`, for Oracle GraalVM and GraalVM Community, here a monthly feature release, see [GraalVM](distributions.md#behavior-of-oracle-graalvm-and-graalvm-community) | +| `25.5.5.0.3-graal` | GraalVM's version, not `java_version`, for Oracle GraalVM and GraalVM Community, here a monthly feature release, see [GraalVM](distributions.md#behavior-of-oracle-graalvm-and-graalvm-community) | | `8.0.482+8-zulu` | Java 8 is `8.0.+` | | `23.1.12.1-mandrel` | Mandrel, numbered after GraalVM: it runs Java 21 | | `28-ea+19` | early-access build, see below | @@ -76,7 +76,7 @@ vfox uninstall java@21.0.8+9-tem If you name a build or a release, it does not cross over to another one (`21.0.12-tem` does not select `21.0.12.1+1-tem`). It does not cross to another distribution, between JavaFX and plain, or between early-access and GA either. A name that matches nothing is reported as `java@99-tem is not installed`. -With Oracle GraalVM, `vfox use` of a bare major selects the build that installing it installs: `25-graal` selects the newest installed build of the 25.0 line (`25.0.5-graal`), not a monthly feature release such as `25.4.4.1.1-graal`, which it takes only where nothing else of 25 is installed. A feature release is selected by its full version. If `25-graal` itself is installed, the GA release 25 that release 0.6.1 installed, that one is selected, as for any installed name. +With Oracle GraalVM, `vfox use` of a bare major selects the build that installing it installs: `25-graal` selects the newest installed build of the 25.0 line (`25.0.5-graal`), not a monthly feature release such as `25.5.5.0.3-graal`, which it takes only where nothing else of 25 is installed. A feature release is selected by its full version. If `25-graal` itself is installed, the GA release 25 that release 0.6.1 installed, that one is selected, as for any installed name. vfox's own match for `21` goes by the version alone, so it also takes GraalVM CE 8 to 19, Gluon GraalVM, Mandrel and Liberica NIK, whose versions are GraalVM's: `21.3.1-grl11` runs Java 11, and `vfox use java@21` selects it over `21.0.12.1+1-tem`. See [distributions.md](distributions.md#versions-numbered-after-graalvm). @@ -87,7 +87,7 @@ Pick the scope with `vfox use`'s flags: `--global`, `--project` or `--session`, Spell the build as `.ea[.]`: ```bash -vfox install java@28.ea-open # newest early-access build, 28-ea+21 on 2026-11-03 +vfox install java@28.ea-open # newest early-access build, 28-ea+23 on 2026-11-10 vfox install java@28.ea.15-open # 28-ea+15 ``` @@ -106,6 +106,7 @@ Each line is a name that can follow `java@`, newest first, with notes for LTS an ``` $ vfox search java tem Available versions: + - 27.0.1-tem - 27+35-tem - 26.0.2.1+1-tem ... @@ -118,4 +119,4 @@ The list holds what exists for the machine you run it on, see [platforms.md](pla `vfox install java tem` does not select Temurin: arguments separated by spaces are several SDKs. Write `java@21-tem`. -The LTS note is Foojay's, except that GraalVM's monthly feature releases (`25.4.4.1.1-graal`) carry none, though Foojay marks some of them LTS. +The LTS note is Foojay's, except that GraalVM's monthly feature releases (`25.5.5.0.3-graal`) carry none, though Foojay marks some of them LTS. diff --git a/docs/zh-CN/changes.md b/docs/zh-CN/changes.md index 536087e..a1371cc 100644 --- a/docs/zh-CN/changes.md +++ b/docs/zh-CN/changes.md @@ -4,7 +4,7 @@ 按发布版本列出用户能感受到的变化。GitHub 的 Release 页面列出了对应的 PR。 -## 未发布 +## 0.6.6(2026-11-10) - `vfox link --detect java` 会直接采用本机上已有的 JDK,而不用再下载一份:Gradle 的、IntelliJ IDEA 的、系统目录里的,以及 SDKMAN、asdf、mise、jabba、Homebrew、Scoop、CI runner 工具缓存和 `JAVA_HOME` 指向的。需要 vfox 1.1.0 或更高版本。见 [link.md](link.md)。 diff --git a/docs/zh-CN/development.md b/docs/zh-CN/development.md index 7315b24..52a312a 100644 --- a/docs/zh-CN/development.md +++ b/docs/zh-CN/development.md @@ -173,7 +173,7 @@ id 是 Foojay 的(`oracle_open_jdk` 对应 `open`)。这段命令在 Linux a 1. 把 [changes.md](changes.md) 里的这些条目移到新版本下面,写上发布日期,并去掉这些标注,两种语言都要处理:`grep -rn -i -e unreleased -e 未发布 docs README*`。 2. 上一个发布版的版本号也要搜一遍:有几句话是拿它做对比的,没有写“未发布”。 -3. 引用 Foojay 数据的页面会写明数据取自哪一天。把那些写着“某个东西的最新版本”的引用(2026-11-03 的 `21.0.13+9-tem`)更新一遍,并重新对照 Foojay 检查各张表,见[更新平台表](#更新平台表)。 +3. 引用 Foojay 数据的页面会写明数据取自哪一天。把那些写着“某个东西的最新版本”的引用(2026-11-10 的 `21.0.13+9-tem`)更新一遍,并重新对照 Foojay 检查各张表,见[更新平台表](#更新平台表)。 ## 编写文档 diff --git a/docs/zh-CN/distributions.md b/docs/zh-CN/distributions.md index 9a2b6fa..3b2a007 100644 --- a/docs/zh-CN/distributions.md +++ b/docs/zh-CN/distributions.md @@ -2,7 +2,7 @@ [中文](distributions.md) | [English](../distributions.md) -插件从 [Foojay](foojay.md) 获取下面 31 个发行版的版本列表和下载链接,2026-11-03 时 Foojay 列出的发行版全在这里。凡是要写发行版的地方,简称和长名都可以:`21-tem`、`21-temurin`、`temurin-21`、`vfox search java tem`。 +插件从 [Foojay](foojay.md) 获取下面 31 个发行版的版本列表和下载链接,2026-11-10 时 Foojay 列出的发行版全在这里。凡是要写发行版的地方,简称和长名都可以:`21-tem`、`21-temurin`、`temurin-21`、`vfox search java tem`。 | 简称 | 长名 | 发行版 | 维护方 | | --- | --- | --- | --- | @@ -44,7 +44,7 @@ ## 简称与 SDKMAN 的不同 -简称沿用 [SDKMAN](https://sdkman.io/) 的标识符,Temurin 21.0.8 在两边都写作 `21.0.8-tem`。下面是与 SDKMAN 不同的地方,对照的是 2026-11-03 的 SDKMAN 列表: +简称沿用 [SDKMAN](https://sdkman.io/) 的标识符,Temurin 21.0.8 在两边都写作 `21.0.8-tem`。下面是与 SDKMAN 不同的地方,对照的是 2026-11-10 的 SDKMAN 列表: - JetBrains Runtime 叫 `jb`,SDKMAN 里叫 `jbr`;毕昇 JDK 叫 `bsg`,SDKMAN 里叫 `bisheng`,也就是插件给它的长名。`.sdkmanrc` 里写 SDKMAN 的叫法也认,见 [sdkmanrc.md](sdkmanrc.md)。 - Dragonwell、TravaOpenJDK、AdoptOpenJDK、Gluon GraalVM 和按 GraalVM 自身编号的 GraalVM CE,SDKMAN 都已经不再提供。后三个在 SDKMAN 里曾叫 `adpt`、`gln` 和 `grl`,当时把虚拟机或 JDK 版本写进版本号:HotSpot 版是 `11.0.10.hs-adpt`,OpenJ9 版是 `11.0.10.j9-adpt`,基于 JDK 17 的是 `22.3.3.r17-grl`。插件给 Foojay 的每个发行版各起一个名字,所以这部分挪进了简称:`11.0.10-adpt`、`11.0.10-adptj9`、`22.3.3-grl17`。`.sdkmanrc` 里用 SDKMAN 的旧写法也能选中它们。 @@ -154,11 +154,11 @@ GraalVM 的开源版本,基于 OpenJDK。 ### Oracle GraalVM 与 GraalVM 社区版的行为 -- 从 25.1(2026 年 6 月)起,GraalVM 在 25.0 系列之外每月发布一个特性版本(feature release):`25.1.3`、`25.2.4`、`25.3.4.1`、`25.4.4.1.1`,每个大约一个月后就被下一个取代。Foojay 把 Oracle GraalVM 的特性版本标成 STS;GraalVM 社区版按老办法列的那些(见下文),则因为基于的 JDK 是 LTS,也被标成了 LTS。`vfox search` 一律不给它们加 LTS 备注。 +- 从 25.1(2026 年 6 月)起,GraalVM 在 25.0 系列之外每月发布一个特性版本(feature release):`25.1.3`、`25.2.4`、`25.3.4.1`、`25.4.4.1.1`、`25.5.5.0.3`,每个大约一个月后就被下一个取代。Foojay 把 Oracle GraalVM 的特性版本标成 STS;GraalVM 社区版按老办法列的那些(见下文),则因为基于的 JDK 是 LTS,也被标成了 LTS。`vfox search` 一律不给它们加 LTS 备注。 - 版本名用的是 GraalVM 自己的版本号,也就是 Foojay 的 `distribution_version`。Foojay 的 `java_version` 是 JDK 的版本号,特性版本会和 25.0 系列的某个构建共用同一个值:`25.4.4.1.1-graal`、`25.3.4.1-graal`、`25.0.4.1.1-graal` 和 `25.0.4.1-graal` 的 `java_version` 都是 25.0.4.1。 - GraalVM 社区版的特性版本,Foojay 还像 2026 年 10 月以前那样,按 GraalVM 的版本号另列了一份,下载地址在 GitHub。所以 0.6.2 给 25.4.4.1.1 构建起的名字 `java@25.4.4.1-graalce` 仍然能从 GitHub 装上这个构建,而 `java@25.4.4.1.1-graalce` 是从 Oracle 的 GraalVM Download Service 下载同一个文件。 -- `java@25-graal` 装的是 25.0 系列的最新构建(2026-11-03 是 `25.0.5.0.3-graal`),Oracle 官方的 `25/latest` 下载链接跟的也是这个系列。特性版本要写全版本号:`java@25.4.4.1.1-graal`。`vfox use java@25-graal` 和 `.sdkmanrc` 里的 `java=25-graal` 选中的也是这个系列里已安装的最新构建,只有 25 里没有装别的版本时才会选特性版本。 -- GraalVM 社区版的 25.0 系列到 `25.0.2` 为止,现在只发布特性版本。`java@25-graalce` 装其中最新的一个,截至 2026-11-03 是 `25.4.4.1.1-graalce`。 +- `java@25-graal` 装的是 25.0 系列的最新构建(2026-11-10 是 `25.0.5.0.3-graal`),Oracle 官方的 `25/latest` 下载链接跟的也是这个系列。特性版本要写全版本号:`java@25.5.5.0.3-graal`。`vfox use java@25-graal` 和 `.sdkmanrc` 里的 `java=25-graal` 选中的也是这个系列里已安装的最新构建,只有 25 里没有装别的版本时才会选特性版本。 +- GraalVM 社区版的 25.0 系列到 `25.0.2` 为止,现在只发布特性版本。`java@25-graalce` 装其中最新的一个,截至 2026-11-10 是 `25.5.5.0.3-graalce`。 - 插件只设置 `JAVA_HOME` 和 `PATH`,不设置 `GRAALVM_HOME`。你设置的、指向自己的 GraalVM 的 `GRAALVM_HOME` 保持原样;没有设置时,native-image 的构建插件会回退到 `JAVA_HOME`。 - 没有 Windows ARM64 和 Alpine 的构建,Intel Mac 上 25.0.1 之后的版本也没有。见 [platforms.md](platforms.md#graalvm)。 diff --git a/docs/zh-CN/e2e.md b/docs/zh-CN/e2e.md index 960948b..7c33335 100644 --- a/docs/zh-CN/e2e.md +++ b/docs/zh-CN/e2e.md @@ -183,7 +183,7 @@ docker run --rm -v "$PWD:/src" ghcr.io/google/addlicense:v1.2.0 -f .license.tpl 2. 只写发行版不写版本,无论单独写还是跟在空版本后面(`java@tem`、`java@-tem`),`vfox install` 和 `vfox use` 都应失败,并提示补上版本。以前,`java@tem` 会让钩子报 Lua 错误;`java@-tem` 则让 `PreInstall` 把空版本发给 Foojay,Foojay 列出所有版本,结果装上了最新的。没有任何发行版发布过的版本(`<大版本>.0.99`)应该安装失败,并且 `PreInstall` 要指出它搜索的平台(`linux/amd64`、`windows/arm64` 等),以此确认向 Foojay 查询的就是 runner 所在的平台。已固定版本里从未发布过的构建(`<版本>+99`,例如 `21.0.8+99-tem`)也一样,这证明查询保留了构建号:Foojay 会把没编码的 `+` 当成空格并丢掉构建号,于是会装上这个版本的最新构建。 在 `tem` 这几行里,经过一个不存在的镜像安装也必须失败。设成 `VFOX_JAVA_GITHUB_MIRROR=https://invalid.example.invalid` 后,镜像会加在 Temurin 的 GitHub 地址前面,所以 `vfox install` 在下载时失败,错误信息里必须出现 vfox 请求的那个地址:镜像、一个斜杠,再加 GitHub 地址。以前插件不读这个变量,会从 github.com 下载 JDK,安装成功。这一步不下载任何东西,也不运行能正常工作的镜像。 -3. 在 `graalce` 这一行里,Oracle GraalVM 只写大版本号的 `25-graal` 应该装 25.0 系列的最新构建(2026-11-03 是 `25.0.5.0.3-graal`),也就是 Oracle 官方 `25/latest` 下载跟的那个系列,而不是列在它前面的某个每月特性版本(比如 `25.4.4.1.1-graal`)。`vfox search java graal` 必须按 GraalVM 自己的版本号列出这些特性版本,25 的其他版本备注要一致,同第 5 条。从 2026 年 10 月起,Foojay 给特性版本标的是 JDK 的版本号,和 25.0 系列共用。插件以前按这个版本号命名,结果搜索里一个特性版本都没有,`25.0.4.1-graal` 也没有 LTS 备注,装上的却是 25.4.4.1.1。搜索列出的 25 的各构建会先被模拟成已安装,这样 `vfox install` 报出的就是 `PreInstall` 选中的那个,而且不会下载任何东西。GA 版本 25 不放进去,因为那样 vfox 会发现 `25-graal` 已安装,根本不会去问 `PreInstall`。在 Linux 上,安装向 Foojay 发的请求还必须和搜索的相同,同第 4 条末尾。 +3. 在 `graalce` 这一行里,Oracle GraalVM 只写大版本号的 `25-graal` 应该装 25.0 系列的最新构建(2026-11-10 是 `25.0.5.0.3-graal`),也就是 Oracle 官方 `25/latest` 下载跟的那个系列,而不是列在它前面的某个每月特性版本(比如 `25.4.4.1.1-graal`)。`vfox search java graal` 必须按 GraalVM 自己的版本号列出这些特性版本,25 的其他版本备注要一致,同第 5 条。从 2026 年 10 月起,Foojay 给特性版本标的是 JDK 的版本号,和 25.0 系列共用。插件以前按这个版本号命名,结果搜索里一个特性版本都没有,`25.0.4.1-graal` 也没有 LTS 备注,装上的却是 25.4.4.1.1。搜索列出的 25 的各构建会先被模拟成已安装,这样 `vfox install` 报出的就是 `PreInstall` 选中的那个,而且不会下载任何东西。GA 版本 25 不放进去,因为那样 vfox 会发现 `25-graal` 已安装,根本不会去问 `PreInstall`。在 Linux 上,安装向 Foojay 发的请求还必须和搜索的相同,同第 4 条末尾。 装着这些构建时,`vfox use java@25-graal` 和写着 `java=25-graal` 的 `.sdkmanrc` 必须选中 `vfox install` 报出的那个构建。`PreUse` 和 `ParseLegacyFile` 以前选的是 25 里已安装的最新版本,所以一旦装了特性版本,选中的就是它([#110](https://github.com/version-fox/vfox-java/issues/110))。模拟出的每个构建里都放着一个只打印名字的替身 `java`,同第 6 条。对模拟出的每个有五位版本号的构建,写着 SDKMAN 给它的标识符的 `.sdkmanrc`(`25.0.5.0.3-graal` 对应 `25.0.5.0+3-graal`,`25.4.4.1.1-graal` 对应 `25.4.4.1+1-graal`;见 `tests/e2e/common` 里的 `GraalVMIdentifiers`)必须选中这个构建,而不是它旁边的 `25.0.5-graal` 或更新的版本。`ParseLegacyFile` 以前把 `+` 后面的数字当作这个版本的构建号([#124](https://github.com/version-fox/vfox-java/pull/124))。把 25.0 系列的构建删掉之后,`vfox use` 和 `.sdkmanrc` 都必须选中最新的特性版本。 4. 在 `tem` 这几行里(这几行在每个 runner 上都会运行),只按名字检查的发行版(`adpt` 到 `semcrt`,即 `tests/e2e/common` 里的 `nameOnly`),只要 Foojay 在这个 runner 上有它的包,都要能用简称找到:`vfox search java <简称>` 能列出它;把它列出的最新版本模拟成已安装后,`vfox install java@<大版本>-<简称>`(`22-grl17`)要报告这个版本已经安装,所以不会下载任何东西。以前没有这些简称时,这两条命令分别报 `Unsupported distribution` 和 `Could not extract a valid distribution`。 @@ -193,7 +193,7 @@ docker run --rm -v "$PWD:/src" ghcr.io/google/addlicense:v1.2.0 -f .license.tpl 在 Linux 上,这几行和第 3 条的 `graalce` 行经由一个冒充 api.foojay.io 的替身访问 Foojay(由 `tests/e2e/linux/front` 构建),替身记下插件发出的每个请求。上面每次安装发的请求都必须和它前面那次搜索的相同(`tests/e2e/common` 里的 `AsksAsSearch`)。Foojay 的结果按请求分别缓存,新版本发布后的半小时里,换一个请求就可能装上搜索还没列出的构建,于是真的下载,检查失败(见 [foojay.md](foojay.md#插件发出的请求))。[#113](https://github.com/version-fox/vfox-java/issues/113) 之前,只写大版本号时查的是 `latest=available`,Mandrel 和 Liberica NIK 则按 `distribution_version` 查。 5. 固定的版本按 `PreInstall` 给它起的名字安装:请求的版本加上构建号(`21.0.8-tem` 安装为 `21.0.8+9-tem`)。`vfox search java <发行版>`(`Available` 钩子)把同一个名字列为已安装,带 JavaFX 的构建会标注 JavaFX。对 GraalVM,它还必须列出自 25.1 起每月发布的特性版本(`25.4.4.1.1-graalce`),这些版本都不标 LTS(Foojay 给其中一些标了,因为它们基于的 JDK 是 LTS);每个版本大约只存在一个月。同一个大版本里的其他版本,备注必须一致。插件以前把特性版本 25.4.4.1.1 列成 `25.0.4.1-graalce`,没有 `25.0.2-graalce` 那样的 LTS 备注。在 Windows 上,列表里要包含 JetBrains Runtime 21.0.5,它在 Windows 上只有 tar.gz。 - 安装本身还必须校验了下载的文件。每个默认发行版固定的版本,Foojay 在每个 runner 上都给出了校验和(2026-11-03),`vfox install` 必须打印 `Verifying checksum <摘要>...`,摘要的长度是 vfox 支持的,并且不能出现 `WARNING: Checksum is not provided, skip verify...`——在插件把 Foojay 的校验和交给 vfox 之前,每次安装最后都有这条警告。摘要有四种形式,所以插件读取它们的每种方式都会跑到:Foojay 记录里的 SHA-256 和 SHA-1(Temurin、Liberica),只有摘要的文件里的 SHA-256(OpenJDK、GraalVM 社区版),以及带着文件名的文件里的 SHA-512(JetBrains)。vfox 把摘要和下载文件的哈希值比较,对不上就让安装失败,所以安装成功就证明摘要确实是这个文件的。用 `JAVA_VERSION` 指定的版本不检查这一项,因为 Foojay 可能没有它的校验和。 + 安装本身还必须校验了下载的文件。每个默认发行版固定的版本,Foojay 在每个 runner 上都给出了校验和(2026-11-10),`vfox install` 必须打印 `Verifying checksum <摘要>...`,摘要的长度是 vfox 支持的,并且不能出现 `WARNING: Checksum is not provided, skip verify...`——在插件把 Foojay 的校验和交给 vfox 之前,每次安装最后都有这条警告。摘要有四种形式,所以插件读取它们的每种方式都会跑到:Foojay 记录里的 SHA-256 和 SHA-1(Temurin、Liberica),只有摘要的文件里的 SHA-256(OpenJDK、GraalVM 社区版),以及带着文件名的文件里的 SHA-512(JetBrains)。vfox 把摘要和下载文件的哈希值比较,对不上就让安装失败,所以安装成功就证明摘要确实是这个文件的。用 `JAVA_VERSION` 指定的版本不检查这一项,因为 Foojay 可能没有它的校验和。 6. 在执行任何 `vfox use` 之前,`.sdkmanrc` 要能通过 `ParseLegacyFile` 选中 JDK。测试时,`vfox list java` 里排在最前面的是另一个版本的空安装(`21.0.80+1-tem`,它的版本号以固定的版本开头;vfox 按字符串降序给已安装版本排序)。以前 `ParseLegacyFile` 会把它当成第一个以该版本开头的版本,对补零的版本(见下面第二条),则当成该大版本里最新的版本。要覆盖的写法有: - 不含构建号的 SDKMAN 标识符:`java=21.0.8-tem`、`java=21.0.5-jbr`(SDKMAN 对 JetBrains 的叫法)、`java=25.0.4.fx-librca`(它对 JavaFX 构建的写法)。 - 补零的标识符,`sdk list java` 里有很多这样的:`java=21.0.8.0+9-tem`、`java=25.0.4.0-fx+9-librca`(Foojay 以及安装后的版本名里没有这个零)。 diff --git a/docs/zh-CN/foojay.md b/docs/zh-CN/foojay.md index 48ffb71..d042a8b 100644 --- a/docs/zh-CN/foojay.md +++ b/docs/zh-CN/foojay.md @@ -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 ``` -2026-11-03 运行这条命令,打印的是 `corretto liberica oracle semeru zulu`。Temurin 和 OpenJDK 不在其中:它们在 Intel Mac 上停在了 26。只写大版本号时像插件一样加上 `latest=available`,写更具体的版本时就不要加。 +2026-11-10 运行这条命令,打印的是 `corretto liberica oracle semeru zulu`。Temurin 和 OpenJDK 不在其中:它们在 Intel Mac 上停在了 26。只写大版本号时像插件一样加上 `latest=available`,写更具体的版本时就不要加。 ## 某个发行版的所有版本 @@ -153,7 +153,7 @@ curl -s 'https://api.foojay.io/disco/v3.0/packages/jdks?distribution=mandrel&dis ## 校验和 -`links.pkg_info_uri` 指向的那条记录还说明了怎么校验下载的文件。`checksum_type` 是算法,摘要要么就在记录里(`checksum`),要么在厂商的一个文件里,由 `checksum_uri` 指向。GraalVM 社区版 25.0.2 只有这个文件(2026-11-03): +`links.pkg_info_uri` 指向的那条记录还说明了怎么校验下载的文件。`checksum_type` 是算法,摘要要么就在记录里(`checksum`),要么在厂商的一个文件里,由 `checksum_uri` 指向。GraalVM 社区版 25.0.2 只有这个文件(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' \ @@ -176,7 +176,7 @@ Temurin 的记录里直接带着摘要(Linux x64 上的 21.0.8 是 `f2dc5418.. 文件里列了好几个包时,取正在安装的那个包的那一行。只列了别的包的文件不给出摘要:Microsoft 为 macOS 上 11.0.14 的 EA 构建发布的文件,里面写的是 GA 构建,那个摘要会让本来没问题的安装失败。 -哪些包带校验和因版本而异,有些发行版 Foojay 根本没有。各发行版最新的版本(2026-11-03): +哪些包带校验和因版本而异,有些发行版 Foojay 根本没有。各发行版最新的版本(2026-11-10): | Foojay 给出的 | 简称 | | --- | --- | diff --git a/docs/zh-CN/install-from-source.md b/docs/zh-CN/install-from-source.md index 64d3908..6d6dfba 100644 --- a/docs/zh-CN/install-from-source.md +++ b/docs/zh-CN/install-from-source.md @@ -40,7 +40,7 @@ vfox use --global java@21-tem java -version ``` -`vfox install java@21-tem` 装的是最新的 Temurin 21,截至 2026-11-03 是 `21.0.13+9-tem`。 +`vfox install java@21-tem` 装的是最新的 Temurin 21,截至 2026-11-10 是 `21.0.13+9-tem`。 ## 已经添加过 java 时 diff --git a/docs/zh-CN/javafx.md b/docs/zh-CN/javafx.md index 3f0f7f1..6c0ed9f 100644 --- a/docs/zh-CN/javafx.md +++ b/docs/zh-CN/javafx.md @@ -33,7 +33,7 @@ java --list-modules | grep javafx ## 哪些平台有 JavaFX 构建 -截至 2026-11-03,提供 JavaFX 构建的发行版有四个,而且并非每个平台都有。下表列出有 JavaFX 构建的 LTS 版本,中间的非 LTS 版本也有一些,但有缺口。Liberica NIK 一行写的是 Java 版本,不是它名字里的 GraalVM 版本号(见 [distributions.md](distributions.md#mandrel-与-liberica-nik-的行为)):它为 Java 21 提供的 JavaFX 构建是 `23.1.x-nik-fx`。 +截至 2026-11-10,提供 JavaFX 构建的发行版有四个,而且并非每个平台都有。下表列出有 JavaFX 构建的 LTS 版本,中间的非 LTS 版本也有一些,但有缺口。Liberica NIK 一行写的是 Java 版本,不是它名字里的 GraalVM 版本号(见 [distributions.md](distributions.md#mandrel-与-liberica-nik-的行为)):它为 Java 21 提供的 JavaFX 构建是 `23.1.x-nik-fx`。 | 发行版 | Linux x64 | Linux arm64 | Alpine x64 | macOS Intel | macOS Apple Silicon | Windows x64 | Windows arm64 | | --- | --- | --- | --- | --- | --- | --- | --- | diff --git a/docs/zh-CN/mirror.md b/docs/zh-CN/mirror.md index 19b6bb0..a8a38ac 100644 --- a/docs/zh-CN/mirror.md +++ b/docs/zh-CN/mirror.md @@ -39,7 +39,7 @@ $env:VFOX_JAVA_GITHUB_MIRROR = "https://gh-proxy.org/" 只有以 `https://github.com/` 开头的请求:下载,以及插件为这些下载去读的 GitHub 上的校验和文件(见[补充说明](#补充说明))。其他主机上的 JDK 照旧从那里下载,向 Foojay 发的请求也不变。 -Foojay 给各发行版的链接(2026-11-03): +Foojay 给各发行版的链接(2026-11-10): | 简称 | 下载来源 | | --- | --- | diff --git a/docs/zh-CN/platforms.md b/docs/zh-CN/platforms.md index f3e3577..e8a1986 100644 --- a/docs/zh-CN/platforms.md +++ b/docs/zh-CN/platforms.md @@ -8,7 +8,7 @@ No JDK found for 21-bsg on darwin/arm64. Please check available versions with 'vfox search java' ``` -下表列出各发行版有哪些平台的包,数据取自 2026-11-03 的 Foojay。✅ 表示 Foojay 在这个平台上至少列有一个插件能安装的包,❌ 表示一个也没有。 +下表列出各发行版有哪些平台的包,数据取自 2026-11-10 的 Foojay。✅ 表示 Foojay 在这个平台上至少列有一个插件能安装的包,❌ 表示一个也没有。 | 发行版 | Linux x64 | Linux arm64 | Alpine x64 | Alpine arm64 | macOS Intel | macOS Apple Silicon | Windows x64 | Windows arm64 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | @@ -50,7 +50,7 @@ Foojay 的数据会变,这张表也会过时。想看当前的情况,按 [fo ## 只有部分版本 -标了 ✅ 也不代表所有版本都有。以下截至 2026-11-03: +标了 ✅ 也不代表所有版本都有。以下截至 2026-11-10: - Windows ARM64 上,没有任何发行版提供 Java 8。Temurin 有 21 和 23,Zulu 有 16 到 19、21、25 和 27,Liberica 有 11 和 16 到 27,Microsoft 有 11、16、17、21 和 25,JetBrains Runtime 有 17、21 和 25。 - Apple Silicon 上,Java 8 来自 Zulu、Liberica、Corretto 和 Kona。Temurin 和 Semeru 在那里有 11 和 17 到 27,OpenJDK 有 17 到 27。Mandrel 有 23.1 到 25 的版本,运行 Java 21 到 25;Liberica NIK 有 22.2 到 25 的版本,运行 Java 11、17 和 20 到 25(见[它们的版本号](distributions.md#mandrel-与-liberica-nik-的行为))。Gluon GraalVM 有 22.1.0.1 和 23+25,GraalVM CE 11 和 17 有 GraalVM 22.1 到 22.3.1,GraalVM CE 19 有 22.3 和 22.3.1。 diff --git a/docs/zh-CN/sdkman.md b/docs/zh-CN/sdkman.md index e505976..7f99794 100644 --- a/docs/zh-CN/sdkman.md +++ b/docs/zh-CN/sdkman.md @@ -39,8 +39,8 @@ ## 差别 - **标识符。** SDKMAN 的 `21.0.8-tem` 原样写在 `java@` 后面,简称也沿用 SDKMAN 的,只有少数例外,比如 JetBrains Runtime 在 SDKMAN 里叫 `jbr`,这里是 `jb`,见 [distributions.md](distributions.md#简称与-sdkman-的不同)。SDKMAN 现在的标识符会给版本补一个零(`25.0.5.0+8-tem`),这样的写法也能识别。JavaFX 是放在最后的 `-fx`,即 `21.0.12-zulu-fx`。SDKMAN 的 `21.0.12.fx-zulu` 不是 `vfox install` 接受的写法,不过 `.sdkmanrc` 里可以写,见 [sdkmanrc.md](sdkmanrc.md#sdkman-的写法)。 -- **只写大版本号。** `vfox install java@21-tem` 装的是最新的 Temurin 21,2026-11-03 是 `21.0.13+9-tem`。SDKMAN 的 `21-tem` 只是一个版本,即 GA 构建 `21+35`。 -- **没有默认 JDK。** `sdk install java` 装的是 SDKMAN 的默认版本,一个 Temurin 的 LTS 版本(2026-11-03 是 `25.0.5.0+8-tem`)。`vfox install java` 没有默认值:在终端里它会让你选一个版本,在脚本里则直接失败。只写版本不写发行版(`java@21`)指的是 jdk.java.net 上的 OpenJDK,它的 21 只到 21.0.2。请写 `java@21-tem`,见 [versions.md](versions.md#不写发行版)。 +- **只写大版本号。** `vfox install java@21-tem` 装的是最新的 Temurin 21,2026-11-10 是 `21.0.13+9-tem`。SDKMAN 的 `21-tem` 只是一个版本,即 GA 构建 `21+35`。 +- **没有默认 JDK。** `sdk install java` 装的是 SDKMAN 的默认版本,一个 Temurin 的 LTS 版本(2026-11-10 是 `25.0.5.0+8-tem`)。`vfox install java` 没有默认值:在终端里它会让你选一个版本,在脚本里则直接失败。只写版本不写发行版(`java@21`)指的是 jdk.java.net 上的 OpenJDK,它的 21 只到 21.0.2。请写 `java@21-tem`,见 [versions.md](versions.md#不写发行版)。 - **安装不等于选中。** `sdk install` 之后,SDKMAN 会问要不要把这个 JDK 设为默认。`vfox install` 只负责安装,选中要用 `vfox use`。 - **两份列表。** `sdk list java` 列出所有厂商的 JDK。`vfox search java` 只列 OpenJDK,所以要写上发行版(`vfox search java tem`)或 `all`。已安装的看 `vfox list java`。版本数据来自 [Foojay](foojay.md)。 - **安装后的版本名带构建号。** `vfox list java` 显示 `21.0.8+9-tem`,`vfox uninstall` 和 `vfox info` 都要写全,而 `vfox use java@21.0.8-tem` 不写构建号也能找到它,见 [versions.md](versions.md#安装后的版本名)。 diff --git a/docs/zh-CN/versions.md b/docs/zh-CN/versions.md index 0843a7b..43bb5fe 100644 --- a/docs/zh-CN/versions.md +++ b/docs/zh-CN/versions.md @@ -23,11 +23,11 @@ vfox install java@21 # 不写发行版:jdk.java.net 上的 Open `vfox install` 先问插件该装哪个包,再由 vfox 下载并解压。 -- 只写大版本号(`21`、`21-tem`)时,安装这个发行版列出的、这个大版本下最新的版本,例如截至 2026-11-03 是 `21.0.13+9-tem`。 +- 只写大版本号(`21`、`21-tem`)时,安装这个发行版列出的、这个大版本下最新的版本,例如截至 2026-11-10 是 `21.0.13+9-tem`。 - 写得更具体时,必须是这个发行版列出的版本。`21.0.8-tem` 装的是 21.0.8 的最新构建 `21.0.8+9-tem`。根本不存在的版本会失败,报 `No JDK found for 21.0.99-tem on linux/amd64`。 - 写了构建号就装那个构建:`21.0.5+63130-jb`。 - SDKMAN 写法里补了零的版本也能识别:`27.0.0-librca` 装的是 `27+36-librca`。 -- Oracle GraalVM 只写大版本号时,装 25.0 系列的最新构建,不装每月发布的特性版本(feature release)。特性版本要写全版本号(`25.4.4.1.1-graal`)。见 [GraalVM](distributions.md#graalvm-系列)。 +- Oracle GraalVM 只写大版本号时,装 25.0 系列的最新构建,不装每月发布的特性版本(feature release)。特性版本要写全版本号(`25.5.5.0.3-graal`)。见 [GraalVM](distributions.md#graalvm-系列)。 - 写了 `-fx` 就只考虑带 JavaFX 的构建,没写就只考虑不带的,两者不会混用。 - Mandrel 和 Liberica NIK 按它们沿用的 GraalVM 版本号来,只写大版本号时也一样:`java@23-mandrel` 装的是 `23.1.12.1-mandrel`,运行的是 Java 21。见 [Mandrel 与 Liberica NIK](distributions.md#mandrel-与-liberica-nik-的行为)。 - 在 Windows 上,同一版本既有 zip 又有 tar.gz 时,装 zip。 @@ -49,7 +49,7 @@ vfox install java@21 # 不写发行版:jdk.java.net 上的 Open | `25.0.4+9-librca-fx` | 带 JavaFX 的 Liberica | | `25.0.2+10` | OpenJDK,没有后缀 | | `17.0.12-graal` | GraalVM,没有构建号 | -| `25.4.4.1.1-graal` | Oracle GraalVM 和 GraalVM 社区版用的是 GraalVM 自己的版本号,不是 `java_version`,这里是一个每月发布的特性版本,见 [GraalVM](distributions.md#oracle-graalvm-与-graalvm-社区版的行为) | +| `25.5.5.0.3-graal` | Oracle GraalVM 和 GraalVM 社区版用的是 GraalVM 自己的版本号,不是 `java_version`,这里是一个每月发布的特性版本,见 [GraalVM](distributions.md#oracle-graalvm-与-graalvm-社区版的行为) | | `8.0.482+8-zulu` | Java 8 写成 `8.0.<更新号>+<构建号>` | | `23.1.12.1-mandrel` | Mandrel,按 GraalVM 编号,运行的是 Java 21 | | `28-ea+19` | EA 构建,见下文 | @@ -76,7 +76,7 @@ vfox uninstall java@21.0.8+9-tem 写明了构建或版本时,不会跳到别的构建或版本(`21.0.12-tem` 不会选中 `21.0.12.1+1-tem`)。也不会跨发行版,不会在带 JavaFX 和不带 JavaFX 的构建之间串用,不会在 EA 和 GA 之间串用。什么都匹配不上时,报 `java@99-tem is not installed`。 -Oracle GraalVM 只写大版本号时,`vfox use` 选的和 `vfox install` 装的是同一个构建:`vfox use java@25-graal` 选中 25.0 系列里已安装的最新构建(`25.0.5-graal`),而不是每月发布的特性版本(比如 `25.4.4.1.1-graal`);只有 25 里没有装别的版本时,才会选特性版本。特性版本要写全版本号。如果 `25-graal` 本身已经安装(0.6.1 装的 GA 版本 25),选中的就是它,和任何已安装的版本名一样。 +Oracle GraalVM 只写大版本号时,`vfox use` 选的和 `vfox install` 装的是同一个构建:`vfox use java@25-graal` 选中 25.0 系列里已安装的最新构建(`25.0.5-graal`),而不是每月发布的特性版本(比如 `25.5.5.0.3-graal`);只有 25 里没有装别的版本时,才会选特性版本。特性版本要写全版本号。如果 `25-graal` 本身已经安装(0.6.1 装的 GA 版本 25),选中的就是它,和任何已安装的版本名一样。 vfox 自己匹配 `21` 时只看版本号,所以 GraalVM CE 8 到 19、Gluon GraalVM、Mandrel 和 Liberica NIK 也会被它选中,它们的版本号是 GraalVM 的:`21.3.1-grl11` 运行的是 Java 11,`vfox use java@21` 却会选中它,而不是 `21.0.12.1+1-tem`。见 [distributions.md](distributions.md#按-graalvm-编号的版本)。 @@ -87,7 +87,7 @@ vfox 自己匹配 `21` 时只看版本号,所以 GraalVM CE 8 到 19、Gluon G 写成 `<大版本>.ea[.<构建号>]`: ```bash -vfox install java@28.ea-open # 最新的 EA 构建,截至 2026-11-03 是 28-ea+21 +vfox install java@28.ea-open # 最新的 EA 构建,截至 2026-11-10 是 28-ea+23 vfox install java@28.ea.15-open # 28-ea+15 ``` @@ -106,6 +106,7 @@ vfox search java all # 所有发行版,在 Linux x64 上约 2600 行 ``` $ vfox search java tem Available versions: + - 27.0.1-tem - 27+35-tem - 26.0.2.1+1-tem ... @@ -118,4 +119,4 @@ Available versions: `vfox install java tem` 选的不是 Temurin:用空格分隔的参数表示多个 SDK。请写 `java@21-tem`。 -LTS 备注来自 Foojay,唯独 GraalVM 每月发布的特性版本(`25.4.4.1.1-graal`)不带这个备注,尽管 Foojay 把其中一些标成了 LTS。 +LTS 备注来自 Foojay,唯独 GraalVM 每月发布的特性版本(`25.5.5.0.3-graal`)不带这个备注,尽管 Foojay 把其中一些标成了 LTS。