Xcode打包Flutter应用报错：Module 'cloud_firestore' not found

问题描述 #

通过Xcode打包归档或直接构建Flutter应用时，报错GeneratedPluginRegistrant.m中找不到Module 'cloud_firestore'，但终端执行flutter build ipa可正常生成归档，Android Studio中运行无异常。已尝试删除Podfile、Podfile.lock，执行pod update、pod install，更新部署目标均无效。当前Podfile内容如下：

# Uncomment this line to define a global platform for your project
# platform :ios, '11.0'

# CocoaPods analytics sends network stats synchronously affecting flutter build latency.
ENV['COCOAPODS_DISABLE_STATS'] = 'true'

project 'Runner', {
  'Debug' => :debug,
  'Profile' => :release,
  'Release' => :release,
}

def flutter_root
  generated_xcode_build_settings_path = File.expand_path(File.join('..', 'Flutter', 'Generated.xcconfig'), __FILE__)
  unless File.exist?(generated_xcode_build_settings_path)
    raise "#{generated_xcode_build_settings_path} must exist. If you're running pod install manually, make sure flutter pub get is executed first"
  end

  File.foreach(generated_xcode_build_settings_path) do |line|
    matches = line.match(/FLUTTER_ROOT\=(.*)/)
    return matches[1].strip if matches
  end
  raise "FLUTTER_ROOT not found in #{generated_xcode_build_settings_path}. Try deleting Generated.xcconfig, then run flutter pub get"
end

require File.expand_path(File.join('packages', 'flutter_tools', 'bin', 'podhelper'), flutter_root)

flutter_ios_podfile_setup

target 'Runner' do
  pod 'FirebaseFirestore', :git => 'https://github.com/invertase/firestore-ios-sdk-frameworks.git', :tag => '10.0.0'
  use_frameworks!
  use_modular_headers!

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
  end
end

解决方案 #

1. 匹配Flutter插件与iOS SDK版本 #

检查pubspec.yaml中cloud_firestore的版本，确保其与手动指定的FirebaseFirestore iOS SDK版本（10.0.0）兼容。参考插件官方文档确认版本对应关系，避免版本不匹配导致模块引用失败。

2. 调整Podfile配置顺序 #

将框架声明与Flutter pod安装的顺序调换，手动添加的Firebase pod放在Flutter pod安装之后：

target 'Runner' do
  use_frameworks!
  use_modular_headers!

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
  pod 'FirebaseFirestore', :git => 'https://github.com/invertase/firestore-ios-sdk-frameworks.git', :tag => '10.0.0'
end

Flutter的podhelper会自动处理插件依赖，此顺序可避免手动添加的pod与自动生成的依赖冲突。

3. 彻底清理构建缓存 #

• 关闭Xcode，执行Flutter侧清理：

  flutter clean
  flutter pub get
  

• 进入iOS目录，清理Pods并重新安装：

  cd ios
  rm -rf Pods Podfile.lock
  pod deintegrate
  pod install
  

• 打开Xcode，执行Product > Clean Build Folder（快捷键Cmd+Shift+K）后再尝试构建。

4. 检查Xcode项目构建配置 #

• 打开Runner target的Build Settings，搜索Framework Search Paths，确保包含$(inherited)和$(PROJECT_DIR)/Pods/FirebaseFirestore/Frameworks；
• 搜索Other Linker Flags，确认包含$(inherited)。

5. 重新生成Xcode项目配置 #

执行命令让Flutter重新生成iOS项目文件，覆盖可能出错的配置：

flutter create --platforms ios .

此操作不会删除自定义配置（如Info.plist），完成后重新执行pod install。

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