JavaFX SDK 19及更高版本中原生库的定位与JAR打包策略

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目录的内容放置在你应用程序根目录下的某个子目录中。

示例：使用命令行运行应用程序

标签： linux java windows idea 操作系统 app 工具 mac ai eclipse macos 解压