vfox-java

中文 | English

Java plugin for vfox

Support for multiple JDK distributions, such as: Oracle, Graalvm, Eclipse & more.

Usage

Parameter Format: x.y.z-distribution or x.y.z-distribution-fx (for JavaFX bundled versions)

# add plugin for vfox
vfox add java

# install specific version (openjdk is default)
vfox install java@17.0.17
vfox install java@17.0.17-tem      # Temurin
vfox install java@17.0.17-zulu     # Zulu
vfox install java@17-graal         # GraalVM (latest 17.x)

# install JavaFX bundled versions (use -fx suffix after distribution)
vfox install java@21.0.5-zulu-fx   # Zulu with JavaFX
vfox install java@21.0.5-librca-fx # Liberica with JavaFX

# view all available versions
vfox search java           # view all openjdk versions
vfox search java tem       # view all temurin versions
vfox search java zulu      # view all zulu versions
vfox search java graal     # view all graalvm versions

Select and install a distribution

In an interactive terminal, run vfox search java tem to select and install a version from the Temurin list. In a non-interactive terminal, this command only prints the versions. Replace tem with another distribution identifier, such as zulu, as needed.

For a known version, use vfox install java@17.0.17-tem. Space-separated arguments to install identify multiple SDKs, so vfox install java tem does not pass tem as a Java distribution filter.

LoongArch (Linux)

On Linux loong64, vfox search java (or vfox search java loongnix) lists JDKs from the Loongnix official archive. Other architectures continue to use Foojay.

Choose the ABI matching your operating system; the plugin does not guess it:

• lnxabi1 / loongnix_abi1: Linux 4.19 UAPI builds, intended for systems such as Loongnix 20 and Loongnix Server 8.4.
• lnxabi2 / loongnix_abi2: Linux 5.10 UAPI builds, named glibc2.34 upstream, intended for systems such as Debian 12 and openEuler.

See the upstream compatibility notes for your system. Do not choose solely from the running kernel version. This source provides glibc builds, not musl builds.

vfox search java lnxabi2
vfox install java@21-lnxabi2-fx  # latest matching Java 21 with JavaFX, ABI2
vfox install java@21.0.12+8-lnxabi2-fx

Versions use the Java version and build number, not the Loongson release number. ABI and JavaFX suffixes are preserved when switching versions. Only GA LoongArch tarballs listed in the archive are supported; MIPS packages are excluded. Select -fx only for JavaFX builds. Bare installation requests require an explicit ABI; selecting a search result supplies it automatically.

JavaFX Support

Some distributions provide JDK versions bundled with JavaFX. These versions are displayed with the -fx suffix after the distribution name in the version list and marked with "JavaFX" in the notes. To install a JavaFX bundled version, add -fx after the distribution name:

# List versions (JavaFX versions will show -fx suffix)
vfox search java zulu
# Example output:
# 21.0.5-zulu
# 21.0.5-zulu-fx    # JavaFX
# 17.0.13-zulu
# 17.0.13-zulu-fx   # JavaFX

# Install JavaFX bundled version
vfox install java@21.0.5-zulu-fx

Supported JDK Distributions

Thanks SDKMAN!

Bisheng (Huawei)

BiSheng JDK, an open-source adaptation of Huawei JDK derived from OpenJDK, is utilized across 500+ Huawei products, benefitting from the R&D team's extensive experience in addressing service-related challenges. As a downstream product of OpenJDK, it serves as a high-performance distribution for production environments, specifically addressing performance and stability issues in Huawei applications. BiSheng JDK excels in optimizing ARM architecture performance and stability, delivering enhanced results in big data scenarios. Its primary goal is to offer Java developers a stable, high-performance JDK, particularly excelling on the ARM architecture.

$ vfox install java@x.y.z-bsg
$ vfox search java bsg

Corretto (Amazon)

Amazon Corretto is a no-cost, multiplatform, production-ready distribution of the Open Java Development Kit (OpenJDK). Corretto comes with long-term support that will include performance enhancements and security fixes. Amazon runs Corretto internally on thousands of production services and Corretto is certified as compatible with the Java SE standard. With Corretto, you can develop and run Java applications on popular operating systems, including Linux, Windows, and macOS.

$ vfox install java@x.y.z-amzn
$ vfox search java amzn

Dragonwell (Alibaba)

Dragonwell, as a downstream version of OpenJDK, is the in-house OpenJDK implementation at Alibaba. It is optimized for online e-commerce, financial and logistics applications running on 100,000+ servers. Alibaba Dragonwell is the engine that runs these distributed Java applications in extreme scaling.

$ vfox install java@x.y.z-albba
$ vfox search java albba

GraalVM (Oracle)

Oracle GraalVM is the free GraalVM distribution from Oracle, based on Oracle JDK, and includes the high-performance Graal JIT compiler. GraalVM can compile Java applications ahead of time into standalone binaries that start instantly, scale fast, and use fewer compute resources. Oracle GraalVM Native Image provides advanced features including G1 GC, SBOM, as well as performance and size optimizations. It also makes it possible to embed Python, JavaScript, Ruby, and other languages into Java applications.

$ vfox install java@x.y.z-graal
$ vfox search java graal

GraalVM (GraalVM Community)

GraalVM CE is the open source distribution of GraalVM, based on OpenJDK, and includes the high-performance Graal JIT compiler. GraalVM can compile Java applications ahead of time into standalone binaries that start instantly, scale fast, and use fewer compute resources. It also makes it possible to embed Python, JavaScript, Ruby, and other languages into Java applications.

$ vfox install java@x.y.z-graalce
$ vfox search java graalce

Java SE Development Kit (Oracle)

This proprietary Java Development Kit is an implementation of the Java Platform, Standard Edition released by Oracle Corporation in the form of a binary product aimed at Java developers on Linux, macOS or Windows. The JDK includes a private JVM and a few other resources to finish the development of a Java application. It is distributed under the Oracle No-Fee Terms and Conditions License

$ vfox install java@x.y.z-oracle
$ vfox search java oracle

Kona (Tencent)

Tencent Kona is a free, multi-platform, and production-ready distribution of OpenJDK, featuring Long-Term Support (LTS) releases. It serves as the default JDK within Tencent for cloud computing, big data, and numerous other Java applications.

$ vfox install java@x.y.z-kona
$ vfox search java kona

Liberica (Bellsoft)

Liberica is a 100% open-source Java implementation. It is built from OpenJDK which BellSoft contributes to, is thoroughly tested and passed the JCK provided under the license from OpenJDK. All supported versions of Liberica also contain JavaFX.

$ vfox install java@x.y.z-librca
$ vfox search java librca

Liberica NIK (Bellsoft)

Liberica Native Image Kit is a utility that converts your JVM-based application into a fully compiled native executable ahead-of-time under the closed-world assumption with an almost instant startup time. Being compatible with various platforms, including lightweight musl-based Alpine Linux, it optimizes resource consumption and minimizes the static footprint.

$ vfox install java@x.y.z-nik
$ vfox search java nik

Mandrel (Red Hat)

Mandrel focuses on GraalVM's native-image component in order to provide an easy way for Quarkus users to generate native images for their applications. Developers using Quarkus should be able to go all the way from Java source code to lean, native, platform-dependent applications running on Linux. This capability is vital for deploying to containers in a cloud-native application development model.

$ vfox install java@x.y.z-mandrel
$ vfox search java mandrel

OpenJDK (jdk.java.net)

OpenJDK (Open Java Development Kit) is a free and open-source implementation of the Java Platform, Standard Edition (Java SE). It is the result of an effort Sun Microsystems began in 2006. The implementation is licensed under the GNU General Public License (GNU GPL) version 2 with a linking exception. Were it not for the GPL linking exception, components that linked to the Java class library would be subject to the terms of the GPL license. OpenJDK is the official reference implementation of Java SE since version 7.

$ vfox install java@x.y.z-open
$ vfox search java open

OpenJDK (Microsoft)

The Microsoft Build of OpenJDK is a no-cost distribution of OpenJDK that's open source and available for free for anyone to deploy anywhere. It includes Long-Term Support (LTS) binaries for Java 11 on x64 server and desktop environments on macOS, Linux, and Windows, and AArch64/ARM64 on Linux and Windows. Microsoft also publishes Java 16 binaries for all three major Operating Systems and both x64 and AArch64 (M1/ARM64) architectures.

$ vfox install java@x.y.z-ms
$ vfox search java ms

SapMachine (SAP)

SapMachine is a downstream version of the OpenJDK project. It is used to build and maintain a SAP supported version of OpenJDK for SAP customers and partners who wish to use OpenJDK to run their applications. SAP is committed to ensuring the continued success of the Java platform.

$ vfox install java@x.y.z-sapmchn
$ vfox search java sapmchn

Semeru (IBM)

Semeru Runtimes use the class libraries from OpenJDK, along with the Eclipse OpenJ9 Java Virtual Machine to enable developers to build and deploy Java applications that will start quickly, deliver great performance, all while using less memory.

$ vfox install java@x.y.z-sem
$ vfox search java sem

Temurin (Eclipse)

Formerly AdoptOpenJDK, the Eclipse Adoptium Temurin™ project provides code and processes that support the building of runtime binaries and associated technologies that are high performance, enterprise-caliber, cross-platform, open-source licensed, and Java SE TCK-tested for general use across the Java ecosystem.

$ vfox install java@x.y.z-tem
$ vfox search java tem

Trava (Trava)

TravaOpenJDK is OpenJDK for developers. It is based on dcevm and uses an integrated HotswapAgent, so allowing advanced hotswapping of classes by method and field addition or updates at runtime.

$ vfox install java@x.y.z-trava
$ vfox search java trava

Zulu (Azul Systems)

Azul Zulu Builds of OpenJDK are no-cost, production-ready open-source, TCK-tested, and certified OpenJDK distributions. They are available for a wide range of hardware platforms and operating systems and are compatible with special requirements, such as stripped-down JREs and builds, including OpenJFX and Coordinated Restore at Checkpoint (CRaC). They are supported as part of Azul Platform Core, which provides stabilized security updates for rapid, assured deployment into production and solution-oriented engineering assistance.

$ vfox install java@x.y.z-zulu
$ vfox search java zulu

Jetbrains

$ vfox install java@x.y.z-jb
$ vfox search java jb

Thanks

• SDKMAN
• foojayio

Releasing this plugin

Maintainers can publish from Actions → Plugin → Run workflow on the default branch by entering a stable plugin version without the v prefix. The shared workflow updates metadata.lua, creates the version commit and tag, and publishes the ZIP and manifest in this repository. No local tag or extra release token is needed. Pull requests run checks only; PR titles no longer trigger publication.

Existing version-tag pushes are supported when PLUGIN.version already matches the tag. If publication fails, re-run the original failed job to resume it.

The workflow follows the shared @v1 release-tool version. Updating the tool does not release this plugin. See the shared workflow documentation for the package contract and first-rollout requirements.