如何用Java 17的jpackage工具设置macOS DMG卷图标？

针对你遇到的jpackage生成DMG时始终使用应用图标而非指定卷图标的问题，可按以下步骤排查修复：

1. 修正卷图标文件名（核心问题） #

jpackage对DMG卷图标的文件名匹配严格区分大小写，你的应用名称是Moose，对应卷图标必须命名为Moose-volume.icns（而非你当前使用的moose-volume.icns）。

修改脚本中的复制命令，确保目标文件名正确：

# 原命令
# cp "$APP_PATH"/src/main/resources/img/build-resources/moose-volume.icns "$APP_PATH"/deploy/resources/moose-volume.icns

# 修改后
cp "$APP_PATH"/src/main/resources/img/build-resources/moose-volume.icns "$APP_PATH"/deploy/resources/Moose-volume.icns

2. 确认资源目录路径与文件可用性 #

• 确保--resource-dir参数指向的"$APP_PATH"/deploy/resources目录确实包含所有资源文件，可提前用ls "$APP_PATH"/deploy/resources验证文件存在且文件名正确。
• 脚本中mkdir resources命令可能多余（你实际是往$APP_PATH/deploy/resources复制文件），建议改为mkdir -p "$APP_PATH"/deploy/resources确保目录存在，避免因当前工作目录不同导致的路径错误。

3. 验证.icns文件格式有效性 #

macOS的.icns文件需要包含多尺寸图标（16x16到1024x1024），若文件格式不标准会被jpackage忽略：

• 用系统自带的「图标编辑器」（Icon Composer）打开文件，检查是否包含全部必要尺寸；
• 若文件损坏，可通过img2icns等工具重新生成符合要求的.icns文件。

4. 显式配置DMG资源（可选兜底方案） #

在资源目录下创建dmg.properties文件，直接指定卷图标路径：

volume.icon=Moose-volume.icns

jpackage会优先读取该配置文件的设置，绕过文件名自动匹配逻辑。

验证修复效果 #

重新运行jpackage时，查看verbose输出，若出现类似Using volume icon from resource directory: Moose-volume.icns的日志，说明卷图标已被正确加载，挂载DMG时即可看到指定图标。

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