如何在MacOS上将Kotlin编写的JavaFX程序导出为桌面应用

一、修复jlink "Output directory is empty" 报错 #

这个报错的核心原因是jlink无法识别需要打包的模块或参数配置有误，按以下步骤排查修复：

• 确保项目根目录下存在正确的module-info.java文件，模块声明需包含JavaFX和Kotlin的必要依赖，示例如下：

  module AntelopeSystemManager {
      requires javafx.controls;
      requires javafx.fxml;
      requires kotlin.stdlib;
  
      opens ui to javafx.fxml;
      exports ui;
  }
  

• 执行jlink时，必须明确指定--module-path（包含JavaFX SDK的lib目录、项目编译输出目录）、--add-modules（你的项目模块名），示例命令：

  jlink --module-path /path/to/javafx-sdk/lib:/path/to/your/project/out/production/modules \
        --add-modules AntelopeSystemManager \
        --output /path/to/your/jlink-output \
        --launcher run=AntelopeSystemManager/ui.AntelopeSystemManagerUI
  

• 注意：--output指定的目录不能提前存在，否则可能触发空目录错误。

二、解决javapackager卡住的问题 #

javapackager在Java 11及以后版本已被官方废弃，推荐使用替代工具jpackage，同时你的原命令存在2个可能导致卡住的问题：

• 指定的java.home是旧版Applet插件JRE，与JavaFX 11+兼容性差，应使用对应版本的JDK路径。
• 改用jpackage的示例命令（需安装JDK 16+，或配合jlink生成的自定义运行时镜像）：
  1. 先按第一部分生成jlink运行时镜像
  2. 执行jpackage打包：

     jpackage --name AntelopeSystemManager \
              --input /Users/nadavholtzman/Documents/AntelopeSystemManager/out/artifacts/AntelopeSystemManager_jar \
              --main-jar AntelopeSystemManager.jar \
              --main-class ui.AntelopeSystemManagerUI \
              --runtime-image /path/to/your/jlink-output \
              --output ~/Desktop \
              --type app-image
     

• 若不想提前生成jlink镜像，可让jpackage自动处理运行时，只需补充JavaFX模块路径：

  jpackage --name AntelopeSystemManager \
           --input /Users/nadavholtzman/Documents/AntelopeSystemManager/out/artifacts/AntelopeSystemManager_jar \
           --main-jar AntelopeSystemManager.jar \
           --main-class ui.AntelopeSystemManagerUI \
           --module-path /path/to/javafx-sdk/lib \
           --add-modules javafx.controls,javafx.fxml \
           --output ~/Desktop \
           --type app-image
  

额外注意事项 #

• 确保JavaFX SDK版本与你的JDK版本完全匹配（如JDK 17对应JavaFX 17）。
• 在IntelliJ等IDE中，需在项目设置里正确配置模块依赖，确保Kotlin编译产物与模块信息关联。

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