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

如何解决Flutter iOS模拟器运行时Flutter Framework未找到错误?

解决Flutter iOS构建报错:ld: framework not found Flutter

以下是针对该问题的可行解决方案,按尝试优先级排序:

1. 修复Xcode项目的Framework搜索路径

  • 打开项目的ios/Runner.xcworkspace
  • 在左侧导航栏选中Runner target,切换到Build Settings标签页
  • 搜索Framework Search Paths,确保列表中包含以下两项:
    • $(inherited)
    • $(FLUTTER_FRAMEWORK_DIR)
  • 如果路径缺失,点击+号添加;若路径存在但无效,检查是否有拼写错误或路径指向异常

2. 重新生成iOS项目配置文件

如果项目的iOS配置文件已损坏,可尝试重置:

  • 备份ios/Runner目录下的自定义文件(如Info.plist、Assets.xcassets、自定义业务代码等)
  • 删除整个ios目录
  • 在项目根目录执行命令:
    flutter create --platforms ios .
    
  • 将备份的自定义文件恢复到新生成的ios/Runner目录中,注意不要覆盖自动生成的核心配置文件

3. 验证Flutter SDK配置

  • 执行flutter doctor检查SDK状态,确保没有路径错误或依赖缺失
  • 若SDK路径有变更,在Xcode的Build Settings中搜索FLUTTER_FRAMEWORK_DIR,确认其指向Flutter SDK的正确路径(通常为[你的Flutter SDK路径]/bin/cache/artifacts/engine/ios)
  • 执行flutter config查看当前配置,确保没有异常设置

4. 清理Xcode缓存并重新构建

  • 完全关闭Xcode
  • 删除Xcode的Derived Data:打开Xcode的Preferences -> Locations,点击Derived Data右侧的箭头打开目录,删除整个文件夹
  • 回到项目根目录,依次执行:
    flutter clean
    flutter pub get
    flutter run
    

注:报错中的Run Script和Thin Binary警告属于非致命问题,不会导致构建失败,可在解决核心框架问题后再处理(按提示添加输出依赖或取消"基于依赖分析"选项即可)。

内容的提问来源于stack exchange,提问作者Tuent Farst

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.06 08:05:35