iOS 18运行Flutter应用报'Flutter/Flutter.h'文件未找到错误

问题详情 #

在iOS 18模拟器（iPhone 13 Mini）运行Flutter应用时，编译报错Flutter/Flutter.h' file not found，错误集中在webview_flutter_wkwebview-3.15.0依赖包的头文件中。当前环境版本：

• webview_flutter 4.9.0
• Flutter 3.24.3（stable通道）
• Xcode 16.0
• macOS 15.0

已执行以下清理操作但未解决：

rm Podfile.lock
pod cache clear --all
pod deintegrate
flutter clean
flutter pub get
pod install

可行解决方案 #

1. 修正Podfile配置 #

打开iOS目录下的Podfile，确认target 'Runner' do代码块内包含Flutter的pod安装指令：

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

保存后重新执行：

cd ios && pod install

2. 升级CocoaPods #

CocoaPods 1.15.2与Xcode 16.0存在兼容性问题，升级到最新稳定版：

sudo gem install cocoapods

之后重新执行完整的清理安装流程：

flutter clean
flutter pub get
cd ios && pod deintegrate && pod install

3. 重建webview_flutter_wkwebview依赖 #

直接删除本地缓存的有问题的依赖包，重新拉取：

rm -rf ~/.pub-cache/hosted/pub.dev/webview_flutter_wkwebview-3.15.0
flutter pub get
cd ios && pod install

4. Xcode中手动配置头文件路径 #

打开ios/Runner.xcworkspace，按以下步骤操作：

• 选中Runner target，进入Build Settings标签页
• 搜索Header Search Paths
• 添加两个路径：$(inherited) 和 ${FLUTTER_FRAMEWORK_DIR}/Headers，并设置为recursive
• 点击Build重新编译项目

5. 调整webview_flutter版本 #

尝试切换到与当前Flutter版本更兼容的webview_flutter版本，修改pubspec.yaml：

dependencies:
  webview_flutter: ^4.8.0

执行更新：

flutter pub get
cd ios && pod install

6. 切换Flutter通道测试 #

若以上方法无效，尝试切换到beta通道获取更适配Xcode 16的版本：

flutter channel beta
flutter upgrade
flutter clean
flutter pub get
cd ios && pod install

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