Firebase App Hosting wurde speziell für die Unterstützung der modernen Webanwendungsentwicklung mit Frameworks entwickelt. Auf dieser Seite finden Sie Informationen zu den Tools und Frameworks, die von App Hosting direkt unterstützt werden. Außerdem können Sie hier mehr über zugehörige Frameworks und Tools erfahren.
Web-Frameworks und App Hosting
App Hosting bietet zwei allgemeine Supportstufen für moderne Web-Frameworks: vorkonfigurierte Build- und Bereitstellungsunterstützung sowie Community-Support durch Open-Source-Beiträge, die der Spezifikation für Ausgabebundles entsprechen. In beiden Fällen ermöglicht eine Framework-Adapter-Komponente die Integration eines bestimmten Frameworks in App Hosting.
Frameworks mit vorkonfigurierter Unterstützung für Build und Bereitstellung
Mit der vorkonfigurierten Unterstützung für Build und Bereitstellung erkennt Firebase, welches Framework Sie verwenden, indem die package-lock.json-Datei oder eine andere Sperrdatei geprüft wird. Anschließend werden die Build- und Bereitstellungsprozesse für Ihre App optimiert. Google ist bestrebt, die Unterstützung für diese Frameworks aufrechtzuerhalten. Das Firebase-Supportteam kann Problemberichte und Funktionsanfragen entgegennehmen.
Diese Supportstufe wird für Folgendes bereitgestellt:
- Next.js
- Angular
Weitere Informationen zu bestimmten Versionen und Supportstufen finden Sie in den Zeitplänen für die Laufzeitunterstützung.
Wenn Sie versuchen, eine Node.js-App bereitzustellen, für die keine Sperrdatei vorhanden ist, kann App Hosting Ihre App nicht erstellen und ausführen. Sie können package-lock.json erstellen, indem Sie npm install in Ihrem Stammverzeichnis ausführen.
Von der Community unterstützte Frameworks
Neben Next.js und Angular unterstützt App Hosting auch alle Webframeworks, die eine Build-Ausgabe liefern können, die unserer Spezifikation für Ausgabebundles entspricht. Framework-Autoren können die Spezifikation für das Ausgabebündel nutzen, um sicherzustellen, dass ihr Framework von App Hosting unterstützt wird. Das beliebte Nuxt-Framework wird beispielsweise vom Nitro-Team unterstützt, das einen Firebase-Adapter entwickelt hat, um die Bereitstellung von Nuxt-Apps auf App Hosting zu ermöglichen.
Wenn Sie möchten, dass App Hosting zusätzliche Frameworks unterstützt, können Sie einen Framework-Adapter erstellen oder sich an die Verantwortlichen des Frameworks wenden, um Build-Ausgaben in das App Hosting-Format zu konvertieren. Die Next.js- und Angular-Adapter sind gute Referenzbeispiele für alle, die einen Adapter erstellen.
Informationen zu von der Community unterstützten Frameworks finden Sie unter Firebase Open Source. Probleme und Funktionsanfragen für von der Community unterstützte Frameworks sollten an die Open-Source-Community oder die Framework-Autoren gerichtet werden. In einigen Fällen kann Google helfen, aber die Community ist die erste Anlaufstelle für den Support für diese Adapter.
App Hosting Framework-Adapter
In App Hosting wird die Unterstützung für sowohl vorkonfigurierte als auch von der Community unterstützte Frameworks über Framework-Adapter bereitgestellt. App Hosting-Framework-Adapter haben zwei Hauptaufgaben:
- Sie parsen Ihren Quellcode und alle frameworkspezifischen Konfigurationsdateien (z. B.
next.config.js) und generieren ein Ausgabebündel, das vom Rest der App Hosting-Infrastruktur verarbeitet werden kann. - Dabei wird der Build-Befehl Ihrer App ausgeführt, um statische Assets zu generieren und eine für die Produktion optimierte Version Ihrer App zu erstellen.
Framework-Adapter erstellen Ihre Node.js-App mit npm run build. Sie funktionieren am besten mit den Standard-Build-Skripts für jedes Framework: next build für Next.js und ng build für Angular. App Hosting versucht, Builds mit benutzerdefinierten Build-Befehlen zu erstellen, kann den Erfolg aber nicht garantieren. Sie können Build- und Ausführungsskripts in apphosting.yaml überschreiben.
Der Quellcode für Next.js- und Angular-Adapter ist in firebase-framework-tools verfügbar.
Laufzeiten für App Hosting
Nachdem die Node.js-App von App Hosting erstellt und bereitgestellt wurde, wird sie in einer Cloud Run-Revision ausgeführt. Die Laufzeitversion für Ihre App sollte daher sowohl im unterstützten Bereich von Cloud Run als auch im Bereich des von Ihnen ausgewählten Web-Frameworks liegen. Für die vorkonfigurierte Unterstützung von Angular und Next.js bedeutet das, dass die folgenden Node.js-Versionen unterstützt werden:
- Next.js 13.5.x und höher
- Angular 18.2.x und höher
- Node.js 18 und höher
App Hosting bietet nicht automatisch aktiven Support für neu veröffentlichte Framework-Versionen. Versionen, die neuer als unsere derzeit als „aktiv“ gekennzeichnete Version sind, werden bis zur offiziellen Kennzeichnung als „aktiv“ für App Hosting als „Vorschau“ betrachtet.
App Hosting bietet ein Jahr lang Langzeitsupport (Long-Term Support, LTS) für die neueste Nebenversion einer Hauptversion ab dem Ende des aktiven Supportzeitraums, sofern Sie die neuesten Patch-Releases innerhalb dieser Nebenversion regelmäßig installieren. Weitere Informationen zu Next.js und Angular finden Sie in den folgenden Tabellen.
Zeitplan für die Next.js-Unterstützung
| Version | Status | Einstellung |
|---|---|---|
| 13.5.x | lts | 2026-10-9 |
| 14.2.x | lts | 2026-10-9 |
| 15.0.x | Aktiv | nicht vor dem 09.10.2025 |
| 15.1.x | Aktiv | nicht vor dem 09.10.2025 |
| 15.2.x | Aktiv | - |
Zeitplan für den Angular-Support
| Version | Status | Einstellung |
|---|---|---|
| 18.2.x | lts | 2026-10-9 |
| 19.0.x | Aktiv | nicht vor dem 09.10.2025 |
| 19.1.x | Aktiv | nicht vor dem 09.10.2025 |
| 19.2.x | Aktiv | - |
Paketmanager
App Hosting verwendet Cloud Native Buildpacks, um die Installation von Abhängigkeiten auszuführen und die App mit npm, yarn oder pnpm zu erstellen. Andere Paketmanager wie JSR werden nicht unterstützt.
NPM
- NPM ist der Standard-Paketmanager.
- Nicht produktionsbezogene Abhängigkeiten werden nach dem erfolgreichen Build entfernt.
- Sie können den npm-Versionsabschnitt mit dem
engines.npm-Feld in Ihrerpackage.json-Datei angeben.
Garn
- Yarn wird stattdessen verwendet, wenn Sie die Datei
yarn.lockin Ihr Projekt aufnehmen. - Sie können die zu verwendende Yarn-Version im Feld
engines.yarnoderpackageManagerIhrerpackage.json-Datei angeben. - App Hosting unterstützt den Yarn2-PnP-Modus.
Pnpm
- Pnpm wird stattdessen verwendet, wenn Sie die Datei
pnpm-lock.yamlin Ihr Projekt aufnehmen. - Sie können eine Version von pnpm im Feld
engines.pnpmoderpackageManagerIhrerpackage.json-Datei angeben. - Ein funktionierendes Beispiel finden Sie unter sample-node-pnpm. App.
Monorepos für App Hosting
App Hosting unterstützt Nx-basierte Apps. Eine ausführliche Anleitung finden Sie unter Monorepos mit App Hosting verwenden.
Die folgenden Nx-Versionen werden unterstützt:
| Version | Status | Einstellung |
|---|---|---|
| 19.5.x | Instandhaltungsarbeiten | 2025-10-9 |
| 19.6.x | Instandhaltungsarbeiten | 2025-10-9 |
| 19.7.x | Instandhaltungsarbeiten | 2025-10-9 |
| 19.8.x | lts | 2026-10-9 |
| 20.0.x | Aktiv | nicht vor dem 09.10.2025 |
| 20.1.x | Aktiv | nicht vor dem 09.10.2025 |
| 20.2.x | Aktiv | nicht vor dem 09.10.2025 |
| 20.3.x | Aktiv | nicht vor dem 09.10.2025 |
| 20.4.x | Aktiv | nicht vor dem 09.10.2025 |
| 20.5.x | Aktiv | nicht vor dem 09.10.2025 |
| 20.6.x | Aktiv | nicht vor dem 09.10.2025 |
| 20.7.x | Aktiv | – |
Wenn Sie Unterstützung für andere Arten von Monorepo-Arbeitsbereichen benötigen, teilen Sie uns dies bitte über Firebase UserVoice mit.