Xcode14编译Pod分发框架时出现Swift架构不兼容问题求解

问题背景 #

使用Xcode13生成的用于Pod分发的框架，应用端在设备及模拟器上均可正常编译；但使用Xcode14执行相同xcodebuild命令生成框架后，通过Pod集成到应用时抛出unsupported Swift architecture error错误。使用的xcodebuild命令如下：

Command line invocation:/Applications/Xcode_14.0.1.app/Contents/Developer/usr/bin/xcodebuild build -workspace <workSpacePath> -configuration Release -sdk iphonesimulator -scheme <Scheme_name> -derivedDataPath <Derived_path> CODE_SIGNING_ALLOWED=NO ENABLE_BITCODE=YES BITCODE_GENERATION_MODE=bitcode SKIP_INSTALL=NO

Build settings from command line:
BITCODE_GENERATION_MODE = bitcode
CODE_SIGNING_ALLOWED = NO
ENABLE_BITCODE = YES
SDKROOT = iphonesimulator16.0
SKIP_INSTALL = NO

核心原因 #

Xcode14对模拟器架构的默认生成逻辑发生了变化：

• 在Apple Silicon Mac上，Xcode14默认仅生成arm64架构的模拟器框架；在Intel Mac上则仅生成x86_64架构
• 若应用项目在不同架构的Mac上编译，或需要同时兼容两种模拟器架构，就会出现架构不匹配的错误
• 此外，Swift版本的跨版本兼容性、Podspec的架构配置缺失也可能引发该问题

解决方案 #

1. 检查框架当前包含的架构 #

先确认生成的框架支持哪些架构，执行以下命令：

lipo -info /path/to/your.framework/YourFramework

若输出仅包含单一架构（如arm64或x86_64），则说明架构不全是问题根源。

2. 修改xcodebuild命令，强制生成多架构模拟器框架 #

在原命令中添加ARCHS参数，指定同时生成x86_64和arm64架构：

/Applications/Xcode_14.0.1.app/Contents/Developer/usr/bin/xcodebuild build -workspace <workSpacePath> -configuration Release -sdk iphonesimulator -scheme <Scheme_name> -derivedDataPath <Derived_path> CODE_SIGNING_ALLOWED=NO ENABLE_BITCODE=YES BITCODE_GENERATION_MODE=bitcode SKIP_INSTALL=NO ARCHS="x86_64 arm64" VALID_ARCHS="x86_64 arm64"

3. 调整Podspec的架构配置 #

确保你的Podspec文件中明确声明支持的架构，避免编译时过滤掉必要架构：

s.pod_target_xcconfig = {
  'ARCHS[sdk=iphonesimulator*]' => 'x86_64 arm64',
  'VALID_ARCHS[sdk=iphonesimulator*]' => 'x86_64 arm64',
  'ARCHS[sdk=iphoneos*]' => 'arm64 armv7 armv7s',
  'VALID_ARCHS[sdk=iphoneos*]' => 'arm64 armv7 armv7s'
}

4. 清理缓存并重新集成 #

• 生成框架前，清理Xcode的DerivedData目录，或在xcodebuild命令中添加clean参数
• 应用端执行以下命令清理Pod缓存并重新集成：

pod deintegrate
pod cache clean --all
pod install

5. 统一Swift版本 #

确保框架使用的Swift版本与应用项目一致，可在Podspec中明确指定Swift版本：

s.swift_version = "5.7" # Xcode14对应的Swift版本为5.7，可根据实际情况调整

内容的提问来源于stack exchange，提问作者John