Notes项目解决macOS构建中随机失败的DMG创建问题

在Notes项目的持续集成过程中，开发团队遇到了一个棘手的问题：macOS构建经常随机失败，特别是在使用create-dmg工具创建磁盘映像(DMG)文件时。这个问题不仅影响了开发效率，还增加了维护成本，因为需要频繁手动触发重建。

问题根源分析

经过深入调查，团队发现问题的根源在于macOS 13及以上版本中的XProtectBehaviorService服务。当create-dmg工具内部调用hdiutil命令时，可能会遇到"Resource busy"错误，导致构建失败。这种现象是随机的，因为XProtectBehaviorService的行为具有不确定性。

解决方案评估

团队考虑了三种可能的解决方案：

1. 终止XProtectBehaviorService服务：在调用create-dmg或hdiutil前尝试终止该服务。然而，这种方法被证明不够可靠，因为服务可能随时重启。

2. 以root权限运行：让hdiutil或create-dmg以管理员权限执行。这种方法在社区反馈中表现较好，没有明显的负面评价。

3. 放弃DMG分发：改为分发压缩的.app文件夹。虽然技术上可行，但这会降低用户体验，因为DMG提供了更直观的安装方式（拖拽安装）。

最终实施方案

基于用户体验优先的原则，团队决定采用第二种方案——以root权限运行相关命令。这种方法既保持了现有的用户友好的DMG安装体验，又解决了构建过程中的随机失败问题。

技术实现细节

在GitHub Actions的workflow中，团队修改了构建脚本，使用sudo提升create-dmg的执行权限。关键修改包括：

1. 确保构建环境中有足够的权限执行sudo命令
2. 在调用create-dmg前添加sudo前缀
3. 处理可能出现的权限相关问题

经验总结

这个案例展示了在持续集成环境中处理平台特定问题时的典型思考过程：

1. 首先识别和确认问题的根本原因
2. 评估各种解决方案的优缺点
3. 选择对用户体验影响最小的方案
4. 实施并验证解决方案的有效性

通过这种方法，Notes项目成功解决了macOS构建中的随机失败问题，同时保持了良好的用户体验。这个经验也为其他面临类似问题的项目提供了有价值的参考。