App Hosting 使用入门

使用 GitHub 代码库中的现有 Next.js 或 Angular 应用（Next.js 版本 13+ 或 Angular 17.2+），开始使用 App Hosting 非常简单，只需创建 App Hosting 后端，然后通过推送到实际分支开始发布即可。如果您没有应用，请使用我们的某个示例应用来完成本指南中所述的步骤。

注意 ：应用托管是预览版。这意味着，应用 Hosting 受服务专用条款一般服务条款部分中的“非正式版产品条款”的约束。正式发布前功能“按原样”提供，可能只能获得有限的支持。如需了解详情，请参阅发布阶段说明。

准备工作

如果您还没有 Firebase 项目（如果您还没有 Firebase 项目），并升级到 Blaze 方案，然后才能设置 Firebase App Hosting。

如需创建项目，请执行以下操作：

1. 在 Firebase 控制台中，点击添加项目。

   • 如需将 Firebase 资源添加到现有 Google Cloud 项目，请输入该项目的名称或从下拉菜单中选择该项目。

   • 如需创建新项目，请输入要使用的项目名称。您也可以视需要修改项目名称下方显示的项目 ID。

     Firebase 会根据您提供的名称，为您的 Firebase 项目生成一个唯一 ID。如果您希望修改此项目 ID，必须立即修改，因为当 Firebase 为项目预配资源后，您将无法进行更改。如需详细了解 Firebase 如何使用项目 ID，请访问了解 Firebase 项目。

2. 如果看到相关提示，请查看并接受 Firebase 条款。

3. 点击继续。

4. （可选）为您的项目设置 Google Analytics（分析），以便在使用下列 Firebase 产品时能获得最佳体验：

   Firebase Crashlytics Firebase Cloud Messaging

   Firebase In-App Messaging Firebase Remote Config

   Remote Config 个性化 Firebase A/B Testing

   选择现有的 Google Analytics（分析）账号，或者创建一个新账号。

   如果您选择创建一个新账号，请选择 Analytics（分析）报告位置，然后接受项目的数据共享设置和 Google Analytics（分析）条款。

   稍后您可随时在“项目设置”的集成标签页中设置 Google Analytics（分析）。

5. 点击创建项目（如果使用现有的 Google Cloud 项目，则点击添加 Firebase）。

Firebase 会自动为您的 Firebase 项目预配资源。完成此过程后，您将进入 Firebase 控制台中 Firebase 项目的概览页面。

第 0 步（可选）：创建 GitHub 代码库和 Web 应用

如果您还没有位于 GitHub 代码库中的 Web 应用，或者更想使用示例应用来尝试该流程，请先为 Next.js 或 Angular 初始化我们的一个示例：

npm init @apphosting

您可以使用 next dev 或 ng start 在本地运行示例应用。如需继续操作，请创建一个新的 GitHub 代码库，并将新初始化的示例代码推送到其中。

第 1 步：创建 App Hosting 后端

App Hosting 后端是 App Hosting 为构建和运行您的 Web 应用而创建的托管资源的集合。您可以使用 Firebase 控制台或 Firebase CLI 创建和列出 App Hosting 后端。

Firebase 控制台：在构建菜单中，选择应用托管，然后选择开始使用。

CLI：（3.9 或更高版本）如需创建后端，请从本地项目目录的根目录运行以下命令：

firebase apphosting:backends:create --project PROJECT_ID --location us-central1

对于控制台或 CLI，请按照提示为后端指定名称，设置 GitHub 连接，并配置以下基本部署设置：

• 设置应用的根目录（默认为 /）

  这通常是 package.json 文件所在的位置。

• 设置活动分支

  它是 GitHub 代码库的分支，将部署到实际网址。通常是功能分支或开发分支合并到其中的分支。

• 接受或拒绝自动发布

  自动发布默认处于启用状态。完成后端创建后，您可以选择立即将应用部署到 App Hosting。

第 2 步：查看已部署的应用

在您创建后端时，Firebase 会为您提供一个免费的子网域，最终用户可通过该子网域访问您的 Web 应用。其格式为 backend-id--project-id.us-central1.hosted.app。

如需查看 Web 应用的网址，请检查 Firebase 控制台，或运行以下 CLI 命令：

firebase apphosting:backends:get --project PROJECT_ID {BACKEND_ID} --location us-central1

注意： 创建后端后，应用网址可能需要大约五分钟才能生效。

第 3 步：通过推送更改触发发布

创建后端并获得实际网址后，每当您将更改推送到 GitHub 代码库的实际分支时，即可触发 Web 应用的新版本的发布。如需对 App Hosting 设置执行测试，请执行以下操作：

1. 在 GitHub 中，将更改推送到 Web 应用的实时分支。
2. 在 Firebase 控制台中打开“App Hosting”标签页，然后为您的后端选择查看信息中心。该表列表会显示与由更改触发的发布关联的特定提交。

后续步骤

• 深入了解：浏览将托管应用与 Firebase Authentication 和 Google AI 功能集成的 Firebase Codelab：Next.js | Angular
• 关联自定义网域。
• 配置后端。
• 监控发布情况、网站使用情况和日志。