cc-rs 1.0.89版本在macOS ARM架构下构建rustls时的问题分析

问题背景

在macOS ARM架构主机上构建针对iOS目标（aarch64-apple-ios-sim和x86_64-apple-ios）的Rust静态库时，开发者遇到了一个构建失败问题。这个问题出现在使用cc-rs 1.0.89版本时，而之前的1.0.88版本则工作正常。

问题表现

当开发者尝试使用macOS的lipo工具将两个架构的静态库合并为一个"fat"静态库时，遇到了以下错误：

fatal error: lipo: archive member target/x86_64-apple-ios/debug/myrustlib.a(fad98b632b8ce3cc-curve25519.o) cputype (16777228) and cpusubtype (0) does not match previous archive members cputype (16777223) and cpusubtype (3) (all members must match)

错误表明在合并静态库时，目标文件的CPU类型和子类型不匹配。具体来说，x86_64目标架构下生成的目标文件实际上包含了ARM64架构的代码。

问题根源

经过bisect分析，确定问题源于cc-rs 1.0.89版本中的目标标志重构（#873）。这个重构影响了交叉编译时目标架构的正确设置，导致在x86_64-apple-ios目标下错误地生成了ARM64架构的目标文件。

最小复现案例

为了帮助开发者理解和验证这个问题，我们创建了一个最小复现案例：

1. 创建一个包含以下依赖项的Cargo.toml：

[dependencies]
ring = "0.17"
cc = "=1.0.89"

2. 使用以下简单的Rust代码：

pub extern "C" fn repro() {
    use ring::agreement;
    let rng = ring::rand::SystemRandom::new();
    agreement::EphemeralKey::generate(&agreement::X25519, &rng).unwrap();
}

3. 构建并检查目标文件架构：

cargo build --target x86_64-apple-ios
objdump target/x86_64-apple-ios/debug/librepro.a -h | grep arm64

在cc-rs 1.0.89版本下，这个检查会输出ARM64架构的目标文件，而实际上应该是x86_64架构。

解决方案

cc-rs项目维护者迅速响应并修复了这个问题。修复方案主要针对目标标志的处理逻辑，确保在交叉编译时正确设置目标架构。开发者可以通过以下方式解决：

1. 升级到cc-rs的最新版本（1.0.90或更高）
2. 如果暂时无法升级，可以显式指定cc-rs版本为1.0.88：

cc = "=1.0.88"

技术细节

这个问题涉及到macOS/iOS开发中的几个关键概念：

1. 多架构静态库：iOS开发通常需要支持多种架构（如arm64和x86_64），使用lipo工具将它们合并为一个通用二进制。

2. Mach-O格式：macOS和iOS使用的可执行文件格式，其中包含cputype和cpusubtype字段来标识目标架构。

3. 交叉编译：在macOS ARM主机上为iOS模拟器（x86_64）构建时，需要正确处理目标三元组和编译器标志。

结论

这个问题展示了构建工具链中目标架构处理的重要性，特别是在交叉编译场景下。cc-rs作为Rust生态中重要的构建工具，其正确性直接影响到许多依赖它的crate。开发者在使用较新版本的构建工具时，应当注意测试其在不同目标平台下的行为，特别是在涉及多架构合并的场景中。

对于遇到类似问题的开发者，建议：

1. 首先确认是否使用了受影响的cc-rs版本
2. 检查目标文件的实际架构是否符合预期
3. 考虑在CI中增加架构验证步骤，防止类似问题进入生产环境