Firebase App Hosting 專門支援以架構為中心的現代網頁應用程式開發作業。本頁面提供 App Hosting 直接支援的工具和架構參考資料，以及相關架構和工具的學習起點。
網路架構和 App Hosting
App Hosting 為新式網頁架構提供兩種廣泛的支援層級：預先設定的建構和部署支援，以及透過符合輸出套件規格的開放原始碼貢獻內容，提供社群層級的支援。在這兩種情況下，架構介面卡元件都能將特定架構與 App Hosting 整合。
預先設定建構和部署支援的架構
Firebase 預先設定了建構和部署支援，會檢查 package-lock.json 檔案或其他鎖定檔案，判斷您使用的架構，並為應用程式最佳化建構和部署程序。Google 致力於維護這些架構的支援，Firebase 支援團隊可以接受問題回報和功能要求。
這項支援服務適用於：
- Next.js
- Angular
如要瞭解特定版本和支援等級的詳細資訊，請參閱支援時間表。
如果您嘗試部署缺少鎖定檔案的 Node.js 應用程式，App Hosting 將無法建構及執行應用程式。如要建立 package-lock.json，請在根目錄中執行 npm install。
社群支援的架構
除了 Next.js 和 Angular，App Hosting 也支援任何可提供符合輸出套件規格的建構輸出的網頁架構。架構作者可以利用輸出套件規格，確保 App Hosting 支援他們的架構。舉例來說，熱門的 Nuxt 架構是由 Nitro 團隊支援，該團隊建構了 Firebase 介面卡，可在 App Hosting 上部署 Nuxt 應用程式。
如要查看 App Hosting 支援的其他架構，您可以建立架構轉接器，或與架構維護人員聯絡，將建構輸出內容轉換為 App Hosting 格式。如果您要建立轉接器，Next.js 和 Angular 轉接器是不錯的參考範例。
如要瞭解社群支援的架構，請前往 Firebase 開放原始碼。如要回報社群支援架構的問題或提出功能要求，請向開放原始碼社群或架構作者提出。在某些情況下，Google 可能可以提供協助，但社群是這些轉接頭的第一線支援團隊。
App Hosting 架構配接器
在 App Hosting 中，系統會透過架構介面卡，支援預先設定和社群支援的架構。App Hosting 架構 介面卡有兩個主要角色：
- 這些工具會剖析原始碼和任何架構專屬設定檔 (例如
next.config.js)，並產生可由 App Hosting 基礎架構其餘部分處理的輸出套件。 - 這些指令會執行應用程式的建構指令，產生靜態資產，並建立應用程式的正式版，以供發布。
架構轉接程式會使用 npm run build 建構 Node.js 應用程式，並搭配各架構的預設建構指令碼 (Next.js 的 next build 和 Angular 的 ng build) 運作。App Hosting 會嘗試使用自訂建構指令建構，但無法保證一定會成功。您可以在 apphosting.yaml 中覆寫建構和執行指令碼。
Next.js 和 Angular 轉接程式的來源位於 firebase-framework-tools。
「App Hosting」的執行階段
App Hosting建構及推出後，Node.js 應用程式會在 Cloud Run 修訂版本中執行。因此，應用程式的執行階段版本應在 Cloud Run 支援的範圍內，以及所選網頁架構的範圍內。針對 Angular 和 Next.js 的預先設定支援，這表示支援下列 Node.js 版本：
- Next.js 13.5.x 以上版本
- Angular 18.2.x 以上版本
- Node.js 18 以上版本
App Hosting 不會自動為新發布的架構版本提供支援。如果版本比目前指定的「有效」版本新，在正式標示為 App Hosting 的「有效」版本前，會視為「預覽」狀態。
App Hosting 支援最新次要版本的主要版本，在有效支援期間內提供一年長期支援 (LTS)，前提是您持續更新該次要版本的最新修補程式版本。詳情請參閱下表 (Next.js 和 Angular)。
Next.js 支援時間表
| 版本 | 狀態 | 淘汰 |
|---|---|---|
| 13.5.x | lts | 2026-10-9 |
| 14.2.x | lts | 2026-10-9 |
| 15.0.x | 有效 | 不得早於 2025 年 10 月 9 日 |
| 15.1.x | 有效 | 不得早於 2025 年 10 月 9 日 |
| 15.2.x | 有效 | - |
Angular 支援時間表
| 版本 | 狀態 | 淘汰 |
|---|---|---|
| 18.2.x | lts | 2026-10-9 |
| 19.0.x | 有效 | 不得早於 2025 年 10 月 9 日 |
| 19.1.x | 有效 | 不得早於 2025 年 10 月 9 日 |
| 19.2.x | 有效 | - |
套件管理工具
App Hosting 會使用 Cloud Native Buildpacks 執行依附元件安裝作業，並使用 npm、yarn 或 pnpm 建構應用程式。系統不支援其他套件管理員，例如 JSR。
NPM
- NPM 是預設的套件管理員。
- 建構成功後，系統會修剪非正式版依附元件。
- 您可以在
package.json檔案中使用engines.npm欄位，指定 npm 版本區段。
毛線
- 如果在專案中加入
yarn.lock檔案，系統就會改用 Yarn。 - 您可以在
package.json檔案的engines.yarn或packageManager欄位中，指定要使用的 yarn 版本。 - App Hosting 支援 Yarn2 PnP 模式。
Pnpm
- 在專案中加入
pnpm-lock.yaml檔案時，系統會改用 Pnpm。 - 您可以在
package.json檔案的engines.pnpm或packageManager欄位中指定 pnpm 版本。 - 如需實際運作的範例，請參閱 sample-node-pnpm。應用程式。
App Hosting 的單一存放區
App Hosting 支援以 Nx 為基礎的應用程式。如需詳細指引，請參閱「搭配使用單一存放區與 App Hosting」。
支援的 Nx 版本如下：
| 版本 | 狀態 | 淘汰 |
|---|---|---|
| 19.5.x | 維修 | 2025-10-9 |
| 19.6.x | 維修 | 2025-10-9 |
| 19.7.x | 維修 | 2025-10-9 |
| 19.8.x | lts | 2026-10-9 |
| 20.0.x | 有效 | 不得早於 2025 年 10 月 9 日 |
| 20.1.x | 有效 | 不得早於 2025 年 10 月 9 日 |
| 20.2.x | 有效 | 不得早於 2025 年 10 月 9 日 |
| 20.3.x | 有效 | 不得早於 2025 年 10 月 9 日 |
| 20.4.x | 有效 | 不得早於 2025 年 10 月 9 日 |
| 20.5.x | 有效 | 不得早於 2025 年 10 月 9 日 |
| 20.6.x | 有效 | 不得早於 2025 年 10 月 9 日 |
| 20.7.x | 有效 | — |
如需其他類型的 Monorepo 工作區支援，請前往 Firebase UserVoice 告訴我們。