使用GluonFX链接JavaFX应用遇未解析外部符号问题求助

问题原因 #

你遇到的链接错误，是因为应用调用了JDK内部com.sun.management.internal.OperatingSystemImpl类的本地方法，但GluonFX默认未包含这些内部API对应的本地库文件。

解决方案 #

1. 引入JDK内部模块并开放权限 #

需要在项目构建配置中，明确添加jdk.management模块依赖，并开放内部包的访问权限：

Maven配置（pom.xml）

在<dependencies>节点添加：

<dependency>
    <groupId>jdk.management</groupId>
    <artifactId>jdk.management</artifactId>
    <version>${java.version}</version>
    <scope>system</scope>
    <systemPath>${java.home}/lib/jdk.management.jar</systemPath>
</dependency>

在GluonFX插件配置中添加VM参数：

<plugin>
    <groupId>com.gluonhq</groupId>
    <artifactId>gluonfx-maven-plugin</artifactId>
    <version>1.0.21</version>
    <configuration>
        <mainClass>ch.cnlab.uxtest.MainKt</mainClass>
        <vmArgs>
            <arg>--add-modules=jdk.management</arg>
            <arg>--add-exports=jdk.management/com.sun.management.internal=ALL-UNNAMED</arg>
        </vmArgs>
    </configuration>
</plugin>

Gradle配置（build.gradle）

在dependencies块添加：

compile files("${System.getProperty('java.home')}/lib/jdk.management.jar")

在GluonFX配置中添加VM参数：

gluonfx {
    mainClass = 'ch.cnlab.uxtest.MainKt'
    vmArgs = [
            '--add-modules=jdk.management',
            '--add-exports=jdk.management/com.sun.management.internal=ALL-UNNAMED'
    ]
}

2. 手动指定链接所需本地库 #

Windows平台下，这些本地方法的实现位于JDK的management.lib中，需要告知GluonFX链接时引入该库：

Maven配置

在GluonFX插件的<configuration>中添加：

<linkerArgs>
    <arg>/LIBPATH:${java.home}/bin</arg>
    <arg>management.lib</arg>
</linkerArgs>

Gradle配置

在gluonfx配置块中添加：

linkerArgs = [
        "/LIBPATH:${System.getProperty('java.home')}/bin",
        "management.lib"
]

3. 修正runagent生成的JSON配置 #

如果上述步骤无效，检查target/gluonfx/目录下runagent生成的JSON文件，确保目标类和方法被包含。手动在JSON的classes数组中添加：

{
  "name": "com.sun.management.internal.OperatingSystemImpl",
  "methods": [
    {"name": "getFreeMemorySize0", "parameterTypes": []},
    {"name": "getTotalMemorySize0", "parameterTypes": []},
    {"name": "initialize0", "parameterTypes": []}
  ]
}

验证步骤 #

1. 清理旧构建产物：mvn gluonfx:clean（Maven）或./gradlew gluonfxClean（Gradle）
2. 重新执行打包：mvn gluonfx:build（Maven）或./gradlew gluonfxBuild（Gradle）

内容的提问来源于stack exchange，提问作者dzim