JavaFX应用打包：现代SDK中原生库（DLLs等）的定位与管理指南_技术教程

针对javafx sdk 19及更高版本中原生库（如dlls）位置变化的困惑，本文详细阐述了如何定位这些库文件。我们将探讨从gluon下载的sdk中`lib/`目录的结构，以及maven仓库中平台特定jars的打包方式，并提供相应的应用打包策略，以确保javafx应用程序的顺利构建与部署。

在早期JavaFX版本中，开发者习惯于在SDK的bin目录下寻找.dll等原生库文件，以便在构建项目时将其包含进最终的JAR包中。然而，随着JavaFX版本的迭代，许多开发者发现新版SDK中bin目录不再包含这些文件，从而对如何打包带有外部库的JavaFX应用程序产生了疑问。事实上，原生库并未消失，只是其存放位置和管理方式发生了变化。

JavaFX SDK原生库的定位

现代JavaFX SDK中的原生库（如Windows上的.dll，macOS上的.dylib，Linux上的.so等）的定位方式取决于您获取JavaFX的方式：

1. 从官方SDK包获取

如果您从Gluon等官方渠道下载并解压了完整的JavaFX SDK二进制包（例如openjfx-20-ea+11_osx-x64_bin-sdk.zip），您会发现所有必要的原生库文件都位于SDK根目录下的lib/文件夹中。

例如，在一个解压后的JavaFX SDK目录结构中，您可能会看到：

javafx-sdk-20/
├── bin/
├── legal/
├── lib/
│   ├── javafx.base.jar
│   ├── javafx.controls.jar
│   ├── javafx.fxml.jar
│   ├── ...
│   ├── libjavafx_font.dylib  (macOS)
│   ├── libjavafx_iio.dylib   (macOS)
│   ├── ...
│   ├── glfw.dll              (Windows)
│   ├── prism_d3d.dll         (Windows)
│   └── ...
└── src.zip

这里的lib/目录不仅包含JavaFX的JAR文件，还包含了所有平台特定的原生库。在构建和运行JavaFX应用程序时，您需要确保JVM

能够找到这些库。

2. 通过Maven/Gradle依赖管理

当您使用Maven或Gradle等构建工具管理项目依赖时，JavaFX的原生库通常以平台特定JAR包的形式提供。这意味着，您不再需要手动处理lib/目录下的原生文件，构建工具会根据您的操作系统自动引入正确的依赖。

例如，在Maven中央仓库中，JavaFX的某些模块（如javafx-graphics）会有针对不同操作系统的变体，通过classifier进行区分：

javafx-graphics-*-mac.jar (macOS)
javafx-graphics-*-win.jar (Windows)
javafx-graphics-*-linux.jar (Linux)

这些平台特定的JAR包内部就包含了对应的原生库。

JavaFX应用程序的打包策略

了解了原生库的定位后，我们可以根据不同的项目设置选择合适的打包策略。

1. 使用直接下载的SDK进行打包

如果您选择直接使用下载的JavaFX SDK，并在没有Maven/Gradle的情况下进行构建，您需要手动配置构建路径和打包过程，以确保原生库被正确包含或引用。

基本步骤：

编译： 确保Java编译器在编译时能找到JavaFX的JAR文件（位于SDK的lib/目录）。
运行/打包：
- 运行时指定模块路径： 在运行应用程序时，使用--module-path参数指向JavaFX SDK的lib/目录，并使用--add-modules指定所需的JavaFX模块。
- 使用jlink创建自定义运行时： jlink工具可以根据您的应用程序需求，创建一个包含JVM、JavaFX模块及所有原生库的最小化运行时环境。这对于分发独立的应用程序非常有用。
- 使用jpackage创建安装包： jpackage工具可以在jlink的基础上，进一步创建平台特定的安装包（如Windows的.exe，macOS的.dmg，Linux的.deb或.rpm）。它会自动处理原生库的包含和路径问题。

示例 (命令行运行):

假设您的应用程序主类是com.example.MyApp，并且您已经将JavaFX SDK解压到/path/to/javafx-sdk-20。

# 编译
javac --module-path /path/to/javafx-sdk-20/lib --add-modules javafx.controls,javafx.fxml -d out src/com/example/*.java

# 运行
java --module-path /path/to/javafx-sdk-20/lib --add-modules javafx.controls,javafx.fxml -jar YourApp.jar
# 或者 (如果不是打包成jar)
java --module-path /path/to/javafx-sdk-20/lib --add-modules javafx.controls,javafx.fxml -p out -m com.example/com.example.MyApp

在实际打包时，jlink和jpackage是更推荐的工具，它们能自动化原生库的集成。

2. 使用Maven/Gradle管理依赖并打包

这是现代JavaFX项目最推荐的实践方式。构建工具会自动处理原生库的引入。

Maven 示例 (pom.xml):

您需要在dependencies部分为JavaFX模块添加相应的依赖，并指定classifier来引入平台特定的原生库。


    
    
        UTF-8
        20
        17
        17
    

    
        
            org.openjfx
            javafx-controls
            ${javafx.version}
        
        
            org.openjfx
            javafx-fxml
            ${javafx.version}
        
        
        
            org.openjfx
            javafx-graphics
            ${javafx.version}
            ${os.detected.classifier} 
        
        
            org.openjfx
            javafx-controls
            ${javafx.version}
            ${os.detected.classifier}
        
        
    

    
        
            
            
                org.codehaus.mojo
                flatten-maven-plugin
                1.2.7
                
                    
                        flatten
                        process-resources
                        
                            flatten
                        
                        
                            true
                            ${project.build.directory}
                            oss
                        
                    
                
            
            
                org.openjfx
                javafx-maven-plugin
                0.0.8
                
                    com.example.MyApp

Gradle 示例 (build.gradle):

plugins {
    id 'java'
    id 'application'
    id 'org.openjfx.javafxplugin' version '0.0.10' // JavaFX Gradle 插件
}

group 'com.example'
version '1.0-SNAPSHOT'

repositories {
    mavenCentral()
}

javafx {
    version = "20"
    modules = [ 'javafx.controls', 'javafx.fxml' ]
}

mainClassName = 'com.example.MyApp'

在这些配置中，JavaFX Maven/Gradle插件会自动处理平台特定原生库的引入和打包，极大地简化了开发流程。

3. 模块化（Jigsaw）与jlink的集成

Java 9引入的模块系统（Jigsaw）为JavaFX应用程序的部署提供了更优雅的解决方案。通过将JavaFX应用程序模块化，并结合jlink工具，您可以创建包含应用程序所需所有Java模块和原生库的自定义运行时镜像。

优势：

轻量级： 只包含应用程序实际需要的模块和原生库，减小了分发包的大小。
独立性： 应用程序可以包含自己的JRE，无需用户安装独立的Java环境。
安全性： 模块系统提供了更强的封装性。

基本流程：

创建module-info.java： 为您的应用程序创建模块描述符，声明对JavaFX模块的依赖。
使用jlink： 运行jlink命令，指定您的应用程序模块、JavaFX模块以及输出目录，生成一个包含所有依赖的自定义运行时镜像。

// src/main/java/module-info.java
module com.example.myapp {
    requires javafx.controls;
    requires javafx.fxml;

    opens com.example to javafx.fxml;
    exports com.example;
}

示例 (使用jlink):

# 假设您的应用程序JAR和JavaFX SDK都在当前目录
# --module-path 指向应用程序模块和JavaFX模块
# --add-modules 指定要包含的模块
# --output 指定输出目录
jlink --module-path "path/to/YourApp.jar;path/to/javafx-sdk-20/lib" \
      --add-modules com.example.myapp,javafx.controls,javafx.fxml \
      --output myapp-runtime

生成的myapp-runtime目录将包含一个完整的Java运行时环境和您的应用程序，可以直接运行。

关键注意事项与最佳实践

版本匹配： 确保您使用的JavaFX SDK版本与您的JDK版本兼容。通常，JavaFX SDK会明确指出其支持的JDK版本范围。
平台兼容性： 在处理原生库时，务必注意目标平台的兼容性。Windows的.dll不能在macOS或Linux上运行。使用Maven/Gradle的classifier或jpackage可以很好地处理这一点。
使用构建工具： 强烈建议使用Maven或Gradle来管理JavaFX项目的依赖和构建过程。它们能自动化许多复杂任务，特别是原生库的引入。
探索jlink和jpackage： 对于生产环境的部署，jlink和jpackage是创建专业级、独立应用程序包的强大工具。它们能有效解决原生库的捆绑和分发问题。
文档查阅： 遇到问题时，优先查阅JavaFX官方文档和Gluon提供的指南，它们通常包含最新和最准确的信息。

通过理解JavaFX SDK中原生库的实际位置变化，并采用现代化的构建和打包策略，开发者可以更高效、更可靠地构建和部署JavaFX应用程序。