@capacitor-firebase/app

中文文档
8.6.0发布于 2026/10/31Apache-2.0TypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 6.3万

Android,iOS,和Web上的Firebase App的电容插件.

中文使用文档
文档目录26 节
  1. 使用大小写
  2. 兼容性
  3. 指南
  4. 安装
  5. 机器人
  6. iOS系统
  7. 配置
  8. 演示
  9. 使用量
  10. 获取应用程序名称
  11. 获取 Firebase 配置选项
  12. API 密码
  13. 获取Name ()
  14. 获取选项( )
  15. 接口
  16. 财务问题
  17. 此插件支持哪个平台 ?
  18. 在使用此插件之前, 是否需要配置什么 ?
  19. 什么信息会 getOptions 还我?
  20. IOS上的SwiftPM包身份相撞,我该如何修复??
  21. 这是正式的Firebase插件吗?
  22. 我能用这个插件吗? 有Ionic、React、Vue或Angular?
  23. 相关插件
  24. 通讯
  25. 更改日志
  26. 许可证

电容火基应用插件

非官方电容插件 火基地应用[^1]

使用大小写

Firebase App插件一般用于访问您应用程序的核心Firebase配置,例如:

  • 配置检查:在运行时读取Firebase配置选项,如API密钥,应用程序ID,以及项目ID等,以验证该app是否与正确的Firebase项目相连接.
  • 多环境应用:通过检查Google Cloud项目ID来区分中转和生产建设.
  • 调试屏幕: 在内部调试视图中显示 Firebase 项目细节, 如存储桶或数据库 URL等 .

兼容性

插件版本电容版本状态
8.x.x (英语)>=8.x.x积极支持
7.x.x (中文(简体) )7.x.x (中文(简体) )折旧
6.x.x (中文(简体) )6.x.x (中文(简体) )折旧
5.x.x (中文(简体) )5.x.x (中文(简体) )折旧
1.x.x (中文(简体) )4.x.x (中文(简体) )折旧

指南

安装

你可以用我们的 AI 辅助设置 以安装插件. 添加数据 超级技能 至您的 AI 工具,使用以下命令:

npx skills add capawesome-team/skills --skill capacitor-plugins

然后使用下列提示:

Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capacitor-firebase/app` plugin in my project.

如果你喜欢 手动设置,通过运行以下命令来安装插件,并遵循下面的平台特定指令:

npm install @capacitor-firebase/app firebase
npx cap sync

如果您还没有将 Firebase 添加到您的项目中(机器人 编号 : iOS系统 编号 : 网页) (中文(简体) ).

机器人

变量

如果需要, 您可以在您的应用程序中定义以下工程变量 variables.gradle 要更改依赖的默认版本的文件 :

  • $firebaseCommonVersion 版本 com.google.firebase:firebase-common (默认 : 22.0.1(中文(简体) )

如果您在工程中遇到其它插件的依赖性冲突, 这会有所帮助 .

iOS系统

Swift 软件包管理器

在您的 capacitor.config.json (或 capacitor.config.ts) 避免 SwiftPM 软件包识别相撞数字 :

{
  "experimental": {
    "ios": {
      "spm": {
        "packageOptions": {
          "@capacitor-firebase/app": {
            "symlink": true
          }
        }
      }
    }
  }
}

请注意目标 packageOptions 支持需要控制器 CLI 8.4.0+ (中文(简体) )。 。 。 .

配置

此插件不需要配置 .

演示

这里有一个实例: robingenz/电容器-火力基地-插座-demo

使用量

以下例子显示了如何获得Firebase应用名称及其配置选项.

获取应用程序名称

获取 Firebase 应用程序的独有名称 :

import { FirebaseApp } from '@capacitor-firebase/app';

const getName = async () => {
  const result = await FirebaseApp.getName();
};

获取 Firebase 配置选项

获取 Firebase app的配置选项, 如 API 密钥, 应用程序 ID, 以及工程 ID :

import { FirebaseApp } from '@capacitor-firebase/app';

const getOptions = async () => {
  const result = await FirebaseApp.getOptions();
};

API 密码

获取Name ()

getName() => Promise<GetNameResult>

获取这个应用程序的名称 .

回返情况: Promise<GetNameResult>

自: 0.1.0 (中文(简体) )


获取选项( )

getOptions() => Promise<GetOptionsResult>

获取此应用程序的配置选项 .

回返情况: Promise<GetOptionsResult>

自: 0.1.0 (中文(简体) )


接口

获取Name

Prop类型说明自兹
namestring此应用程序的独有名称.0.1.0 (中文(简体) )

获取可选结果

Prop类型说明自兹
apiKeystringAPI 密钥用于认证您的应用程序中的请求 .0.1.0 (中文(简体) )
applicationIdstringGoogle App ID 用于唯一识别一个应用程序实例.0.1.0 (中文(简体) )
databaseUrlstring数据库根 URL .0.1.0 (中文(简体) )
gcmSenderIdstring工程编号.0.1.0 (中文(简体) )
projectIdstring谷歌云项目ID.0.1.0 (中文(简体) )
storageBucketstring谷歌云存储桶名.0.1.0 (中文(简体) )

财务问题

此插件支持哪个平台 ?

该插件支持Android,iOS,和Web. 两者 getName() 财务报告和审定财务报表 getOptions() 可在所有三个平台上查阅.

在使用此插件之前, 是否需要配置什么 ?

不需要插件特定配置 。 然而,您必须先在您的项目中添加 Firebase 。 这个 安装 区域链接到Firebase为Android,iOS,和Web设置指令.

什么信息会 getOptions 还我?

这个 getOptions() 方法返回 Firebase app的配置选项:用于认证请求的 API 密钥, Google App ID, 数据库根 URL, 项目号, Google Cloud 项目 ID, 和 Google Cloud 存储桶名.

IOS上的SwiftPM包身份相撞,我该如何修复??

如果您使用 Swift 软件包管理器, 请添加 symlink 软件包选项 @capacitor-firebase/app 切换到 安装 节。 说明SPM packageOptions 支持需要CLI 8.4.0或以后.

这是正式的Firebase插件吗?

不,这是Firebase App SDK的非官方电容插件. 该项目不附属于Google有限责任公司或其任何子公司或子公司,也不由其认可、赞助或批准.

我能用这个插件吗? 有Ionic、React、Vue或Angular?

是的,插件是框架不可知的。 它在任意网络框架的Capacitor app中工作,包括有Angular,React,或Vue的Ionic,以及平版JavaScript等项目.

通讯

随时更新有关卡帕韦索姆、Capacitor和Ionic生态系统的最新消息和最新消息,因为我们 《卡帕索克通讯》。 。 。 .

更改日志

见 变动情况。 。 。 .

许可证

见 自由主义。 。 。 .

[^1]: 这个项目不附属于Google LLC或其任何子公司或子公司,也不获得其认可、支持、赞助或批准.

版本与发布记录

@capacitor-firebase/app 共发布 51 个版本,首次发布于 2022/03/20;过去 12 个月发布了 13 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
8.6.0latest2026/10/319 天前
8.5.22026/09/171 个月前
8.5.12026/09/022 个月前
8.5.02026/08/312 个月前
8.4.02026/08/122 个月前
8.3.02026/06/045 个月前

其他发布通道:dev → 7.0.0-dev.1765887457。

关于 @capacitor-firebase/app 的常见问题

@capacitor-firebase/app 是什么?

Android,iOS,和Web上的Firebase App的电容插件.

如何安装 @capacitor-firebase/app?

在项目目录运行 npm install @capacitor-firebase/app,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@capacitor/core(>=8.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@capacitor-firebase/app 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@capacitor-firebase/app 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@capacitor-firebase/app 可以商用吗?

@capacitor-firebase/app 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@capacitor-firebase/app 的下载量有多少?

根据 npm 官方下载统计,@capacitor-firebase/app 在 2026/10/09 – 2026/11/07 这 30 天内被下载 63,318 次,日均约 2,111 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@capacitor-firebase/app 还在维护吗?

最新版本 8.6.0 发布于 2026/10/31(9 天前);至今共发布 51 个版本,其中过去 12 个月发布了 13 个;首次发布于 2022/03/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。