Flutter iOS で Firebase ビルドが失敗する原因の切り分け（Xcode/SDK世代不一致） / PaPut

mizulba

8日前

Flutter iOS で Firebase ビルドが失敗する原因の切り分け（Xcode/SDK世代不一致）

Flutter

iOS

Firebase

ビルド・依存管理

FlutterFire (firebase_core, cloud_firestore など) の iOS ビルドで Swift compiler エラーや Undefined symbol が出る場合、まず Xcode / Flutter / Firebase iOS SDK / FlutterFire の世代組み合わせを疑う。特に新しい Firebase iOS SDK 12系は Swift 6 前提の構文を含むため、古い Xcode (例: 15.0.1) ではコンパイルできない。根本対応は Xcode を要求世代へ上げること。逆に上げられない環境では FlutterFire パッケージ群を正式に互換世代へ下げる。SDK の個別固定や pub cache へのパッチは暫定回避策であり、リポジトリ管理外で消えるため恒久対応にはしない。