Delphi构建iOS应用Firebase9+编译报错：找不到FBLPromises框架

一、Firebase 9.0.0 引发问题的核心变更 #

• 模块化架构拆分：Firebase 9 彻底抛弃旧版单体架构，将核心组件拆分为独立模块。原FirebaseCore依赖的FBLPromises、心跳控制模块等不再内置，需手动引入对应依赖框架。
• 内部类拆分：FIRHeartbeatController在Firebase 8.x中属于FirebaseCore内部实现，9.0.0版本将其剥离到FirebaseCoreInternal独立框架中，未引入该框架就会出现符号未定义错误。
• 自动链接失效：苹果的自动链接机制无法适配Delphi项目的跨框架依赖识别逻辑，导致FBLPromises这类附属框架无法被自动关联。

二、可行解决方案 #

1. 补全依赖框架引用 #

从Firebase官方下载对应版本iOS SDK后，除原有主框架外，需手动添加以下框架到Delphi项目的iOS平台框架引用中：

• FBLPromises.framework
• FirebaseCoreInternal.framework
  确保所有框架的路径配置正确，且被项目正确识别。

2. 调整链接器参数 #

在Delphi项目的iOS平台 > 链接器设置中，将其他链接器选项修改为：

-ObjC -lz -framework FBLPromises -framework FirebaseCoreInternal

补充的-lz用于链接zlib库（部分Firebase模块依赖），-framework参数强制指定链接目标框架，解决自动链接失效问题。

3. 验证框架架构兼容性 #

使用终端命令检查引入的框架是否包含arm64架构（适配iOS设备）：

lipo -info 你的框架路径/FBLPromises.framework/FBLPromises

若输出不包含arm64，需重新下载完整的Firebase iOS SDK，或用lipo命令合并所需架构。

4. 清理缓存重建项目 #

删除项目的Build目录和iOS部署缓存，重新编译部署，避免旧缓存导致的依赖冲突。

内容的提问来源于stack exchange，提问作者zeus