运行Flutter应用时出现Xcode Swift编译器错误求助

错误现象 #

运行Flutter应用时出现以下Xcode Swift编译错误，无法在iPhone 14 Pro Max模拟器启动应用：

• Swift Compiler Error：不支持将桥接头文件与模块接口配合使用
• Uncategorized：SwiftDriver命令已抛出错误，但未返回非零退出码以标识失败
• Error：找不到__ObjC模块，路径指向Runner.private.swiftinterface和Runner.swiftinterface文件
• Error：无法验证'Runner'的模块接口，提示文本接口可能损坏

解决步骤 #

1. 清理缓存 #

• 清理Xcode衍生数据：
  执行命令：rm -rf ~/Library/Developer/Xcode/DerivedData
  或在Xcode中使用快捷键 Shift + Command + K 清理构建目录
• 清理Flutter项目缓存：
  执行命令：

  flutter clean
  flutter pub get
  

2. 关闭模块接口生成开关 #

这是桥接头文件与模块接口冲突的核心原因：

1. 在Flutter项目根目录执行 open ios/Runner.xcworkspace 打开iOS项目
2. 选中Runner目标，进入Build Settings标签页
3. 搜索Build Libraries for Distribution，将其值设置为NO

3. 检查桥接头文件配置 #

1. 在Build Settings中搜索Objective-C Bridging Header，确认路径正确（如Runner/Runner-Bridging-Header.h）
2. 打开桥接头文件，删除错误导入语句，只保留必要的Objective-C框架/头文件，例如：

   #import <UIKit/UIKit.h>
   

4. 验证版本兼容性 #

1. 在Build Settings中搜索Swift Language Version，设置为与Xcode兼容的版本（建议Swift 5.0及以上）
2. 确保Flutter版本与Xcode版本匹配（如Flutter 3.10+搭配Xcode 14.3+）

5. 重新构建 #

执行以下命令重新生成模拟器构建文件：

flutter build ios --simulator

若问题仍存在，可删除iOS目录下的Podfile.lock和Pods文件夹，执行pod install后再重复上述构建步骤。

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