iOS构建Flutter应用时出现Error (Xcode): No such file or directory: 'WebKit'错误求助

1. 重新添加WebKit框架到Xcode项目 #

• 打开iOS项目的Runner.xcworkspace
• 左侧导航栏选中Runner目标，切换到Build Phases标签
• 展开Link Binary With Libraries，点击+按钮，搜索WebKit.framework并添加；如果已存在，先移除再重新添加，确保框架路径正确

2. 清理Flutter与Xcode缓存 #

• 执行Flutter清理命令：

  flutter clean
  flutter pub get
  

• 关闭Xcode，删除以下缓存文件/目录：
  • ~/Library/Developer/Xcode/DerivedData
  • 项目根目录下的ios/Pods文件夹和Podfile.lock文件
• 重新安装Pods：

  cd ios
  pod deintegrate
  pod install
  

3. 排查插件依赖冲突 #

• google_ml_kit和flutter_mobile_vision可能存在依赖冲突，尤其是对WebKit的引用逻辑
• 暂时移除flutter_mobile_vision插件，重新构建项目，确认是否由该插件引发问题
• 若确认是插件问题，更新插件到最新版本，查看是否修复了Xcode15兼容问题

4. 调整Xcode构建配置 #

• 在Runner目标的Build Settings中，搜索Framework Search Paths
• 确保路径包含$(SDKROOT)/System/Library/Frameworks，缺失则手动添加
• 检查Other Linker Flags，确认无错误的WebKit路径引用

5. 切换测试环境验证 #

• 尝试使用iOS16模拟器构建，排查是否为iOS17模拟器的兼容性问题
• 条件允许的话，用真机测试，排除模拟器环境异常

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