Flutter iOS指定Firebase SDK 9.6.0后出现Xcode语义错误求助

问题根源 #

你使用的cloud_firestore:4.3.1插件依赖Firebase Firestore SDK的聚合查询（AggregateQuery）和count方法，但这些特性是在Firebase SDK 10.0.0及以上版本才新增的，你指定的9.6.0版本根本没有这些API，所以触发了未声明标识符、方法不存在的错误。

解决方案 #

步骤1：升级Firebase SDK版本 #

修改Podfile中的$FirebaseSDKVersion为兼容的版本，比如：

$FirebaseSDKVersion = '10.17.0'

（注：cloud_firestore:4.3.1要求Firebase SDK最低版本为10.0.0，选择更高的稳定版本更稳妥）

步骤2：清理缓存并重新安装依赖 #

执行以下命令彻底清理并重新构建依赖：

# 删除iOS端的Pods缓存
rm -rf ios/Pods ios/Podfile.lock
# 清理Flutter项目缓存
flutter clean
# 重新获取Flutter依赖
flutter pub get
# 进入iOS目录安装Pods
cd ios && pod install

步骤3：验证版本匹配（可选） #

如果仍有问题，可确认cloud_firestore插件的版本兼容要求，确保使用的Firebase SDK版本和插件版本严格匹配。

错误信息 #

Semantic Issue (Xcode): Use of undeclared identifier 'FIRAggregateQuery'
/Users/technology/.pub-cache/hosted/pub.dev/cloud_firestore-4.3.1/ios/Classes/FLTFirebaseFirestorePlugin.m:587:2


Semantic Issue (Xcode): Use of undeclared identifier 'aggregateQuery'
/Users/technology/.pub-cache/hosted/pub.dev/cloud_firestore-4.3.1/ios/Classes/FLTFirebaseFirestorePlugin.m:587:21


ARC Semantic Issue (Xcode): No visible @interface for 'FIRQuery' declares the selector 'count'
/Users/technology/.pub-cache/hosted/pub.dev/cloud_firestore-4.3.1/ios/Classes/FLTFirebaseFirestorePlugin.m:587:45


Semantic Issue (Xcode): Use of undeclared identifier 'aggregateQuery'
/Users/technology/.pub-cache/hosted/pub.dev/cloud_firestore-4.3.1/ios/Classes/FLTFirebaseFirestorePlugin.m:589:3

Podfile内容 #

# Uncomment this line to define a global platform for your project
$FirebaseSDKVersion = '9.6.0'

platform :ios, '15.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
  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

内容的提问来源于stack exchange，提问作者Gbenga B Ayannuga