Skip to content

Create native Java(FX) apps for desktop, mobile and embedded

License

Notifications You must be signed in to change notification settings

gluonhq/substrate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

51c966a · Mar 28, 2025
Mar 27, 2025
Nov 15, 2024
Mar 25, 2025
Mar 19, 2025
Oct 8, 2022
Oct 12, 2019
Mar 10, 2021
Sep 18, 2024
Dec 6, 2019
Mar 28, 2025
Oct 12, 2019
Oct 12, 2019
Nov 14, 2019
Oct 12, 2019

Repository files navigation

Gluon Substrate

Maven Central Github Actions

Gluon Substrate is a tool that converts Java(FX) Client applications into native executables for desktop, mobile and embedded devices. It uses the GraalVM GraalVM native-image tool to compile the required Java bytecode into code that can be executed on the target system (e.g. your desktop, on iOS, on a Raspberry Pi).

Gluon Substrate deals with JavaFX resources (e.g. FXML, shader code,...) and with platform-specific Java and native code that is part of the JavaFX platform.

While Gluon Substrate has an API that allows direct access to it, it is recommended to use the Maven plugin which simply requires some configuration in the pom.xml file of your project. The plugin will then invoke the Substrate API which in turn will use GraalVM native-image to compile the Java code, and it will link the result with the required libraries and configuration into a native executable.

There are a number of samples available that show you how to get started with Gluon Substrate. We recommend using your favourite IDE to run those samples.

Compilation

Linux hosts

To compile Gluon Substrate on Linux you need to install these development packages:

# on ubuntu (debian flavors)
apt-get install libasound2-dev libavcodec-dev libavformat-dev libavutil-dev libfreetype6-dev
apt-get install libgl-dev libglib2.0-dev libgtk-3-dev libpango1.0-dev libx11-dev libxtst-dev zlib1g-dev

# on fedora (redhat flavors), requires https://rpmfusion.org/
dnf install alsa-lib-devel freetype-devel glib2-devel gtk3-devel libX11-devel
dnf install libXtst-devel mesa-libGL-devel pango-devel zlib-devel
dnf install ffmpeg-devel

Issues and Contributions

Issues can be reported to the Issue tracker

Contributions can be submitted via Pull requests, providing you have signed the Gluon Individual Contributor License Agreement (CLA).