您可以使用 Firebase 控制台或 Firebase CLI(命令行界面)安装(和管理)任何官方 Firebase 扩展程序。
请务必查看 Firebase CLI 和 Firebase 控制台支持的操作之间的差异。
若要安装或管理扩展程序,您必须拥有以下某个角色:Owner 或 Editor 或 Firebase Admin。
若要安装扩展程序,您的项目必须采用 Blaze(随用随付)方案。虽然安装扩展程序是免费的,但如果超出 Firebase 服务或 Cloud 服务(例如 [Cloud Secret Manager][secret-pricing])的免费层级,您可能会需要支付相应的费用。
准备工作
如果还没有将 Firebase 添加到您的项目,请先添加;然后将 Firebase 项目升级为 Blaze(随用随付)方案。
第 1 步:查看扩展程序的相关详情
这是可选步骤,但我们强烈建议您执行此操作。
在安装 Firebase 扩展程序之前,我们建议您先查看该扩展程序的详细信息,包括:
- 扩展程序的工作方式、任何预安装的任务以及扩展程序的相关详情
- 一般标识信息和说明
- 扩展程序的任务是否需要结算帐号
- 执行操作所需的 Google 服务 (API) 和访问角色
- 为扩展程序创建的资源(如函数)
- 用户可配置参数的说明
如需查看扩展程序的详细信息,请执行以下操作:
从以下来源浏览官方 Firebase 扩展程序:
- Firebase Extensions 产品页面
- Firebase 控制台中的 Firebase Extensions 信息中心
点击扩展程序卡片即可:
显示扩展程序的详细信息。
在 Firebase Extensions 源代码库中找到扩展程序源代码的链接。
在扩展程序的扩展程序目录中,您可以在
README
中查看此详细信息。
第 2 步:安装扩展程序
在安装过程中,系统会提示您查看扩展程序的基本规范(例如启用的 API、创建的资源、授予的访问权限等)。系统会向您通知所有结算要求,并提示您为扩展程序的可配置参数指定值。
从以下来源浏览官方 Firebase 扩展程序:
- Firebase Extensions 产品页面
- Firebase 控制台中的 Firebase Extensions 信息中心
点击扩展程序的卡片,然后查看该扩展程序的详细信息,该信息可提供具体的使用说明和任何预安装任务。
点击安装,然后按照屏幕上的说明安装扩展程序。
安装后,在 Extensions 信息中心的已安装扩展程序的卡片中点击开始使用。
如需查看扩展程序的安装后信息,请参阅此扩展程序的工作原理部分。此信息介绍了具体的使用说明以及进一步的集成要求。您可以随时查看安装后信息,具体方法是在 Firebase 控制台的 Extensions 信息中心访问已安装的扩展程序的详情页面。
(可选)如需立即测试您的扩展程序,您可以按照控制台中显示的查看实际应用效果中的步骤操作。
安装多个扩展程序实例
注意:您可以在同一项目中多次安装同一扩展程序。 每个已安装的实例都可以拥有自己的自定义配置和扩展程序资源。您可以使用项目中不重复的实例 ID 标识和引用每个已安装的实例。系统会提示您确认或修改所安装扩展程序的每个额外实例的 ID。
后续步骤
在 Firebase 控制台中查看已安装的扩展程序的详细信息和配置。
监控已安装的扩展程序的活动,包括检查其运行状况、使用情况和日志。
使用 Firebase 控制台 管理已安装的扩展程序。对于官方 Firebase 扩展程序,您可以重新配置或卸载扩展程序,也可以将扩展程序更新到最新版本。
对于所有项目,最佳做法是确保在 Firebase 控制台中为您的项目设置预算提醒,并监控您的使用情况和结算信息中心。