JavaFX SDK 19及更高版本中，原生库文件（如`.dll`）并非缺失，而是其存放位置和管理方式发生了变化。本文旨在澄清这一常见误解，并详细介绍在不同场景下如何定位这些原生库，以及如何利用现代JavaFX工具和打包策略，确保在构建JAR包或部署应用时，原生库能够被正确识别和加载。
引言：JavaFX原生库的误解与真相
在早期JavaFX版本中，开发者习惯于在SDK的bin目录下找到.dll等原生库文件，并利用它们来构建包含外部库的JAR包。然而，随着JavaFX版本的迭代，尤其是从JavaFX 11（作为OpenJFX项目的一部分独立于JDK发布）开始，SDK的目录结构发生了变化，导致许多开发者误认为新版本中缺少了这些关键的原生库文件，从而在打包应用时遇到困难。
实际上，JavaFX的原生库（如Windows上的.dll，macOS上的.dylib，Linux上的.so）并未消失。它们依然是JavaFX运行时的核心组成部分，只是其存储位置和在项目中的集成方式变得更加现代化和多样化。理解这些变化是成功构建和部署JavaFX应用的关键。
定位原生库文件：两种主要场景
JavaFX原生库文件的具体位置取决于你获取JavaFX SDK的方式。主要有两种场景：
立即学习“Java免费学习笔记（深入）”；
1. 从官方SDK发行版下载
如果你从OpenJFX官方网站（如GluonHQ）下载了预编译的JavaFX SDK发行版（通常是一个ZIP压缩包），解压后你会发现：
- 原生库文件位于lib/目录下。 例如，在Windows平台上，你会找到lib/javafx-font.dll、lib/javafx-graphics.dll等文件。macOS上对应的是.dylib文件，Linux上则是.so文件。
- 这些lib/目录下的文件是JavaFX运行时所必需的二进制组件，它们与JavaFX的JAR包（如javafx.controls.jar、javafx.graphics.jar）一同存在。
示例目录结构（部分）:
javafx-sdk-19/ ├── bin/ ├── legal/ ├── lib/ │ ├── javafx.base.jar │ ├── javafx.controls.jar │ ├── ... │ ├── javafx-font.dll (Windows) │ ├── javafx-graphics.dll (Windows) │ ├── ... │ ├── libjavafx_font.dylib (macOS) │ ├── libjavafx_graphics.dylib (macOS) │ └── ... └── src.zip
2. 通过Maven或Gradle管理依赖
当你使用Maven或Gradle等构建工具管理JavaFX依赖时，情况略有不同：
- 平台特异性JAR包内部包含原生库。 JavaFX的Maven仓库中提供了平台特定的模块JAR包，例如javafx-graphics-20-ea+11-mac.jar。这些JAR包的设计使得它们在顶层目录（或JAR包内部的特定路径）直接包含了对应平台的原生库文件。
- 这意味着你不需要手动去寻找或复制.dll等文件。构建工具在解析这些依赖时，会自动处理原生库的引入。当你运行或打包应用时，JVM会从这些JAR包中正确加载所需的原生库。
这种方式是现代JavaFX项目管理依赖的推荐方法，它极大地简化了跨平台开发和部署的复杂性。
构建与运行JavaFX应用：确保原生库可用
无论你选择哪种方式获取JavaFX，最终目标都是确保在应用程序运行时，JVM能够找到并加载所有必要的JavaFX模块和原生库。
1. 传统JAR包构建与运行（非模块化或混合模式）
如果你正在构建一个传统的、非模块化的可执行JAR包，并且希望在没有预安装JavaFX运行时的机器上运行，你需要确保以下几点：
- 将JavaFX SDK的lib目录添加到模块路径： 即使你的应用程序本身不是完全模块化的，JavaFX库是模块化的。因此，在运行命令时，你需要通过--module-path参数指定JavaFX SDK lib目录的路径，并使用--add-modules参数添加所需的JavaFX模块。
- 分发原生库： 当你分发应用程序时，不能只分发一个JAR包。你需要将JavaFX SDK lib目录下的所有JAR包（包括那些包含原生库的JAR）以及你的应用程序JAR包一同分发。通常，可以将JavaFX lib目录的内容放置在你应用程序根目录下的某个子目录中。
示例：使用命令行运行应用程序
假设你的应用程序JAR包名为YourApp.jar，并且JavaFX SDK解压到了/path/to/javafx-sdk-19。
java --module-path /path/to/javafx-sdk-19/lib \
--add-modules javafx.controls,javafx.fxml \
-jar YourApp.jar- --module-path: 指向包含JavaFX模块JAR包和原生库的目录。
- --add-modules: 指定你的应用程序需要用到的JavaFX模块。
2. 现代模块化应用与打包工具（推荐）
对于JavaFX应用，最推荐的打包和部署方式是利用Java平台的模块化特性和相关工具：
-
jlink：创建自定义运行时镜像jlink工具可以根据你的应用程序及其依赖（包括JavaFX模块和原生库）创建一个自定义的、最小化的JRE运行时镜像。这个镜像只包含应用程序运行所需的模块，从而减小了部署包的大小，并且完全自包含，无需目标机器预装JRE或JavaFX SDK。
基本jlink命令示例：
# 假设你的模块化应用已编译，并打包为 myapp.jar # JavaFX模块已通过Maven/Gradle下载到本地仓库 # 假设JavaFX模块路径为 /path/to/javafx-mods (例如从Maven本地仓库复制而来) # 创建一个模块路径，包含JavaFX模块和你的应用模块 MODULE_PATH="/path/to/javafx-mods:mods" # mods 包含你的应用模块JAR jlink --module-path "${MODULE_PATH}" \ --add-modules com.yourapp.main,javafx.controls,javafx.fxml \ --output myapp-runtime \ --launcher myapp=com.yourapp.main/com.yourapp.MainClass \ --strip-debug \ --compress=2 \ --no-header-files \ --no-man-pages生成的myapp-runtime目录将包含一个完整的、自包含的运行时环境，其中已经包含了JavaFX的原生库。
-
jpackage：生成平台特定安装包jpackage工具在jlink的基础上进一步，可以为你的应用程序生成平台特定的安装包，例如Windows的.exe、macOS的.dmg或Linux的.deb、.rpm。这些安装包会自动处理应用程序、运行时镜像（由jlink创建或jpackage内部调用jlink创建）以及原生库的打包和部署，提供用户友好的安装体验。
基本jpackage命令示例：
jpackage --input target/my-app-jar \ --name "My JavaFX App" \ --main-class com.yourapp.MainClass \ --main-jar myapp.jar \ --module-path /path/to/javafx-sdk-19/lib \ --add-modules javafx.controls,javafx.fxml \ --type exe # 或 dmg, deb --dest distjpackage是部署JavaFX应用程序的黄金标准，它能确保原生库和所有依赖都被正确地打包到最终的安装程序中。
注意事项与最佳实践
- 平台兼容性： 始终确保你使用的JavaFX SDK或Maven依赖是与你的目标操作系统和架构（x64, arm64等）相匹配的。不匹配的原生库会导致运行时错误。
- 构建工具集成： 强烈推荐使用Maven或Gradle等构建工具。它们能更好地管理JavaFX依赖，自动处理平台特异性JAR包，并简化jlink/jpackage的集成。许多JavaFX Maven/Gradle插件（如javafx-maven-plugin）可以进一步简化打包过程。
- --module-path的重要性： 即使在非模块化应用中，运行JavaFX应用也几乎总是需要--module-path来指定JavaFX模块的位置。
- 避免手动复制： 尽量避免手动复制.dll或其他原生库文件到你的项目目录。依赖于构建工具、jlink或jpackage来管理这些文件，可以减少错误并提高可维护性。
- IDE配置： 在IntelliJ IDEA、Eclipse等IDE中，确保你的项目设置正确配置了JavaFX SDK的模块路径，以便IDE能够正确编译和运行你的应用程序。
总结
JavaFX SDK 19及更高版本中，原生库文件并未消失，而是其存在形式和管理方式更加现代化。无论是通过直接下载SDK并在lib/目录中查找，还是通过Maven/Gradle依赖中内置于平台特定JAR包内部，原生库始终是可用的。
为了成功构建和部署JavaFX应用程序，开发者应：
- 理解原生库在不同场景下的定位方式。
- 对于传统JAR包，需手动确保JavaFX SDK的lib目录在运行时可通过--module-path访问。
- 对于现代应用，推荐采用jlink创建自定义运行时镜像，并通过jpackage生成平台特定的安装包，这是最健壮和用户友好的部署方案，它能自动处理原生库的打包和部署。
遵循这些策略，将能有效解决JavaFX原生库的困惑，并顺利地将你的JavaFX应用程序带给用户。
