在Xcode 14.2中运行Flutter应用失败，寻求解决方案

环境信息 #

• 设备：Apple Mini(M1)
• macOS：13.0.1
• Flutter版本：3.3.10（稳定通道）
• Xcode版本：14.2
• 报错信息：
  • 无法为桥接头文件/Users/user/Documents/develop/my_project/ios/Runner/Runner-Bridging-Header.h生成预编译头
  • GeneratedPluginRegistrant.h第10行提示找不到Flutter/Flutter.h

已尝试的修复命令：

flutter clean 
flutter pub get 
cd ios
pod install
pod repo update
rm -Rf Flutter\flutter.podspec
pod install

可行解决方案 #

1. 用Rosetta执行CocoaPods（M1设备专属） #

M1芯片的架构兼容性问题可能导致Pod依赖引用异常，执行以下命令重新安装依赖：

flutter clean
flutter pub get
cd ios
# 用Rosetta模式运行pod install
arch -x86_64 pod install

2. 清理Xcode派生数据与Flutter缓存 #

Xcode的缓存文件可能导致编译异常，执行以下命令清理：

# 删除Xcode派生数据
rm -rf ~/Library/Developer/Xcode/DerivedData
# 删除Flutter pub缓存
rm -rf ~/.pub-cache
# 重新初始化项目
flutter clean
flutter pub get
cd ios
pod install

3. 修正Xcode架构配置 #

1. 打开项目的ios/Runner.xcworkspace
2. 选中Runner目标，进入Build Settings标签页
3. 搜索Architectures：
   • 设置Architectures为Standard Architectures (arm64, x86_64)
   • 在Excluded Architectures的Debug配置中添加x86_64（仅M1设备）
4. 搜索Valid Architectures，确保包含arm64

4. 检查桥接头文件路径配置 #

1. 在Xcode的Runner目标Build Settings中搜索Objective-C Bridging Header
2. 将路径修改为相对路径，例如Runner/Runner-Bridging-Header.h（避免使用绝对路径）
3. 打开桥接头文件，检查是否存在错误的import语句或拼写错误

5. 更新Flutter与CocoaPods版本 #

旧版本可能存在Xcode14.2的兼容性问题：

# 更新Flutter到最新稳定版
flutter upgrade
# 更新CocoaPods
sudo gem install cocoapods

内容的提问来源于stack exchange，提问作者DAVI OLIVEIRA TEIXEIRA