CocoaPods引入vendored frameworks触发“Multiple commands produce”错误求助

问题原因 #

手动通过vendored_frameworks引入第三方xcframework时，CocoaPods会自动将框架的头文件（包括Swift自动生成的-Swift.h）纳入模块的构建流程，同时框架本身的构建脚本与Pod的构建逻辑冲突，导致重复生成头文件，触发编译错误。

具体解决步骤 #

1. 严格控制模块的公共头文件范围

在你的模块podspec中，只将自己模块的头文件设为公共头，排除第三方框架的所有头文件，避免CocoaPods误处理：

# 仅指定你的模块自身的头文件
s.public_header_files = 'ios/Classes/**/*.h'
# 排除第三方框架的所有文件，防止被自动纳入构建
s.exclude_files = 'Frameworks/**/*'

2. 通过Post Install钩子调整框架构建配置

在项目的Podfile中添加post_install钩子，禁止第三方框架被重复安装，并调整Swift头文件生成逻辑：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    # 处理你的Expo模块目标
    if target.name == 'EnquraModule'
      target.build_configurations.each do |config|
        # 禁止自动生成Swift头文件（仅针对第三方框架的Swift头冲突）
        config.build_settings['SWIFT_INSTALL_OBJC_HEADER'] = 'NO'
        # 强制指定模块自身的Swift头文件名（可选，避免与第三方混淆）
        config.build_settings['OBJC_SWIFT_HEADER_NAME'] = 'EnquraModule-Swift.h'
      end
    end

    # 标记第三方xcframework为不安装到公共目录，避免重复引用
    if ['EnQualify', 'IDVerification_arm64'].include?(target.name)
      target.build_configurations.each do |config|
        config.build_settings['SKIP_INSTALL'] = 'YES'
      end
    end
  end
end

3. 确保xcframework架构兼容性

如果IDVerification_arm64.xcframework仅包含真机arm64架构，开发时模拟器会触发额外的构建逻辑，可能加剧重复问题。建议：

• 替换为支持多架构（真机+模拟器）的xcframework
• 或在podspec中根据平台动态指定框架：

if ENV['PLATFORM_NAME'] == 'iphonesimulator'
  s.vendored_frameworks = 'Frameworks/IDVerification_sim.xcframework', 'Frameworks/EnQualify.xcframework'
else
  s.vendored_frameworks = 'Frameworks/IDVerification_arm64.xcframework', 'Frameworks/EnQualify.xcframework'
end

4. 清理缓存并重新构建

执行以下步骤彻底清理缓存，避免旧配置干扰：

1. 删除项目根目录下的Podfile.lock文件
2. 删除Pods目录
3. 运行终端命令：pod deintegrate
4. 重新执行：pod install
5. 在Xcode中按下Cmd+Shift+K清理构建，再按Cmd+Option+Shift+K清理构建文件夹

补充说明 #

关于依赖方式引入时的Alamofire符号找不到问题，本质是Swift版本不兼容：第三方框架EnVerify使用的Swift版本与你的项目或Alamofire的Swift版本不一致，导致运行时符号不匹配。手动引入框架并解决编译错误后，可自行管理Alamofire的版本与Swift版本，避免该问题。

内容的提问来源于stack exchange，提问作者Olcay Ertaş