如何在Xcode 13.4中手动导入Firebase框架

API 探路者

2026-7-12

手动导入Firebase XCFramework后Swift模块找不到的解决方法

检查完整依赖链
Firebase多数库存在依赖关系，比如FirebaseMessaging就依赖FirebaseCore、FirebaseInstallations、GoogleUtilities、nanopb、PromisesObjC这些XCFramework。你需要确保所有关联的依赖库都已导入项目，且版本和主库匹配。下载的Firebase压缩包中，每个库的文件夹里通常会标注所需依赖，逐一核对补充。
配置Framework搜索路径
打开项目Build Settings，搜索Framework Search Paths，将存放XCFramework的文件夹路径（比如你用的frameworks文件夹）添加进去，设置为recursive（递归搜索）。同时要确认：拖入文件夹时勾选了Copy items if needed，且每个XCFramework都已添加到target的Frameworks, Libraries, and Embedded Content列表中，Embed选项设置为Embed & Sign（iOS项目）或对应平台的正确选项。
关于firebase.h的作用
firebase.h是Objective-C的统一头文件，用于批量导入Firebase的OC库。如果你的项目是纯Swift项目，完全不需要理会这个文件；如果项目包含OC代码，或者需要通过Swift调用OC实现的Firebase API，只需在项目的桥接头文件（Bridging-Header.h）中添加#import "firebase.h"即可，不用单独处理这个文件本身。
排查部分模块无法识别的问题
对比能正常识别的模块（比如FirebaseCore），检查FirebaseMessaging这类无法识别的库：确认它的XCFramework已正确加入target的Embedded列表，依赖的所有子库都已导入。另外，Xcode缓存可能导致异常，试试执行Cmd+Shift+Option+K清理编译文件夹，然后重启Xcode再重新编译。
确认架构匹配
确保下载的Firebase XCFramework支持你项目的目标架构，比如iOS项目需要同时包含真机（arm64）和模拟器（x86_64）架构的版本。如果下载的是特定平台的精简版本，可能会出现部分环境下找不到模块的问题。