You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Xcode编译Flutter应用提示xcode_backend.sh不存在该如何解决

Xcode构建Flutter项目xcode_backend.sh不存在报错解决方案

核心报错逻辑:Xcode执行构建阶段脚本时,未匹配到Flutter SDK对应路径下的xcode_backend.sh文件,按照以下步骤依次操作即可修复:

步骤1:清理项目缓存与Xcode派生数据

  • 先完全关闭Xcode,在Flutter项目根目录(pubspec.yaml所在目录)执行清理命令:
    flutter clean
  • 删除Xcode本地缓存的派生数据:
    rm -rf ~/Library/Developer/Xcode/DerivedData
  • 重新拉取项目依赖:
    flutter pub get
    完成后尝试重新打开Xcode构建,若仍报错继续下一步。

步骤2:修正Xcode构建脚本路径配置

  • 打开Xcode项目Runner.xcworkspace,左侧导航栏选中顶层Runner项目,切换到TARGETS下的Runner选项,点击「Build Phases」标签
  • 找到「Run Script」构建阶段,检查脚本内容,错误配置通常缺少$FLUTTER_ROOT变量前缀,将脚本内容修正为如下默认配置即可:
/bin/sh "$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh" build
/bin/sh "$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh" embed_and_thin
  • 若本地未配置FLUTTER_ROOT全局环境变量,也可直接替换为Flutter SDK本地绝对路径,示例:
/bin/sh "/Users/你的用户名/flutter/packages/flutter_tools/bin/xcode_backend.sh" build
/bin/sh "/Users/你的用户名/flutter/packages/flutter_tools/bin/xcode_backend.sh" embed_and_thin

修改后尝试重新构建,若仍报错继续下一步。

步骤3:确认Flutter环境变量配置

  • 打开终端对应Shell配置文件(zsh对应/.zshrc,bash对应/.bash_profile),确认存在Flutter路径配置,示例:
export FLUTTER_ROOT=/Users/你的用户名/flutter
export PATH=$FLUTTER_ROOT/bin:$PATH
  • 配置完成后执行source ~/.zshrc(zsh环境)或source ~/.bash_profile(bash环境)生效,执行echo $FLUTTER_ROOT确认路径输出正确后,重启Xcode重新构建。

步骤4:重新生成iOS构建配置

  • 若以上步骤均无效,删除ios目录下的Runner.xcworkspace、Podfile.lock、Pods文件夹
  • 在项目根目录执行命令重新生成iOS构建配置(不会覆盖已开发的原生业务代码):
    flutter create .
  • 执行cd ios && pod install安装iOS依赖,完成后重新打开Xcode构建即可。

内容的提问来源于stack exchange,提问作者Rogerant Tshibangu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.25 02:54:02