Flutter项目Xcode归档报错“Cycle inside Runner”如何解决？

以下是针对VSCode运行正常但Xcode归档报错的遗漏步骤排查：

• 先同步Flutter与Xcode的基础配置
  终端依次执行：

  flutter clean
  flutter pub get
  flutter build ios --release
  

  先通过命令行构建release包，能更早暴露依赖或编译层面的问题，比Xcode的报错更清晰。

• 核对签名与开发者账号配置

  • 打开Xcode的Runner项目，进入Signing & Capabilities页，确认Team选的是你的Apple Developer账号，且「Automatically manage signing」已勾选。
  • 检查Bundle Identifier和开发者后台的App ID完全一致，别写错大小写或符号。
  • 去Xcode偏好设置→Accounts→选中你的账号，点击「Download Manual Profiles」，确保拉取到最新的配置文件。

• 调整Xcode编译架构设置

  • 进入Runner的Build Settings，搜索Architectures，设置为Standard Architectures (arm64)，移除armv7相关配置。
  • 搜索Build Active Architecture Only，Release模式必须设为No，避免归档时只编译当前设备的架构。
  • 检查Other Linker Flags，确保是$(inherited) -ObjC，多余的参数可能导致链接错误。

• 排查第三方插件兼容性

  • 暂时注释掉非核心的第三方插件，重新尝试归档，逐步定位出有问题的插件。
  • 用flutter pub outdated查看过时依赖，把插件更新到最新兼容版本。

• 重置Xcode缓存

  • 执行Xcode菜单的Product → Clean Build Folder（快捷键Shift+Command+K），然后重启Xcode。
  • 删除Derived Data：打开Xcode偏好设置→Locations→点击Derived Data路径的箭头，删除对应项目的缓存文件夹。

• 升级或切换Flutter版本
  运行flutter upgrade升级到最新稳定版，若当前是beta/dev分支，切换回stable分支再试：

  flutter channel stable
  flutter upgrade
  

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