I get
Exception in thread "main" java.lang.RuntimeException: Exception in Application start method
at com.sun.javafx.application.LauncherImpl.launchApplication1(LauncherImpl.java:893)
at com.sun.javafx.application.LauncherImpl.lambda$launchApplication$2(LauncherImpl.java:195)
at java.lang.Thread.run(Thread.java:833)
at com.oracle.svm.core.thread.PlatformThreads.threadStartRoutine(PlatformThreads.java:704)
at com.oracle.svm.core.windows.WindowsPlatformThreads.osThreadStartRoutine(WindowsPlatformThreads.java:143)
Caused by: java.lang.NoClassDefFoundError: Lcom/fazecast/jSerialComm/SerialPort;
at com.oracle.svm.jni.functions.JNIFunctions.FindClass(JNIFunctions.java:348)
at com.oracle.svm.jni.JNIOnLoadFunctionPointer.invoke(JNILibraryInitializer.java)
at com.oracle.svm.jni.JNILibraryInitializer.callOnLoadFunction(JNILibraryInitializer.java:69)
at com.oracle.svm.jni.JNILibraryInitializer.initialize(JNILibraryInitializer.java:126)
at com.oracle.svm.core.jdk.NativeLibrarySupport.addLibrary(NativeLibrarySupport.java:186)
at com.oracle.svm.core.jdk.NativeLibrarySupport.loadLibrary0(NativeLibrarySupport.java:142)
at com.oracle.svm.core.jdk.NativeLibrarySupport.loadLibraryAbsolute(NativeLibrarySupport.java:101)
at java.lang.ClassLoader.loadLibrary(ClassLoader.java:54)
I have followed the requirements documented at https://docs.gluonhq.com/#_maven_archetype & https://docs.gluonhq.com/#platforms_windows
Project created in IntelliJ Idea and I'm using Maven ver. 3.8.8
I use the X64 Native Tools Command Prompt (using Windows 11 Pro) with below goals:
mvn gluonfx:run
mvn gluonfx:runagent
mvn gluonfx:build
mvn gluonfx:nativerun
When com.fazecast.jSerialComm.SerialPort is not included in the project I can run all 4 goals just fine so I guess my setup is done right.
When I include com.fazecast.jSerialComm.SerialPort in the project I can only run the first three goals and get above exception when running gluonfx:nativerun goal.
This is my MRE:
package org.example;
import com.fazecast.jSerialComm.SerialPort;
import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Label;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;
public class App extends Application {
@Override
public void start(Stage stage) {
String name = "";
SerialPort[] portsArray = SerialPort.getCommPorts();
for (SerialPort port : portsArray) {
System.out.println(port.getDescriptivePortName());
name = port.getDescriptivePortName();
}
var label = new Label(name);
var scene = new Scene(new StackPane(label), 640, 480);
stage.setScene(scene);
stage.show();
}
public static void main(String[] args) {
launch();
}
}
This is my pom.xml:
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.example</groupId>
<artifactId>untitled</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.source>11</maven.compiler.source>
<maven.compiler.target>11</maven.compiler.target>
</properties>
<dependencies>
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-controls</artifactId>
<version>24</version>
</dependency>
<dependency>
<groupId>com.fazecast</groupId>
<artifactId>jSerialComm</artifactId>
<version>2.11.0</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>com.gluonhq</groupId>
<artifactId>gluonfx-maven-plugin</artifactId>
<version>1.0.26</version>
<configuration>
<mainClass>org.example.App</mainClass>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.0</version>
<configuration>
<release>11</release>
</configuration>
</plugin>
<plugin>
<groupId>org.openjfx</groupId>
<artifactId>javafx-maven-plugin</artifactId>
<version>0.0.6</version>
<executions>
<execution>
<id>default-cli</id>
<configuration>
<mainClass>org.example.App</mainClass>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
I dont see any jni-config.json or resource-config.json in src/main/resources/META-INF/native-image/, I only have filter-file.json in that folder.
This is the output when running mvn gluonfx:runagent:
C:\Users\xxx\IdeaProjects\untitled>mvn gluonfx:runagent
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------< org.example:untitled >------------------------
[INFO] Building untitled 1.0-SNAPSHOT
[INFO] from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] >>> gluonfx-maven-plugin:1.0.26:runagent (default-cli) > process-classes @ untitled >>>
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ untitled ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] Copying 1 resource
[INFO]
[INFO] --- maven-compiler-plugin:3.8.0:compile (default-compile) @ untitled ---
[INFO] Nothing to compile - all classes are up to date
[INFO]
[INFO] <<< gluonfx-maven-plugin:1.0.26:runagent (default-cli) < process-classes @ untitled <<<
[INFO]
[INFO]
[INFO] --- gluonfx-maven-plugin:1.0.26:runagent (default-cli) @ untitled ---
[WARN] Maven will be executed in interactive mode, but no input stream has been configured for this MavenInvoker instance.
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------< org.example:untitled >------------------------
[INFO] Building untitled 1.0-SNAPSHOT
[INFO] from agentPom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] >>> javafx-maven-plugin:0.0.8:run (default-cli) > process-classes @ untitled >>>
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ untitled ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] Copying 1 resource
[INFO]
[INFO] --- maven-compiler-plugin:3.8.0:compile (default-compile) @ untitled ---
[INFO] Nothing to compile - all classes are up to date
[INFO]
[INFO] <<< javafx-maven-plugin:0.0.8:run (default-cli) < process-classes @ untitled <<<
[INFO]
[INFO]
[INFO] --- javafx-maven-plugin:0.0.8:run (default-cli) @ untitled ---
[WARNING] Module name not found in <mainClass>. Module name will be assumed from module-info.java
Intel(R) Active Management Technology - SOL (COM3)
Communications Port (COM1)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 7.461 s
[INFO] Finished at: 2025-04-04T17:58:07+02:00
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 9.442 s
[INFO] Finished at: 2025-04-04T17:58:07+02:00
[INFO] ------------------------------------------------------------------------
This is the content of agentPom.xml:
<?xml version="1.0"?>
<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<modelVersion>4.0.0</modelVersion>
<groupId>org.example</groupId>
<artifactId>untitled</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<maven.compiler.target>21</maven.compiler.target>
<maven.compiler.source>21</maven.compiler.source>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-controls</artifactId>
<version>21</version>
</dependency>
<dependency>
<groupId>com.fazecast</groupId>
<artifactId>jSerialComm</artifactId>
<version>2.11.0</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>com.gluonhq</groupId>
<artifactId>gluonfx-maven-plugin</artifactId>
<version>1.0.26</version>
<configuration>
<mainClass>org.example.App</mainClass>
</configuration>
</plugin>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.0</version>
<configuration>
<release>11</release>
</configuration>
</plugin>
<plugin>
<groupId>org.openjfx</groupId>
<artifactId>javafx-maven-plugin</artifactId>
<version>0.0.8</version>
<executions>
<execution>
<id>default-cli</id>
<configuration>
<mainClass>org.example.App</mainClass>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
Output for José:
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------< org.example:untitled >------------------------
[INFO] Building untitled 1.0-SNAPSHOT
[INFO] from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] >>> gluonfx-maven-plugin:1.0.26:runagent (default-cli) > process-classes @ untitled >>>
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ untitled ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] Copying 1 resource
[INFO]
[INFO] --- maven-compiler-plugin:3.8.0:compile (default-compile) @ untitled ---
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 2 source files to C:\Users\XX\IdeaProjects\untitled\target\classes
[INFO]
[INFO] <<< gluonfx-maven-plugin:1.0.26:runagent (default-cli) < process-classes @ untitled <<<
[INFO]
[INFO]
[INFO] --- gluonfx-maven-plugin:1.0.26:runagent (default-cli) @ untitled ---
[WARN] Maven will be executed in interactive mode, but no input stream has been configured for this MavenInvoker instance.
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------< org.example:untitled >------------------------
[INFO] Building untitled 1.0-SNAPSHOT
[INFO] from agentPom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] >>> javafx-maven-plugin:0.0.8:run (default-cli) > process-classes @ untitled >>>
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ untitled ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] Copying 1 resource
[INFO]
[INFO] --- maven-compiler-plugin:3.8.0:compile (default-compile) @ untitled ---
[INFO] Nothing to compile - all classes are up to date
[INFO]
[INFO] <<< javafx-maven-plugin:0.0.8:run (default-cli) < process-classes @ untitled <<<
[INFO]
[INFO]
[INFO] --- javafx-maven-plugin:0.0.8:run (default-cli) @ untitled ---
[WARNING] Module name not found in <mainClass>. Module name will be assumed from module-info.java
native-image-agent: Warning: could not open configuration file: java.io.FileNotFoundException: C:\Users\XX\IdeaProjects\untitled\src\main\resources\META-INF\native-image\reflect-config.json (The system cannot find the file specified)
native-image-agent: Warning: could not open configuration file: java.io.FileNotFoundException: C:\Users\XX\IdeaProjects\untitled\src\main\resources\META-INF\native-image\jni-config.json (The system cannot find the file specified)
native-image-agent: Warning: could not open configuration file: java.io.FileNotFoundException: C:\Users\XX\IdeaProjects\untitled\src\main\resources\META-INF\native-image\resource-config.json (The system cannot find the file specified)
native-image-agent: Warning: could not open configuration file: java.io.FileNotFoundException: C:\Users\XX\IdeaProjects\untitled\src\main\resources\META-INF\native-image\proxy-config.json (The system cannot find the file specified)
native-image-agent: Warning: could not open configuration file: java.io.FileNotFoundException: C:\Users\XX\IdeaProjects\untitled\src\main\resources\META-INF\native-image\serialization-config.json (The system cannot find the file specified)
native-image-agent: Warning: could not open configuration file: java.io.FileNotFoundException: C:\Users\XX\IdeaProjects\untitled\src\main\resources\META-INF\native-image\predefined-classes-config.json (The system cannot find the file specified)
Intel(R) Active Management Technology - SOL (COM3)
Communications Port (COM1)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 33.191 s
[INFO] Finished at: 2025-04-04T20:14:33+02:00
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 36.491 s
[INFO] Finished at: 2025-04-04T20:14:33+02:00
[INFO] ------------------------------------------------------------------------
When you build and run the native image of your project, after including the jSerialComm dependency, you should get an exception like:
[INFO] [SUB] java.lang.UnsatisfiedLinkError: Cannot load native library. Errors as follows:
[INFO] [SUB] [1]: no jSerialComm in java.library.path
[INFO] [SUB]
[INFO] [SUB] at com.fazecast.jSerialComm.SerialPort.<clinit>(SerialPort.java:273)
[INFO] [SUB] at com.gluonhq.hello.HelloGluon.postInit(HelloGluon.java:100)
[INFO] [SUB] at com.gluonhq.charm.glisten.application.AppManager.continueInit(AppManager.java:328)
[INFO] [SUB] at com.gluonhq.charm.glisten.application.AppManager.start(AppManager.java:288)
[INFO] [SUB] at com.gluonhq.hello.HelloGluon.start(HelloGluon.java:85)
[INFO] [SUB] at com.sun.javafx.application.LauncherImpl.lambda$launchApplication1$9(LauncherImpl.java:839)
[INFO] [SUB] at com.sun.javafx.application.PlatformImpl.lambda$runAndWait$12(PlatformImpl.java:483)
[INFO] [SUB] at com.sun.javafx.application.PlatformImpl.lambda$runLater$10(PlatformImpl.java:456)
[INFO] [SUB] at java.security.AccessController.executePrivileged(AccessController.java:169)
[INFO] [SUB] at java.security.AccessController.doPrivileged(AccessController.java:399)
[INFO] [SUB] at com.sun.javafx.application.PlatformImpl.lambda$runLater$11(PlatformImpl.java:455)
[INFO] [SUB] at com.sun.glass.ui.InvokeLaterDispatcher$Future.run(InvokeLaterDispatcher.java:95)
[INFO] [SUB] at com.oracle.svm.jni.JNIJavaCallWrappers.jniInvoke_VARARGS_Runnable_run_16403f8d32adb631126daa893e5e80085c5d6325(JNIJavaCallWrappers.java:0)
which already points out to the reason why it fails: it can't find the jSerialComm native library.
If you check the jSerialComm.jar, you will see that it contains native libraries for each platform:
/Windows/x86_64/jSerialComm.dll
/OSX/aarch64/libjSerialComm.jnilib
...
By default, when you build the native image, those files are not included (see https://docs.gluonhq.com/#\_resourceslist for the list of file extensions that are included by default).
So one easy way to fix the issue is by running gluonfx:runagent (see https://docs.gluonhq.com/#_gluonfxrunagent), and making sure you explore the scenario where the jSerialComm library is used.
Then you can verify that it has created some files with it:
// src/main/resources/META-INF/native-image/resource-config.json
{
"resources":{
"includes":[
{
"pattern":"\\QOSX/aarch64/libjSerialComm.jnilib\\E"
},
...
and
// src/main/resources/META-INF/native-image/jni-config.json
[
{
"name":"[Lcom.fazecast.jSerialComm.SerialPort;"
},
{
"name":"com.fazecast.jSerialComm.SerialPort",
"fields":[
{"name":"autoFlushIOBuffers"},
{"name":"baudRate"},
...
{"name":"xoffStopChar"},
{"name":"xonStartChar"}
],
"methods":[{"name":"<init>","parameterTypes":[] }]
},
...
Now build again the native image, and run it, it should work.
For instance, on macOS I get:
[INFO] [SUB] debug-console
[INFO] [SUB] debug-console (Dial-In)
[INFO] [SUB] Bluetooth-Incoming-Port
[INFO] [SUB] Bluetooth-Incoming-Port (Dial-In)
...