使用install4j构建时如何向Java FX应用传参，Mac端传参失效如何解决

问题根因 #

macOS 下 .app 格式应用的默认启动逻辑与 Windows 不同，install4j 生成的 macOS 启动器默认不会将启动参数传递到 Java 主类，同时部分版本 JavaFX 的 macOS 原生适配逻辑也会拦截启动参数，导致参数无法进入 main 方法。 #

解决步骤 #

• 第一步：调整 install4j 启动器默认配置
  打开 install4j 项目，进入对应 macOS 平台的启动器配置页，切换到「macOS 选项」标签，勾选 将命令行参数传递给主类 选项，该选项默认处于未勾选状态。
• 第二步：关闭 JavaFX macOS 参数拦截
  进入启动器的「VM 参数」配置栏，添加参数：

  -Djavafx.macosx.embedded=false
  

  该参数会禁用 JavaFX 对 macOS 启动参数的默认拦截逻辑，避免参数被 JavaFX 框架层吞掉。
• 第三步：文件关联场景额外配置
  如果你的应用需要处理关联格式文件的打开请求，需要进入 install4j 的「文件关联」配置页，针对 macOS 平台勾选 将打开的文件路径作为启动参数传递，否则双击关联文件触发的应用启动不会传入文件路径参数。

验证方法 #

打包测试时不要直接双击 .app 启动，打开终端执行以下命令验证参数传递效果：

open /Applications/你的应用名称.app --args 测试参数1 测试参数2

常见排查点 #

如果调整配置后仍无法正常传参，优先排查以下配置：

• 确认 macOS 启动器的沙箱配置是否开启，如果非 App Store 上架需求，调试阶段可先关闭沙箱，避免沙箱权限限制导致参数传递被拦截
• 确认你安装的应用没有被 macOS Gatekeeper 拦截异常修改，可右键选择打开一次应用后再测试参数传递

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