MacOS下Ionic 4集成FCM插件报错‘Firebase.h’文件未找到求助
解决Ionic FCM插件iOS编译‘Firebase.h’ file not found问题
我之前开发Ionic推送功能时也碰到过完全一样的问题——Android端顺风顺水,iOS这边卡了好久才搞定,给你几个亲测有效的方案,按顺序试试:
1. 检查Xcode Header Search Paths配置
这是最常见的原因:Pod明明安装了,但Xcode找不到头文件
- 打开你的
APVS Área do Associado.xcworkspace,选中项目target - 进入Build Settings,搜索
Header Search Paths - 添加两个路径:
$(inherited)(设置为non-recursive即可)${PODS_ROOT}/Firebase/Core/Sources(设置为recursive)
- 清理项目(快捷键
Cmd+Shift+K),然后重新编译
2. 确认Cordova iOS与FCM插件版本兼容
你的Cordova iOS是5.1.0,部分新版FCM插件对这个版本支持不好:
- 先卸载当前FCM插件(假设你用的是主流的
cordova-plugin-fcm-with-dependecy-updated):cordova plugin remove cordova-plugin-fcm-with-dependecy-updated - 安装和Cordova iOS 5.x兼容的版本:
cordova plugin add cordova-plugin-fcm-with-dependecy-updated@7.1.0 - 重新执行
pod install后再编译
3. 彻底重置Pod依赖环境
有时候Pod缓存或配置残留会导致问题,彻底重来一次:
- 删除项目根目录下的
Pods文件夹、Podfile.lock文件,还有生成的.xcworkspace文件 - 移除并重新添加iOS平台:
cordova platform rm ios cordova platform add ios@5.1.0 - 重新执行
pod install,务必打开生成的.xcworkspace文件编译
4. 检查Xcode Build Phases的Embed Frameworks
确保Firebase框架被正确嵌入:
- 进入项目target的Build Phases,找到
Embed Frameworks选项 - 如果里面没有Firebase相关的framework(比如FirebaseCore.framework),点击
+按钮,从Pods/Products目录下添加对应的Firebase框架 - 勾选
Copy only when installing选项,然后重新编译
5. 更新Xcode到兼容版本
你当前用的Xcode 11.0在Catalina上有些已知的依赖问题,建议更新到Catalina支持的最高版本Xcode 11.7:
- 打开App Store搜索Xcode,下载更新对应版本
- 更新完成后重启Xcode,清理Derived Data(Xcode -> 设置 -> 位置 -> Derived Data,点击箭头打开文件夹删除所有内容),再重新编译
额外注意点
- 确保所有Cordova插件都是最新兼容版本,避免插件之间的依赖冲突
- 编译前一定要关闭Xcode,重新打开
.xcworkspace,有时候Xcode缓存会导致配置不生效
内容的提问来源于stack exchange,提问作者Jonathan Brambati
相关产品推荐
相关产品推荐

