Xcodebuild归档生成XCFramework失败：SwiftEmitModule arm64模块编译出错

排查与修复步骤 #

1. 确保依赖Framework的可分发配置 #

• 所有被依赖的Framework必须开启BUILD_LIBRARY_FOR_DISTRIBUTION=YES，且归档时需携带该参数。若依赖框架未按可分发标准构建，主框架在执行SwiftEmitModule时会失败。
• 先单独归档每个依赖框架，命令示例：

  xcodebuild archive \
    -scheme 依赖框架名称 \
    -sdk iphoneos \
    -archivePath "archives/依赖框架_ios_devices.xcarchive" \
    BUILD_LIBRARY_FOR_DISTRIBUTION=YES \
    SKIP_INSTALL=NO
  

2. 统一Swift编译配置 #

• 检查主框架目标的Swift编译设置：
  • 确认Module Stability已启用（对应命令行的BUILD_LIBRARY_FOR_DISTRIBUTION=YES，需保证项目内配置与命令参数一致）。
  • 确保主框架与所有依赖框架的Swift Language Version完全统一，版本不兼容会导致模块编译失败。

3. 清理构建缓存后重试 #

• 删除Xcode派生数据和本地归档目录，避免缓存干扰：

  rm -rf ~/Library/Developer/Xcode/DerivedData
  rm -rf archives/
  

  之后重新执行原归档命令。

4. 验证依赖集成方式 #

• 若依赖通过CocoaPods引入：执行pod install更新依赖，确认Podfile中无冲突配置（比如错误的use_frameworks!变体）。
• 若依赖通过Swift Package Manager引入：确认依赖的版本/分支稳定，本地已拉取最新代码。

5. 查看详细日志定位具体错误 #

• 在归档命令后添加-verbose参数，获取完整编译日志，精准定位SwiftEmitModule失败的具体原因（如类型不兼容、未定义符号等）：

  xcodebuild archive \
    -scheme XXXX \
    -sdk iphoneos \
    -archivePath "archives/ios_devices.xcarchive" \
    BUILD_LIBRARY_FOR_DISTRIBUTION=YES \
    SKIP_INSTALL=NO \
    -verbose
  

  根据日志中的具体错误提示修复代码或配置。

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