ios-cmake项目中OS64COMBINED平台架构问题解析

在使用ios-cmake工具链构建iOS项目时，开发者可能会遇到一个常见问题：当指定-DPLATFORM=OS64COMBINED参数时，生成的二进制文件仅包含arm64架构，而没有预期的x86_64架构。这个问题看似简单，但背后涉及iOS构建工具链的工作原理。

问题现象

开发者通过以下CMake命令配置项目：

cmake ../../.. -B build -G Xcode -DCMAKE_TOOLCHAIN_FILE=tools/ios/ios.toolchain.cmake -DPLATFORM=OS64COMBINED -D_BUILD_CLIENT_DEMO=1

或者显式指定架构：

cmake ../../.. -B build -G Xcode -DCMAKE_TOOLCHAIN_FILE=tools/ios/ios.toolchain.cmake -DPLATFORM=OS64COMBINED -DARCHS="arm64;x86_64" -D_BUILD_CLIENT_DEMO=1

然而，使用lipo -info检查生成的二进制文件时，发现输出显示：

Non-fat file:xxx is architecture: arm64

问题本质

这个现象并非bug，而是对ios-cmake工具链工作流程的误解。OS64COMBINED平台确实支持生成包含多架构的通用二进制文件，但需要理解其完整的工作机制。

解决方案

关键在于构建流程的完整执行。ios-cmake工具链在OS64COMBINED模式下实际上会执行以下步骤：

1. 首先为每个指定的架构单独构建
2. 然后通过lipo工具将这些架构合并为一个通用二进制文件

这个合并操作是在CMake的install阶段自动完成的。因此，开发者需要执行完整的构建和安装流程：

cmake --build build --config Release
cmake --install build --config Release

深入理解

iOS开发中，通用二进制（Fat Binary）是指包含多个架构的单一可执行文件。对于OS64COMBINED平台，通常需要同时支持：

• arm64：用于真机设备
• x86_64：用于模拟器

ios-cmake工具链通过以下机制实现这一目标：

1. 在配置阶段，解析ARCHS参数确定需要构建的架构
2. 在构建阶段，为每个架构生成独立的中间产物
3. 在安装阶段，使用lipo工具合并这些架构

最佳实践

为了确保正确生成通用二进制文件，建议：

1. 明确指定需要的架构：

-DARCHS="arm64;x86_64"

2. 执行完整的构建和安装流程

3. 验证生成的二进制文件：

lipo -info 最终生成的二进制文件路径

预期输出应该类似于：

Architectures in the fat file: xxx are: arm64 x86_64

总结

理解ios-cmake工具链的工作流程对于正确生成多架构iOS应用至关重要。OS64COMBINED平台确实支持生成通用二进制文件，但需要开发者执行完整的构建和安装流程。这一设计使得构建过程更加灵活，允许开发者根据需要选择性地构建特定架构。