OpenJFX is the open-source project that develops JavaFX. This project builds Snap packages of OpenJFX directly from its source repository on GitHub. These packages, together with OpenJDK 11 or later, provide everything you need to develop a JavaFX application on Linux, including all of the latest JAR files, native libraries, JMOD archives, API documentation, and source code of JavaFX.

The branches of this repository publish the JavaFX general-availability (GA) release and early-access (EA) builds for six hardware platforms, listed below by their Debian architectures and machine hardware names:

Note: this repository uses branches differently from most repositories on GitHub. It follows the workflow recommended by Junio Hamano, the core maintainer of Git, for managing permanent parallel branches. The snapcraft.yaml build files are found only on the candidate, beta, and edge branches, named after the Snap channels where the builds are published. The files common to all branches are updated only on the main branch. Merges are done from the main branch to the three channel branches, never the other way.

See also

This project is one of four that I created to gain control of my development environment:

• OpenJDK - Current JDK release and early-access builds

  

• OpenJFX - Current JavaFX release and early-access builds

  

• Strictly Maven - Apache Maven™ in a strictly-confined snap

  

• Strictly NetBeans - Apache NetBeans® in a strictly-confined snap

  

Schedule

The table below shows the most recent schedule for OpenJFX. The channel columns list the JavaFX releases found on the channel during each phase of the schedule.

The leftwards arrow (←) indicates that the channel is closed. When a specific risk-level channel is closed, the Snap Store will select the package from the more conservative risk level in the column to its left. If the channel is re-opened, packages will once again be selected from the original channel.

Install

Install the OpenJFX Snap package with the command:

$ sudo snap install openjfx

The Snap package is strictly confined and adds no interfaces to its permissions.

Install the OpenJFX Snap package from a channel other than the stable channel with one of the following commands:

$ sudo snap install openjfx --candidate
$ sudo snap install openjfx --beta
$ sudo snap install openjfx --edge

You'll also need the Java Development Kit (JDK). On Debian-based systems such as Ubuntu, you can install the latest fully-supported OpenJDK release and documentation with the command:

$ sudo apt install default-jdk default-jdk-doc

On Fedora-based systems, you can install the latest OpenJDK release and documentation with the commands:

$ sudo dnf install java-latest-openjdk-devel
$ sudo dnf install java-latest-openjdk-jmods
$ sudo dnf install java-latest-openjdk-javadoc

On any Linux system, you can install the OpenJDK Snap package to get the current JDK release or an early-access build:

$ sudo snap install openjdk

When you install the OpenJDK and OpenJFX Snap packages, they connect automatically, allowing you to develop and deploy both Java and JavaFX applications. For example, installing the latest OpenJDK and OpenJFX Snap packages results in the following connection:

$ snap connections openjfx
Interface             Plug                 Slot                 Notes
content               -                    openjfx:jfx-18-1804  -
content[jfx-19-1804]  openjdk:jfx-19-1804  openjfx:jfx-19-1804  -

This connection provides the OpenJDK Snap package with read access to the OpenJFX Software Development Kit (SDK) and shared libraries so that you can compile, package, link, and run JavaFX applications.

Trust

The steps in building the packages are open and transparent so that you can gain trust in the process that creates them instead of having to put all of your trust in their publisher.

For each of the three channels, the table above links to:

• the Snapcraft build file that creates the Snap package,
• the release tags used to obtain the OpenJFX source code, and
• information about the package and its latest builds on Launchpad.

General-availability releases published to the candidate channel are eventually promoted to the stable channel.

The Launchpad build farm runs each build in a transient container created from trusted images to ensure a clean and isolated build environment. Snap packages built on Launchpad include a manifest that lets you verify the build and identify its dependencies.

Verify

Each OpenJFX package provides a software bill of materials (SBOM) and a link to its build log. This information is contained in a file called manifest.yaml in the directory /snap/openjfx/current/snap. The image-info section of the manifest provides a link to the package's page on Launchpad with its build status, including the complete log file from the container that ran the build. You can use this information to verify that the OpenJFX Snap package installed on your system was built from source on Launchpad using only the software in Ubuntu 18.04 LTS and the official Gradle releases.

For example, I'll demonstrate how I verify the OpenJFX Snap package installed on my system at the time of this writing. The snap info command shows that I installed OpenJFX version 19+11 with revision 512, the revision for the amd64 architecture:

$ snap info openjfx
...
channels:
  latest/stable:    19+11 2022-09-16 (512) 103MB -
  latest/candidate: ↑
  latest/beta:      ↑
  latest/edge:      20+3  2022-09-16 (511) 103MB -
installed:          19+11            (512) 103MB -

The following command prints the build information from the manifest file:

$ grep -A3 image-info /snap/openjfx/current/snap/manifest.yaml
image-info:
  build-request-id: lp-74095810
  build-request-timestamp: '2022-09-16T16:00:56Z'
  build_url: https://launchpad.net/~jgneff/openjfx-snap/+snap/openjfx-candidate/+build/1882555

The build_url in the manifest is a link to the page on Launchpad with the package's Build status and Store status. The store status shows that Launchpad uploaded revision 512 to the Snap Store, which matches the revision installed on my system. The build status shows a link to the log file with the label buildlog.

The end of the log file contains a line with the SHA512 checksum of the package just built, shown below with the checksum edited to fit on this page:

Snapping...
Snapped openjfx_19+11_amd64.snap
Starting Snapcraft 7.1.3
Logging execution to
  '/root/.cache/snapcraft/log/snapcraft-20220916-160844.287206.log'
da3302f078740d55...0a38cea62d6b18b1  openjfx_19+11_amd64.snap
Revoking proxy token...

The command below prints the checksum of the package installed on my system:

$ sudo sha512sum /var/lib/snapd/snaps/openjfx_512.snap
da3302f078740d55...0a38cea62d6b18b1  /var/lib/snapd/snaps/openjfx_512.snap

The two checksum strings are identical. Using this procedure, I verified that the OpenJFX Snap package installed on my system and the OpenJFX Snap package built and uploaded to the Snap Store by Launchpad are in fact the exact same package. For more information, see Launchpad Bug #1979844, "Allow verifying that a snap recipe build corresponds to a store revision."

Usage

Once installed, the OpenJFX Snap package includes the following directories:

• /snap/openjfx/current/sdk/api - Javadoc API documentation
• /snap/openjfx/current/sdk/jmods - JMOD archives for jlink
• /snap/openjfx/current/sdk/lib - Modular JAR files and native libraries
• /snap/openjfx/current/sdk/src - Java source code of JavaFX

On Fedora-based systems, these directories are found under the root directory /var/lib/snapd as a prefix to the locations shown above for Debian-based systems.

The JDK tools need to know two locations: the JavaFX library directory and the JMOD archives directory. The OpenJFX Snap package provides these locations with two environment variables, as described below.

The openjfx command prints the location of a file that defines the environment variables:

$ openjfx
/var/snap/openjfx/x1/openjfx.env

The file exports the JAVAFX_LIB and JAVAFX_MOD environment variables:

$ cat $(openjfx)
# Source this file for OpenJFX environment variables
export JAVAFX_LIB=/snap/openjfx/x1/sdk/lib
export JAVAFX_MOD=/snap/openjfx/x1/sdk/jmods

To set the variables in your current shell, use the source or "dot" (.) command to read and execute the commands from the file:

$ . $(openjfx)

You can then verify that JAVAFX_LIB and JAVAFX_MOD are defined with:

$ printenv | grep JAVAFX
JAVAFX_LIB=/snap/openjfx/x1/sdk/lib
JAVAFX_MOD=/snap/openjfx/x1/sdk/jmods

You can also manually set the environment variables to fixed locations that don't depend on the Snap revision number, as shown below:

$ export JAVAFX_LIB=/snap/openjfx/current/sdk/lib
$ export JAVAFX_MOD=/snap/openjfx/current/sdk/jmods

Once defined, you can use these variables in arguments to the java, javac, javadoc, jlink, and jpackage tools of the JDK.

Build

You can build the Snap package on Linux by installing Snapcraft on your development workstation. The snap/snapcraft.yaml files on the candidate, beta, and edge branches define the build for each channel. Run the following commands to install Snapcraft, clone this repository, and start building the package:

$ sudo snap install snapcraft --classic
$ git clone https://github.com/jgneff/openjfx.git
$ cd openjfx
$ snapcraft

To run the build remotely on Launchpad, enter the command:

$ snapcraft remote-build

See the Snapcraft Overview page for more information about building Snap packages.

License

This project is licensed under the GNU General Public License v2.0 with the Classpath exception, the same license used by Oracle for the OpenJFX project. See the files LICENSE and ADDITIONAL_LICENSE_INFO for details.

Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates. See the file TRADEMARK for details.