Electron Builder v25.0.0 在打包 macOS 通用应用时的架构冲突问题解析

问题背景

Electron Builder 是一个流行的 Electron 应用打包工具，在最新发布的 25.0.0 版本中，开发者在尝试打包 macOS 通用应用（Universal App，即同时支持 x64 和 arm64 架构）时遇到了一个关键问题。当应用包含原生依赖（如 node-pty 模块）时，打包过程会失败，并显示错误信息："the same architectures can't be in the same fat output file"。

问题现象

具体表现为：

1. 使用 electron-builder 25.0.0 版本
2. 打包目标设置为 universal
3. 应用包含原生依赖（如 node-pty）
4. 打包过程中出现 lipo 工具错误，提示两个文件具有相同的 arm64 架构，无法合并

技术分析

这个问题源于 electron-builder 与 @electron/rebuild 的集成方式变更。在 macOS 通用应用的打包过程中，electron-builder 需要：

1. 分别构建 x64 和 arm64 架构的应用
2. 使用 macOS 的 lipo 工具将两个架构的二进制文件合并为通用二进制文件

问题的核心在于 @electron/rebuild 在处理原生依赖时的行为。在 25.0.0 版本中，缺少了关键的 disablePreGypCopy 配置选项，导致：

1. 在构建 x64 架构时，错误地将 arm64 架构的二进制文件也复制过来
2. 当尝试合并两个架构时，lipo 工具发现两个文件都包含 arm64 架构，无法完成合并

解决方案

Electron Builder 团队在 25.0.1 版本中修复了这个问题，主要变更包括：

1. 在 @electron/rebuild 的配置中强制设置了 disablePreGypCopy: true
2. 确保在构建不同架构时，原生依赖能够正确地为每个架构单独构建
3. 更新了相关测试用例，确保类似问题不会再次出现

开发者应对建议

对于遇到此问题的开发者，可以采取以下措施：

1. 升级到 electron-builder 25.0.1 或更高版本
2. 如果暂时无法升级，可以使用 nativeRebuilder: "legacy" 配置回退到旧版重建器
3. 检查项目中的原生依赖是否都支持多架构构建

技术深度解析

macOS 通用二进制文件（Universal Binary）是苹果公司引入的一种特殊格式，允许单个二进制文件包含多个架构的代码。electron-builder 利用这一特性实现了一次打包同时支持 Intel 和 Apple Silicon 处理器的应用。

在底层实现上，electron-builder 使用 lipo 工具来合并不同架构的二进制文件。当原生依赖处理不当时，会导致架构信息混乱，这正是本次问题的根源。

总结

Electron Builder 25.0.1 版本修复了 macOS 通用应用打包时的架构冲突问题，确保了包含原生依赖的应用能够正确构建。这一改进对于需要支持多种 macOS 架构的 Electron 应用开发者尤为重要，保证了应用的兼容性和性能表现。