升级Xcode13后Flutter iOS真机运行报'Flutter/Flutter.h' not found错误
问题核心原因
升级Xcode13后出现的构建失败核心触发点为下方报错:
fatal error: 'Flutter/Flutter.h' file not found
该问题是旧版本Flutter SDK、旧版Flutter插件与Xcode13新构建系统不兼容,导致Flutter相关头文件引用路径失效导致,可按以下步骤依次排查解决:
修复步骤
第一步:升级兼容Xcode13的依赖版本
你当前使用的path_provider 1.6.28版本未适配Xcode13,先将pubspec.yaml中path_provider依赖升级至2.0.11及以上版本,执行命令:flutter pub upgrade path_provider第二步:清理本地缓存与旧构建产物
依次执行以下命令清理冗余缓存:
flutter clean rm -rf ios/Pods ios/Podfile.lock ios/Runner.xcworkspace flutter pub get
- 第三步:重新生成iOS依赖配置
进入ios目录执行pod重置命令:
cd ios pod deintegrate pod install
- 第四步:修正Xcode构建设置
打开ios目录下的Runner.xcworkspace文件,进入项目Build Settings配置页:
- 搜索
Excluded Architectures,在Debug和Release配置下,对模拟器SDK添加排除架构arm64 - 搜索
iOS Deployment Target,将最低支持版本调整为12.0及以上,与第三方插件的最低支持版本对齐
- 第五步:重置Flutter项目配置
在项目根目录执行以下命令,重新生成Flutter默认的iOS端配置,不会覆盖已有业务代码与签名配置:flutter create .
如果上述步骤执行完成后仍然报错,将Flutter稳定版升级至2.5.3及以上版本即可,低于2.5的Flutter版本官方未适配Xcode13,执行命令flutter upgrade即可升级。
内容的提问来源于stack exchange,提问作者DaegilPyo
相关产品推荐
相关产品推荐

