JavaFX程序分发与Native Image编译技术咨询

一、分发时自带JRE（无需用户额外下载） #

方法1：jlink+自定义启动脚本 #

1. 确保项目为模块化结构，根目录存在module-info.java，声明依赖的JavaFX模块（如requires javafx.controls;）。
2. 生成精简自定义JRE镜像：

   jlink --module-path "你的JavaFX lib目录;你的编译输出模块目录" --add-modules 你的主模块名 --output jre-custom
   

   该命令会生成仅包含程序必需组件的JRE，体积远小于完整JRE。
3. 打包分发：将Jar包、jre-custom文件夹放在同一目录，编写启动脚本：
   • Windows（start.bat）：

     @echo off
     jre-custom\bin\java -jar your-app.jar
     

   把整个文件夹压缩后发给用户，双击脚本即可启动，无需额外安装JRE。

方法2：jpackage生成原生安装包（推荐） #

jpackage是JDK14+自带工具，可直接将JRE、Jar打包成exe/msi/dmg等安装包，用户双击安装即可使用，体验与原生程序一致：

1. 按方法1生成自定义JRE镜像jre-custom。
2. 执行打包命令：

   jpackage --type exe --input . --main-jar your-app.jar --main-class 你的主类全路径 --runtime-image jre-custom --name YourAppName
   

   执行完成后会生成exe安装包，用户安装后可在开始菜单找到程序，无需关注JRE存在。

二、编译为Native Image（完全原生程序） #

前提准备 #

1. 项目必须为模块化结构，module-info.java配置示例：

   module com.example.demo {
       requires javafx.controls;
       requires javafx.fxml;
       opens com.example.demo to javafx.fxml;
       exports com.example.demo;
   }
   

2. 确保Liberica NIK版本与JavaFX版本完全匹配（均为Java17），Windows环境需安装Visual Studio Build Tools（C++编译环境）。

编译命令 #

使用Liberica NIK的native-image命令：

native-image --module-path "你的JavaFX lib目录;你的编译输出目录" --module 你的模块名/你的主类全路径 --name YourAppExe

IntelliJ中可直接创建Native Image类型的Run配置，指定模块和主类，IDE会自动生成并执行命令。

解决段错误问题 #

• 排查是否使用Native Image不支持的特性：避免动态反射、JNI、动态类加载等（默认JavaFX示例一般无此问题）。
• 添加初始化参数，强制JavaFX核心模块在构建时初始化：

  native-image --initialize-at-build-time=javafx.controls,javafx.graphics,javafx.base --module-path ...（其他参数不变）
  

• 确保命令行环境可正常调用C++编译工具（如cl.exe），可打开Visual Studio的Developer Command Prompt执行编译命令。

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