在Xcode中构建Flutter应用时出现‘Flutter.h not found’错误

以下是针对该问题的额外排查和修复步骤：

1. 检查Flutter SDK路径配置 #

• 打开Xcode，进入项目的Build Settings，搜索Header Search Paths
• 确保包含Flutter头文件路径，添加：

  $(FLUTTER_ROOT)/flutter/bin/cache/artifacts/engine/ios
  

  并设置为recursive（递归）

2. 清理缓存与构建产物 #

• 执行Flutter清理命令：

  flutter clean
  rm -rf ios/Pods
  rm ios/Podfile.lock
  rm -rf ~/Library/Developer/Xcode/DerivedData
  

• 重新安装pod：

  cd ios
  pod install --repo-update
  

3. 检查PluginRegistrant的引入方式 #

• 打开GeneratedPluginRegistrant.m文件，确认顶部引入语句为：

  #import <Flutter/Flutter.h>
  

  避免使用相对路径引入，若手动修改过文件，可能导致路径错误

4. 验证Flutter SDK完整性 #

• 执行命令检查SDK状态：

  flutter doctor -v
  

  确保iOS相关配置无报错，若SDK损坏，重新下载安装Flutter SDK

5. 第三方插件版本适配 #

• 针对sqflite、geolocator、permission_handler这类插件，尝试指定稳定版本：
  修改pubspec.yaml中的版本号示例：

  sqflite: ^2.3.0
  geolocator: ^10.1.0
  permission_handler: ^10.2.0
  

• 更新依赖后重新执行flutter pub get和pod install

6. 调整Xcode项目架构设置 #

• 在Xcode的Build Settings中搜索Architectures，设置为Standard Architectures (arm64, x86_64)
• 关闭Build Active Architecture Only（Debug模式可保留开启，Release建议关闭）

内容的提问来源于stack exchange，提问作者Çağlar Binici