create-dmg项目在macOS上创建磁盘映像的常见问题解析

create-dmg是一个用于在macOS上创建磁盘映像(DMG)文件的实用工具。近期，许多用户在macOS Sonoma系统上使用该工具时遇到了几个典型问题，本文将深入分析这些问题的根源和解决方案。

APFS格式磁盘映像创建失败问题

当用户尝试创建APFS格式的磁盘映像时，工具会报错"unable to proceed with final disk image creation because the interstitial disk image was not found"。这个问题源于create-dmg对APFS磁盘映像处理逻辑的不足。

在macOS系统中，APFS格式的磁盘映像与传统的HFS+格式有显著不同。APFS映像会创建多个磁盘设备：

• 一个GUID分区表设备
• 一个APFS容器设备
• 实际的APFS卷设备

create-dmg原有的代码仅获取第一行设备信息，而实际上需要的是最后一行包含挂载点的设备信息。这导致工具无法正确找到已挂载的磁盘映像。

HFS+格式磁盘映像的路径问题

即使用户切换到HFS+格式，也会遇到另一个问题：挂载点路径前出现多余换行符。这是因为系统返回的设备信息格式发生了变化，而工具中的正则表达式匹配逻辑没有相应更新。

磁盘卸载失败问题

部分用户在创建过程中还会遇到磁盘无法卸载的问题，系统提示"Resource busy"。这通常是因为某些进程仍在访问磁盘映像内容，或者系统缓存尚未完全更新。

解决方案

最新版本的create-dmg(v1.2.2)已经修复了这些问题，主要改进包括：

1. 对于APFS映像，改为获取最后一行设备信息而非第一行
2. 优化了挂载点路径的提取逻辑，确保正确获取路径
3. 增强了错误处理和重试机制

对于仍在使用旧版本的用户，可以采取以下临时解决方案：

• 对于APFS映像问题，可以手动修改脚本，将获取设备信息的命令从sed 1q改为tail -n 1
• 对于路径问题，可以修改find_mount_dir()函数，去除路径前的多余字符

最佳实践建议

1. 始终使用最新版本的create-dmg工具
2. 创建磁盘映像时，确保没有其他进程正在访问目标目录
3. 如果遇到问题，可以尝试先手动卸载所有相关磁盘映像
4. 对于关键任务，建议在脚本中添加错误处理和日志记录

通过理解这些问题的技术背景和解决方案，开发者可以更有效地使用create-dmg工具来创建macOS应用程序的安装包。