install4j如何为macOS单包归档创建自定义安装程序并解决异常

操作正确性判断 #

你所执行的迁移操作是完全正确的。install4j 9.x版本废弃「Installer-macOS single bundle」构建目标后，官方推荐的替代方案就是切换到「Archive-macOS single bundle archive」，勾选Use setup application并复用原有默认Installer的全量配置，能够100%保留之前的安装交互逻辑和动作执行规则，不存在配置逻辑错误。

故障原因说明 #

安装弹窗无图标和图片的原因 #

• 未正确关联macOS专属资源：需要确认「General Settings > macOS Options」下的*.icns*格式应用图标已完成绑定，同时「Installer > Screens & Actions」中各页面引用的图片资源已被添加到install4j项目资源库，且资源路径未使用硬编码的绝对路径
• 未开启资源嵌入开关：Archive类型构建目标默认不会自动继承旧Installer类型的资源嵌入配置，需要手动在「Build > macOS > Archive Options」中勾选Embed custom resources into installer app，否则安装包运行时无法读取到自定义的图标和图片资源

默认安装位置未指向Applications目录的原因 #

• 安装目录默认值配置错误：自定义Installer的「Installation Directory」屏幕的默认路径需配置为${installer:sys.preferredInstallationLocation}，该内置变量在macOS环境下会自动解析为/Applications/[你的应用名称]，如果配置了硬编码路径或者仅适配Windows的路径规则，就会出现定位偏差
• 未开启平台专属目录开关：检查「General Settings > Default Installation Directory」配置页，确认Use platform-specific default directories选项已开启，未开启时install4j会使用跨平台通用默认路径，而非macOS专属的Applications目录

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