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

Pod Install自动安装WakeLock,归档构建遇'Flutter/Flutter.h'缺失问题

解决归档构建时wakelock插件的'Flutter/Flutter.h'未找到问题

你没在pubspec.yaml里直接引入wakelock,但它是项目中其他依赖的间接依赖,所以执行pod install时会被自动拉取安装。而'Flutter/Flutter.h'找不到的问题,通常和iOS端的pod配置、Flutter环境关联有关,以下是具体解决步骤:

  • 确认间接依赖来源
    执行flutter pub deps命令,查看完整依赖树,定位到哪个直接依赖引入了wakelock,明确依赖链后更方便排查潜在问题。

  • 清理iOS端缓存并重新配置

    1. 进入项目的iOS目录:cd ios
    2. 删除Podfile.lock文件:rm Podfile.lock
    3. 删除Pods文件夹:rm -rf Pods
    4. 清理Flutter全局缓存:flutter clean
    5. 重新获取Flutter依赖:flutter pub get
    6. 重新执行pod安装(M1/M2芯片用户需额外加架构参数):
      pod install
      # M1/M2芯片执行
      arch -x86_64 pod install
      
  • 检查Xcode关键配置

    1. 打开Xcode,选中项目目标,进入Build Settings
    2. 找到Header Search Paths,确保包含$(inherited)和${FLUTTER_ROOT}/Flutter,并设置为recursive
    3. 同样检查Framework Search Paths,确保包含$(inherited)和${FLUTTER_ROOT}/Flutter
  • 强制指定wakelock兼容版本
    如果间接依赖的wakelock版本和你的Flutter版本不兼容,可在pubspec.yaml中手动添加并指定稳定版本,覆盖间接依赖:

    dependencies:
      wakelock: ^0.6.2 # 选择适配你当前Flutter版本的稳定版
    

    执行flutter pub get和pod install后重新尝试构建。

  • 更新Flutter及依赖
    执行flutter upgrade升级到最新稳定版,再执行flutter pub upgrade更新所有依赖,之后重新执行pod安装和归档构建。

内容的提问来源于stack exchange,提问作者BC TUBE

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.25 04:22:07