Cloud Functions for Firebase(第 2 代)使用入门

本页面介绍了设置 Cloud Functions for Firebase(第 2 代)所需执行的步骤。如果您还不熟悉设置 Cloud Functions for Firebase 的常规流程,请参阅第 1 代简介入门指南

使用采用了 Blaze 方案的项目

由于 Cloud Functions for Firebase(第 2 代)在 Cloud Run 上运行,您首先需要提供一种付款方式。Cloud Run 提供每月 200 万个请求的免费层级。如需了解详情,请参阅 Cloud Run 价格

安装 SDK

Cloud Functions for Firebase(第 2 代)库可在 npm 上获取。在该库中完成的所有工作还会在 GitHub 中公开。

如需启用 Cloud Functions for Firebase(第 2 代),请在 Firebase CLI 中运行以下命令:

# Install the latest version of the Firebase CLI
npm install -g firebase-tools

# Initialize a project, if necessary
firebase init functions

导入 firebase-functions SDK

Cloud Functions for Firebase(第 2 代)SDK 位于 v2 软件包导出中。您可以导入子软件包(推荐),或导入位于 firebase-functions/v2 的单体式文件,如下所示:

// import from a specific subpackage
const {onRequest} = require('firebase-functions/v2/https');

// import the entire v2 monolith
const functionsV2 = require('firebase-functions/v2');

导入第 1 代 SDK(可选)

原始 Cloud Functions for Firebase SDK 现在称为第 1 代。您仍然可以像以前一样导入第 1 代 SDK。为了提高可读性,您现在还可以从 v1 命名空间导入第 1 代 SDK。

const functions = require('firebase-functions/v1');
// alternatively:
// const functions = require('firebase-functions');

使用第 1 代 SDK 编写的函数将部署到 Cloud Functions(第 1 代)。为了更轻松地迁移到第 2 代函数,Cloud Functions 允许单个代码库同时包含第 1 代和第 2 代函数。

后续步骤

请参阅各个版本支持的触发器类型的指南和示例代码,包括新类型、Firebase Alerts 触发器、适用于 Firebase Extensions 的自定义事件触发器任务队列函数。 另请参阅有关如何执行以下操作的基本指南: