29、macOS交叉编译：针对iOS/tvOS/watchOS的交叉编译、使用Xcode工具链

说实话，做苹果生态的交叉编译，跟Linux那套完全是两码事。我最早接触iOS交叉编译时，第一反应是「不就是改个工具链路径吗？」结果折腾了两天才发现，苹果的体系里藏着不少坑。

今天咱们就聊聊，在macOS上怎么用CMake配合Xcode工具链，给iOS、tvOS、watchOS做交叉编译。嗯，这里要注意，苹果的设备虽然都是ARM架构，但每个平台的SDK、签名要求、系统库都不一样，不能混用。

29.1 苹果交叉编译的核心思路

先理清一个概念：苹果的交叉编译，本质上是用macOS上的Xcode工具链，生成目标平台（比如iPhone）能跑的二进制。你想想看，Xcode本身就是一个跨平台编译器集合，它知道怎么给不同设备生成代码。

CMake要做的，就是告诉编译器：「嘿，别编译成Mac的Mach-O，给我编译成iOS的Mach-O。」

我个人习惯把苹果交叉编译拆成三步：

1. 选对SDK — 每个平台有对应的SDK路径，比如iPhoneOS.sdk、AppleTVOS.sdk
2. 设对架构 — arm64是标配，但模拟器可能需要x86_64
3. 配好签名 — 真机调试必须签名，模拟器不需要

29.2 编写iOS工具链文件

工具链文件是CMake交叉编译的灵魂。我直接给你看一个我项目里用过的iOS工具链文件，注释都写好了。

# iOS.toolchain.cmake
# 用于iOS真机和模拟器的交叉编译

# 设置目标系统
set(CMAKE_SYSTEM_NAME iOS)
set(CMAKE_SYSTEM_VERSION 15.0)  # 最低部署目标

# 指定架构
set(CMAKE_OSX_ARCHITECTURES "arm64" CACHE STRING "iOS架构")

# 找到Xcode工具链
set(CMAKE_C_COMPILER /usr/bin/clang)
set(CMAKE_CXX_COMPILER /usr/bin/clang++)

# 设置SDK路径
set(CMAKE_OSX_SYSROOT /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk)

# 告诉CMake使用苹果的编译方式
set(CMAKE_TRY_COMPILE_TARGET_TYPE STATIC_LIBRARY)

# 设置编译选项
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -miphoneos-version-min=15.0 -fembed-bitcode")
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -miphoneos-version-min=15.0 -fembed-bitcode")

# 设置链接器
set(CMAKE_LINKER /usr/bin/ld)
set(CMAKE_AR /usr/bin/ar CACHE FILEPATH "Archiver")
set(CMAKE_RANLIB /usr/bin/ranlib CACHE FILEPATH "Ranlib")

29.3 tvOS和watchOS的差异

tvOS和watchOS跟iOS很像，但SDK路径不同。说白了，就是把iPhoneOS换成AppleTVOS或WatchOS。

平台	SDK名称	架构	最低版本
iOS	iPhoneOS.sdk	arm64	15.0
tvOS	AppleTVOS.sdk	arm64	16.0
watchOS	WatchOS.sdk	arm64_32	9.0

watchOS比较特殊，它的架构是arm64_32，不是标准的arm64。我刚开始做watchOS编译时，没注意这个细节，编译出来的二进制在手表上直接崩溃。后来查文档才发现，苹果手表用的是32位指针的64位架构，省内存用的。

29.4 模拟器与真机的切换

开发时经常要在模拟器和真机之间切换。模拟器用的是macOS的运行时，所以SDK和架构都不一样。

# 模拟器配置示例
set(CMAKE_OSX_SYSROOT /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator.sdk)
set(CMAKE_OSX_ARCHITECTURES "x86_64;arm64")  # Apple Silicon Mac也能跑arm64模拟器

29.5 使用Xcode生成器

CMake可以直接生成Xcode工程文件，这对苹果开发者来说最方便。你想想看，在Xcode里调试、断点、性能分析，比命令行方便太多了。

# 生成iOS真机的Xcode工程
cmake -B build/ios \
  -G "Xcode" \
  -DCMAKE_TOOLCHAIN_FILE=ios.toolchain.cmake \
  -DCMAKE_SYSTEM_NAME=iOS \
  -DCMAKE_OSX_SYSROOT=iphoneos

# 生成模拟器的Xcode工程
cmake -B build/simulator \
  -G "Xcode" \
  -DCMAKE_SYSTEM_NAME=iOS \
  -DCMAKE_OSX_SYSROOT=iphonesimulator

这里有个小技巧：用-G "Xcode"生成器时，CMake会自动处理很多平台细节。你甚至可以不写工具链文件，直接指定CMAKE_OSX_SYSROOT和CMAKE_OSX_ARCHITECTURES就行。

29.6 实战：编译一个跨平台库

假设我们要编译一个静态库，同时支持iOS真机和模拟器。我一般会写一个脚本，分别编译两个版本，然后用lipo合并成通用二进制。

#!/bin/bash
# build_all.sh

# 编译真机版本
cmake -B build/ios \
  -DCMAKE_SYSTEM_NAME=iOS \
  -DCMAKE_OSX_SYSROOT=iphoneos \
  -DCMAKE_OSX_ARCHITECTURES=arm64
cmake --build build/ios

# 编译模拟器版本
cmake -B build/simulator \
  -DCMAKE_SYSTEM_NAME=iOS \
  -DCMAKE_OSX_SYSROOT=iphonesimulator \
  -DCMAKE_OSX_ARCHITECTURES="x86_64;arm64"
cmake --build build/simulator

# 合并成xcframework
xcodebuild -create-xcframework \
  -library build/ios/libmylib.a \
  -library build/simulator/libmylib.a \
  -output build/mylib.xcframework

29.7 知识体系总览

下面这张图，是我对苹果交叉编译整个流程的理解。你看一眼，心里就有数了。

29.8 常见问题与避坑

最后，我总结几个实际项目中容易踩的坑：

• Bitcode问题：Xcode 14之后默认不生成bitcode，但旧项目可能还有。如果编译时加了-fembed-bitcode，但链接的库没有bitcode，会报错。我建议新项目直接关掉bitcode。
• 签名证书：真机编译需要有效的开发者证书。CMake本身不处理签名，你得在Xcode里配好。或者用codesign命令手动签名。
• 最低版本不一致：如果工具链文件里设的CMAKE_SYSTEM_VERSION比实际SDK版本高，编译会通过，但链接时可能报错。我一般设成跟Xcode项目里的Deployment Target一致。
• 头文件路径：苹果的SDK里有些头文件是私有的，不能直接引用。比如可以，但就不行。编译时如果报头文件找不到，先检查是不是引用了私有API。