You need to enable JavaScript to run this app. Mac OS 11.2下jpackage带--license-file构建包报hdiutil报错的修复
优惠活动
大模型
产品
解决方案
定价
更多

Mac OS 11.2下jpackage带--license-file构建包报hdiutil报错的修复

MacOS环境下jpackage添加--license-file参数的构建异常排查

问题基础信息

  • 运行环境:Mac OS 11.2、OpenJDK 15.0.1
  • 触发条件:执行jpackage命令时传入--license-file license.txt参数
  • 异常表现:
    • 主构建流程可完整走完,无提前中断提示
    • 最终生成的安装包未包含指定的license文件
    • 终端抛出明确错误日志:java.io.IOException: Command [/usr/bin/hdiutil, unflatten, /Users/myproject/package-1.0.dmg] exited with 1 code

问题产生根因

  • 该异常属于OpenJDK 15.0.1版本中jpackage模块的已知平台适配bug,是针对Mac平台DMG安装包构建逻辑的链路缺陷导致的。
  • 具体执行逻辑问题:添加license参数后,jpackage会临时挂载刚生成的DMG镜像,将license内容写入镜像的系统配置区,完成写入后未正确同步镜像文件的系统读写权限,就直接调用系统自带的hdiutil unflatten命令,触发系统权限拦截导致命令执行失败。后续license的正式嵌入逻辑因为这个错误被中断,最终出现构建流程看似完整走完、但安装包缺失对应文件的表象。

对应修复方案

  • 临时绕开问题的方案
    • 预处理license文件:将license.txt保存为UTF-8无BOM格式,移除文件内的特殊控制字符,避免hdiutil在解析license内容时触发格式校验报错
    • 手动补全license嵌入流程:先执行不带--license-file参数的jpackage基础构建,生成原始DMG安装包后,手动通过hdiutil挂载镜像、写入license相关配置、重新封装镜像,绕开jpackage自带的bug触发逻辑
  • 从版本层面根治的方案
    • 将OpenJDK升级至15.0.2及以上小版本,该版本已修复jpackage模块中DMG构建流程下hdiutil unflatten调用的权限同步问题,可正常完成license文件嵌入
    • 长期生产构建场景可切换至OpenJDK 17 LTS版本,该版本的jpackage模块对MacOS平台DMG、PKG安装包的构建逻辑做了完整兼容,不存在license嵌入相关的已知适配问题

内容的提问来源于stack exchange,提问作者Hollow.Quincy

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 06:06:04