Google 致力于为黑人社区推动种族平等。查看具体举措

安装 Firebase 扩展程序

您可以使用 Firebase 控制台或 Firebase CLI(命令行界面)安装(和管理)任何官方 Firebase 扩展程序。

请务必查看 Firebase CLI 和 Firebase 控制台支持的操作之间的差异


要安装或管理扩展程序,您必须拥有以下某个角色:Owner 或 EditorFirebase Admin

另外,要安装扩展程序,您的项目必须采用 Blaze(随用随付)方案。除了该扩展程序使用的资源所产生的任何费用外,您还需要为它所需的 Firebase 资源支付少量费用(通常约为 $0.01/月),即使没有使用此扩展程序也要支付。

准备工作

  1. 如果您尚未将 Firebase 添加到您的项目,请先添加。

  2. 如果尚未将项目升级到 Blaze(随用随付)方案,请先升级。

  3. 安装或更新到 Firebase CLI 的最新版本

  4. 记下您的 Firebase 项目 ID 或之前配置的项目别名。

    • 项目 ID - 从计算机上的任意位置运行 firebase projects:list
    • 项目别名 - 从本地应用目录运行 firebase use

第 1 步:查看扩展程序的相关详情

这是可选步骤,但我们强烈建议您执行此操作。

在安装 Firebase 扩展程序之前,我们建议您先查看该扩展程序的详细信息,包括:

  • 扩展程序的工作方式、任何预安装的任务以及扩展程序的相关详情
  • 一般标识信息和说明
  • 扩展程序的任务是否需要结算帐号
  • 执行操作所需的 Google 服务 (API) 和访问角色
  • 为扩展程序创建的资源(如函数)
  • 用户可配置参数的说明

要查看扩展程序的详细信息,请执行以下操作

  1. 请确保您已设置环境选择了某个扩展程序

  2. 从计算机上的任意位置运行 extension-info 命令:

    firebase ext:info publisher-id/extension-id

    publisher-idextension-id 参数是必需的,可以在扩展程序的预安装详情页面上找到。

第 2 步:安装扩展程序

在安装过程中,系统会提示您查看扩展程序的基本规范(例如启用的 API、创建的资源、授予的访问权限等)。系统会向您通知所有结算要求,并提示您为扩展程序的可配置参数指定值。

  1. 请确保您已设置环境选择了某个扩展程序

  2. 运行 extension-install 命令。如果出现提示,请输入参数值以自定义扩展程序实例。

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    publisher-idextension-id 参数是必需的,可以在扩展程序的预安装详情页面上找到。

  3. 安装完成后,请查看扩展程序的使用说明,其中可能包括一些必须执行的安装后任务。

    • 在 Firebase 控制台的 Extensions 信息中心的扩展程序安装后详情页面中可以找到这些说明(安装后,终端会显示指向信息中心的特定链接)。

      您还可以在扩展程序的源目录中包含的 POSTINSTALL.md 文件中找到这些说明。

    • 如适用,这些说明将帮助您了解如何测试扩展程序(请查找查看实际应用效果部分)。

安装多个扩展程序实例

注意:您可以在同一项目中多次安装同一扩展程序。 每个已安装的实例都可以拥有自己的自定义配置和扩展程序资源。您可以使用项目中不重复的实例 ID 标识和引用每个已安装的实例。系统会提示您确认或修改所安装扩展程序的每个额外实例的 ID。

后续步骤