Flutter iOS构建报错：'FirebaseCore/FirebaseCore.h'文件未找到

问题现象 #

开发Flutter iOS应用时出现机型兼容性问题：

• iPhone X 可正常归档构建
• iPhone 11及以上机型（测试用iPhone 14 Pro Max模拟器）构建失败，触发以下报错：
  1. 'FirebaseCore/FirebaseCore.h' file not found
  2. AppDelegate.swift:3:8 Could not build Objective-C module 'Firebase'

已尝试的修复操作 #

• 清理Xcode构建文件夹
• 退出Xcode，删除~/Library/Developer/Xcode/DerivedData下的项目临时文件
• 删除ProjectName.xcworkspace文件
• 删除Podfile.lock文件和Pods文件夹
• 执行pod install
• 打开新生成的ProjectName.xcworkspace重新构建

当前环境版本 #

• Firebase SDK 10.7.0
• Xcode 14.3
• Flutter SDK: >=2.18.1 <3.0.0
• 测试模拟器：iPhone 14 Pro Max

可行修复方案 #

1. 调整Podfile架构配置 #

在项目ios/Podfile中添加架构兼容配置，确保适配新机型的arm64架构：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    target.build_configurations.each do |config|
      # 允许模拟器同时支持x86_64和arm64架构
      config.build_settings['ARCHS[sdk=iphonesimulator*]'] = 'x86_64 arm64'
      config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = ''
    end
  end
end

修改后重新执行pod install。

2. 修正Xcode架构排除设置 #

打开Xcode项目设置（Project -> Build Settings），搜索Excluded Architectures：

• 确保Debug和Release模式下，iphonesimulator对应的排除架构为空，不要包含arm64。

3. 升级依赖版本 #

当前使用的Flutter版本（<3.0.0）与Xcode 14.3存在兼容性风险：

• 升级Flutter至3.x稳定版，同步更新Firebase相关Flutter插件到兼容版本。

4. 检查AppDelegate初始化逻辑 #

确保AppDelegate.swift中Firebase导入和初始化正确：

import Firebase

override func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
  FirebaseApp.configure()
  GeneratedPluginRegistrant.register(with: self)
  return super.application(application, didFinishLaunchingWithOptions: launchOptions)
}

避免直接导入Objective-C头文件，使用Swift原生导入方式。

5. 升级CocoaPods版本 #

确保CocoaPods与Xcode 14.3兼容，执行命令升级：

sudo gem install cocoapods

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