Xcode中含Pods的Framework通过Aggregate Target编译失败求助

• 检查Podfile配置
  确保Framework Target在Podfile中正确声明，根据Pods兼容性选择use_frameworks!或use_modular_headers!，示例：

  target 'YourFramework' do
    use_frameworks!
    pod 'YourPod1'
    pod 'YourPod2'
  end
  

  执行pod install重新安装Pods，确保依赖关联正确。

• 调整Aggregate Target的编译脚本
  默认通用框架脚本可能未处理Pods依赖，替换为包含完整编译逻辑的脚本（替换YourFramework为你的Target名称）：

  FRAMEWORK_NAME="YourFramework"
  OUTPUT_DIR="${SRCROOT}/Build/Products/Universal"
  rm -rf "${OUTPUT_DIR}"
  mkdir -p "${OUTPUT_DIR}"
  
  # 编译真机版本
  xcodebuild -target "${FRAMEWORK_NAME}" ONLY_ACTIVE_ARCH=NO -configuration Release -sdk iphoneos BUILD_DIR="${SRCROOT}/Build" BUILD_ROOT="${SRCROOT}/Build" clean build
  # 编译模拟器版本
  xcodebuild -target "${FRAMEWORK_NAME}" ONLY_ACTIVE_ARCH=NO -configuration Release -sdk iphonesimulator BUILD_DIR="${SRCROOT}/Build" BUILD_ROOT="${SRCROOT}/Build" clean build
  
  # 合并架构
  cp -R "${SRCROOT}/Build/Release-iphoneos/${FRAMEWORK_NAME}.framework" "${OUTPUT_DIR}/"
  lipo -create "${SRCROOT}/Build/Release-iphoneos/${FRAMEWORK_NAME}.framework/${FRAMEWORK_NAME}" "${SRCROOT}/Build/Release-iphonesimulator/${FRAMEWORK_NAME}.framework/${FRAMEWORK_NAME}" -output "${OUTPUT_DIR}/${FRAMEWORK_NAME}.framework/${FRAMEWORK_NAME}"
  
  # 复制模拟器资源（忽略无资源的报错）
  cp -R "${SRCROOT}/Build/Release-iphonesimulator/${FRAMEWORK_NAME}.framework/Resources" "${OUTPUT_DIR}/${FRAMEWORK_NAME}.framework/" 2>/dev/null
  

• 修正Build Settings配置

  • 将Framework Target的Build Libraries for Distribution设为YES，提升模块化兼容性
  • 确认Other Linker Flags包含$(inherited)，保证Pods的链接标记被正确引入
  • 检查Framework Search Paths和Header Search Paths包含$(inherited)与${PODS_ROOT}/Headers/Public

• 排查具体编译错误
  打开Xcode的Report Navigator（Cmd+9）查看详细错误：

  • 若为符号找不到，检查Pods是否支持多架构，旧Pod可在Podfile中添加架构排除规则：

    post_install do |installer|
      installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|
          config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64'
        end
      end
    end
    

    执行pod install生效。

• 匹配Pods集成方式
  动态Framework需配合use_frameworks!让Pods也以动态框架集成；静态Framework则用use_modular_headers!或给单个Pods添加:modular_headers => true，确保Pods支持模块化引入。

内容的提问来源于stack exchange，提问作者saad.ios