Xcode项目CocoaPods集成Firebase时FIRAppInternal.h头文件缺失报错

• 运行环境：Xcode 13.4.1、CocoaPods 1.11.3
• 触发场景：将Xcode项目依赖库更新至最新版本后构建失败
• 报错内容：

'FirebaseCore/FIRAppInternal.h' file not found
Did not find header 'FIRAppInternal.h' in framework 'FirebaseCore'

• 报错位置：FirebaseInAppMessaging 库下的 FIRInAppMessaging.m 文件
• 已尝试操作：全量清理CocoaPods缓存、Xcode派生数据、项目Pods目录、Podfile.lock文件，重启Mac后重新构建，问题仍复现
• 当前Podfile配置：

# Uncomment the next line to define a global platform for your project
platform :ios, '13.0'

target 'la soundbox' do
  # Comment the next line if you're not using Swift and don't want to use dynamic frameworks
  use_frameworks!

  pod 'FirebaseCore'
  pod 'FirebaseFirestore'
  pod 'FirebaseAuth'
  pod 'FirebaseMessaging'
  pod 'FirebaseInAppMessaging'
  pod 'FirebaseAnalytics'
  pod 'FirebaseCrashlytics'
  pod 'FirebaseRemoteConfig'
  pod 'Google-Mobile-Ads-SDK'

end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings.delete 'IPHONEOS_DEPLOYMENT_TARGET'
    end
  end
end

• 原有清理流程：
  1. 清空项目Build文件夹
  2. 退出Xcode
  3. 执行以下清理命令：

  rm -rf ~/Library/Caches/CocoaPods 
  rm -rf ~/Library/Developer/Xcode/DerivedData/* 
  rm -rf /path_to_project/Pods 
  rm /path_to_project/Podfile.lock
  

  4. 重启Mac
  5. 打开Xcode执行构建

按顺序尝试以下操作，每步完成后重新执行pod install再构建验证：

• 修复post_install脚本逻辑
  现有脚本直接删除所有依赖库的部署目标配置，会导致Firebase系列库的头文件搜索路径配置异常。将原有post_install块替换为如下内容，统一给所有依赖设置和主项目一致的最低部署版本，同时开启非模块化头文件引入权限：

  post_install do |installer|
    installer.pods_project.targets.each do |target|
      target.build_configurations.each do |config|
        config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '13.0'
        config.build_settings['CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES'] = 'YES'
      end
    end
  end
  

• 锁定Firebase依赖版本
  不指定版本直接拉取最新依赖时，容易出现Firebase各子库版本不兼容的问题，且Firebase 10.0及以上版本仅支持Xcode 14+编译，在Xcode 13环境下会出现头文件缺失的报错。在Podfile中platform :ios, '13.0'下方添加版本约束，锁定兼容的稳定版本：

  pod 'Firebase', '~> 9.6.0'
  

  添加后执行pod install --repo-update更新本地依赖源后重新安装。

• 调整框架链接方式
  如果以上操作后仍报错，将target块内的use_frameworks!替换为静态链接模式，Firebase部分组件在动态框架模式下偶现头文件索引失败问题：

  use_frameworks! :linkage => :static
  

  其余依赖配置保持不变即可。

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