概览

Firebase Extensions 可以帮助您减少在应用的开发、维护和扩展方面花费的时间。

当您找到可满足您的应用或项目需求的 Firebase Extensions 扩展程序时，只需安装并配置该扩展程序即可。如果您需要扩展程序的多个配置，则可以多次安装该扩展程序，并为安装的每个实例设定不同的配置。

借助扩展程序，您无需花时间研究、编写和调试用以实现功能或自动执行应用或项目某项任务的代码。

如需安装或管理扩展程序，您必须拥有以下某个角色：Owner 或 Editor 或 Firebase Admin。

如需安装扩展程序，您的项目必须采用 Blaze（随用随付）方案。虽然扩展程序可以免费安装，但如果超出 Firebase 服务或 Cloud 服务（例如 Cloud Secret Manager）的免费层级，您可能就需要支付相应的费用。

您还可以在将扩展程序安装到项目中之前使用 Extensions 模拟器（Firebase Local Emulator Suite 的一个组件）对其进行评估。

官方 Firebase Extensions 扩展程序

官方 Firebase Extensions 扩展程序由 Firebase 和 Firebase Extensions Partner Services 开发和测试。这些扩展程序安全可靠。

在 Extensions Hub 中浏览官方 Firebase Extensions 扩展程序。

抢先体验合作伙伴扩展程序由扩展程序发布商的抢先体验计划的参与者开发。它们并非由 Google 构建或测试。Google“按原样”提供抢先体验合作伙伴扩展程序，不作任何明示或暗示的担保。对于因使用该扩展程序而导致的任何直接或间接损害，Google 不承担任何责任。

如需详细了解如何发布您自己的扩展程序，请注册参加扩展程序发布商的抢先体验计划。

如需查找某个官方 Firebase 扩展程序的源代码链接，请在 Extensions Hub 中点击该扩展程序卡片上的了解详情。

如需查找抢先体验合作伙伴扩展程序的源代码链接，请使用扩展程序的控制台安装链接或 CLI 的 ext:install 命令启动安装流程。系统会显示指向源代码的链接，以及有关相应扩展程序的其他信息。如果您只想查看源代码，可以取消安装。

扩展程序的源代码目录中包含：

extension.yaml 文件 - 包含扩展程序的元数据并定义所创建的资源、执行操作所需的 Google API 和访问角色，以及扩展程序的任何用户配置的参数（环境变量）
函数目录 - 包含扩展程序源代码文件
README 文件 - 列出了扩展程序的元数据（但采用更易于用户理解的格式）以及 PREINSTALL 文件中的内容
PREINSTALL 文件 - 描述扩展程序的工作方式、安装前的所有必要准备工作、配置要求以及扩展程序的相关详情
POSTINSTALL 文件 - 介绍具体的使用说明以及进一步的集成要求

每个 Firebase 项目都包含多种类型的“资源”。项目资源可能包括已部署的 Cloud Functions 函数、数据库实例、Cloud Storage 存储桶、Cloud Scheduler 作业及 Cloud Secret Manager 数据等。

安装扩展程序时，Firebase 会在您的项目中创建新的扩展程序实例专用资源。扩展程序运行时需要这些资源。

注意，如果您卸载扩展程序实例，则 Firebase 为使该扩展程序实例运行而专门创建的所有资源（如一组函数）都会被删除。但以下各项不会被删除：

扩展程序创建的任何工件（如存储的图片）。
项目中的任何其他资源，例如数据库实例或 Cloud Storage 存储桶。即使扩展程序与这些其他资源进行了交互，这些资源也并非专用于扩展程序，因此在扩展程序卸载后不会被删除。

您可以使用 Firebase 控制台或 Firebase CLI 安装和管理任何官方 Firebase 扩展程序。