Electron-Builder构建过程中DMG/ZIP文件缺失问题解析

问题现象

在使用Electron-Builder进行macOS平台应用打包时，开发者遇到了一个奇怪的现象：原本能够正常生成的DMG安装包和ZIP压缩包突然不再生成，仅保留了.app应用程序包。这个问题出现在Electron-Builder 23.6.0版本，但测试发现即使在回退到旧版本后问题依然存在。

环境配置

典型的macOS构建配置通常包含以下内容：

mac:
  hardenedRuntime: true
  target:
    - target: dmg
      arch: arm64
    - target: zip
      arch: arm64

这种配置在过去一直正常工作，能够同时生成DMG安装镜像和ZIP压缩包。

问题排查

1. 版本回退测试：开发者尝试回退到3个月前确认能正常工作的代码版本，但问题依然存在，排除了代码变更导致问题的可能性。

2. 构建日志分析：建议通过设置DEBUG=electron-builder环境变量来获取更详细的构建日志，这通常能帮助定位问题根源。

3. 网络条件检查：最终发现问题的根源出人意料——网络上传带宽不足。虽然日常网络使用看似正常，但在代码签名阶段需要足够的带宽支持，当上传速度极低时(0.0Mbps)，会导致构建过程中断，无法完成DMG和ZIP文件的生成。

技术原理

Electron-Builder在macOS平台构建过程中，生成DMG和ZIP文件通常发生在代码签名之后。这些步骤需要：

1. 将签名后的.app包打包成DMG磁盘映像
2. 创建ZIP压缩包
3. 生成latest.yml更新元数据文件

当网络条件不佳时，特别是在代码签名阶段需要与苹果服务器通信时，可能会导致构建流程异常终止，从而跳过后续的打包步骤。

解决方案

1. 检查网络连接：确保有稳定且足够带宽的网络连接，特别是在代码签名阶段。

2. 离线构建测试：尝试在完全离线环境下构建，观察是否能够生成未签名的DMG/ZIP文件，这可以帮助确认是否是网络相关的问题。

3. 分步构建：考虑将构建过程分解为多个步骤，先构建.app包，再单独生成DMG/ZIP。

4. 监控网络状况：在构建过程中实时监控网络状态，特别是上传带宽使用情况。

经验总结

这个案例提醒开发者，构建工具的问题有时可能由看似不相关的系统环境因素引起。当遇到构建行为突然变化时，除了检查代码和工具链外，还应该考虑：

• 系统环境变化（如网络、权限、磁盘空间）
• 依赖服务的可用性（如代码签名服务器）
• 系统资源限制

Electron-Builder作为一个复杂的跨平台打包工具，其构建过程涉及多个阶段和外部依赖，全面考虑各种可能性才能有效解决问题。