Flutter项目误删XCode中Copy Bundle Resources资源的解决求助

1. 彻底重置Flutter iOS项目配置 #

先清理所有缓存和旧配置，让Flutter重新生成iOS项目的默认资源配置：

• 执行以下命令清理缓存：

  flutter clean
  rm -rf ios/Pods ios/Podfile.lock ios/Runner.xcworkspace
  

• 重新拉取依赖并生成iOS项目文件：

  flutter pub get
  cd ios && pod install --repo-update
  cd ..
  flutter build ios --no-codesign
  

  这一步会让Flutter自动恢复Copy Bundle Resources里的默认资源项。

2. 修复Cycle error循环依赖问题 #

手动加bundle出现循环错误，基本是资源被重复引用或依赖链闭环导致的：

• 打开XCode，进入Runner项目的Build Phases标签页
• 在Copy Bundle Resources里删掉所有手动添加的bundle文件
• 检查Compile Sources和Link Binary With Libraries，确保bundle文件没被误加到这两个阶段
• 自定义bundle的话，只给它勾选Runner的Target Membership，不要让它依赖其他会被打包的资源

3. 手动补全必要资源项 #

如果重置后Copy Bundle Resources还是空的，手动添加以下核心资源：

• Runner/Info.plist
• Runner/Assets.xcassets
• Flutter/Flutter.framework/flutter_assets（找到Flutter框架下的这个文件夹，添加进来）
• 你的自定义资源文件（比如图片、本地json等），注意不要重复添加

4. 验证修复效果 #

• 关掉XCode，重新打开Runner.xcworkspace（别打开.xcodeproj）
• 执行Product > Clean Build Folder（快捷键Cmd+Shift+K）
• 重新构建项目，检查是否还有资源缺失或循环错误

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