Mozc项目在macOS上构建通用二进制文件的问题分析

问题背景

Mozc作为一款开源输入法引擎，在macOS平台上构建通用二进制文件（同时支持x86_64和arm64架构）时遇到了构建失败的问题。这个问题出现在构建过程中，具体表现为框架文件重复放置的错误。

问题现象

构建过程中报错显示，在打包应用程序时，系统检测到多个文件试图被放置在同一个框架路径下："AboutDialog.app/Contents/Frameworks/QtCore"。错误信息明确指出，这违反了bundle的打包规则，不允许在同一个位置放置多个文件。

问题根源

经过分析，这个问题是由rules_apple构建规则的更新引起的。具体来说，rules_apple从3.5.1版本升级到3.8.0版本后，引入了一个变更：该变更原本是为了解决依赖的动态链接库(.dylib)文件正确打包到目标应用程序中的问题，但却意外导致了框架动态链接库的重复打包。

在构建通用二进制时，系统会为每个架构生成对应的动态链接库文件。当rules_apple尝试将这些文件打包到应用程序中时，由于新版本的变更，它会错误地尝试将同一框架的不同架构版本放置到相同路径下，从而引发了冲突。

临时解决方案

作为临时解决方案，项目团队采取了降级rules_apple版本的策略，将版本从3.8.0回退到3.5.1。这个版本不包含导致问题的变更，因此可以绕过这个构建错误。

根本解决方案

为了彻底解决这个问题，项目团队向rules_apple上游提交了修复方案。该修复确保在打包过程中不会重复处理框架的动态链接库文件，特别是处理通用二进制文件时能够正确处理多架构的情况。这个修复将被包含在rules_apple 3.8.0之后的版本中。

技术启示

这个问题展示了在跨平台开发中几个重要的技术点：

1. 构建系统兼容性：构建工具的更新可能引入意想不到的副作用，特别是在处理多平台、多架构的场景时。

2. 通用二进制构建：macOS上的通用二进制构建涉及同时处理多个架构的代码，这对构建系统提出了更高的要求。

3. 依赖管理：项目依赖的第三方工具链更新需要谨慎评估，特别是当这些更新涉及底层构建逻辑时。

4. 问题定位：通过分析构建错误和版本变更，可以快速定位问题的根本原因，并制定有效的解决方案。

对于开发者而言，这个案例强调了在更新构建工具链时进行全面测试的重要性，特别是在支持多架构构建的场景下。同时，也展示了开源社区协作解决问题的有效性，通过向上游项目提交修复，可以惠及整个生态系统。