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

Flutter升级后iOS构建报错:'Flutter/Flutter.h'文件未找到

解决Flutter升级后webview_flutter-1.0.7找不到'Flutter/Flutter.h'的问题

我之前也碰到过类似插件版本和Flutter新版本不兼容导致的iOS构建失败问题,结合你的情况,给你几个可行的解决方案:

方案一:升级webview_flutter到兼容版本

webview_flutter 1.0.7是比较老旧的版本,大概率和你使用的Flutter master通道版本(1.26.0-2.0.pre.157)不兼容。你可以直接升级插件:

  • 打开项目根目录的pubspec.yaml文件,找到webview_flutter的依赖行,把版本改成**^2.0.0**或更高(建议使用当前最新稳定版),比如:
    dependencies:
      webview_flutter: ^2.8.0
    
  • 执行命令flutter pub get更新依赖
  • 进入iOS目录,执行pod deintegrate && pod install重新安装Pods

方案二:手动添加Flutter头文件路径到Xcode

如果暂时不想升级插件,可以尝试手动指定头文件路径:

  • 打开iOS项目的Runner.xcworkspace
  • 在左侧导航栏选中Runner target,切换到Build Settings标签页
  • 搜索Header Search Paths,点击添加按钮,输入$(FLUTTER_ROOT)/flutter/bin/cache/artifacts/engine/ios,并设置为recursive
  • 执行flutter clean,然后重新构建项目

方案三:清理pub缓存并重新下载插件

有时候旧版本的插件缓存会导致问题,尝试彻底清理后重新获取:

  • 执行命令删除旧版本插件缓存:
    rm -rf ~/.pub-cache/hosted/pub.dartlang.org/webview_flutter-1.0.7
    
  • 回到项目根目录执行flutter pub get
  • 进入iOS目录执行pod install后再尝试构建

补充说明

你切换到stable通道后没解决问题,可能是因为pub缓存里的旧插件版本还在,或者Pods没有彻底重新安装。可以在切换通道后,再执行一次flutter clean、flutter pub get和pod deintegrate && pod install,确保所有依赖都是对应通道的兼容版本。

内容的提问来源于stack exchange,提问作者Victor Lagunas

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.11 08:10:49