Firebase App Hosting est spécialement conçu pour prendre en charge le développement d'applications Web modernes axées sur les frameworks. Utilisez cette page comme référence pour les outils et les frameworks directement compatibles avec App Hosting, ainsi que comme point de départ pour en savoir plus sur les frameworks et outils associés.
Frameworks Web et App Hosting
App Hosting propose deux grands niveaux d'assistance pour les frameworks Web modernes : une assistance préconfigurée pour la compilation et le déploiement, et une assistance au niveau de la communauté grâce à des contributions Open Source conformes à la spécification du bundle de sortie. Dans les deux cas, un composant adaptateur de framework permet l'intégration d'un framework spécifique à App Hosting.
Frameworks avec prise en charge préconfigurée de la compilation et du déploiement
Grâce à la compatibilité préconfigurée pour la compilation et le déploiement, Firebase identifie le framework que vous utilisez en inspectant le fichier package-lock.json ou un autre fichier de verrouillage, et optimise les processus de compilation et de déploiement pour votre application. Google s'engage à maintenir la compatibilité avec ces frameworks, et l'équipe d'assistance Firebase peut accepter les signalements de problèmes et les demandes de fonctionnalités.
Ce niveau d'assistance est fourni pour :
- Next.js
- Angular
Pour en savoir plus sur les versions spécifiques et les niveaux d'assistance, consultez les calendriers de compatibilité.
Si vous essayez de déployer une application Node.js sans fichier de verrouillage, App Hosting ne pourra pas compiler ni exécuter votre application. Vous pouvez créer package-lock.json en exécutant npm install dans votre répertoire racine.
Frameworks soutenus par la communauté
En plus de Next.js et Angular, App Hosting est également compatible avec tous les frameworks Web capables de fournir un résultat de compilation correspondant à nos spécifications de bundle de sortie. Les auteurs de frameworks peuvent tirer parti de la spécification du bundle de sortie pour s'assurer que leur framework est compatible avec App Hosting. Par exemple, le framework Nuxt populaire est compatible avec l'équipe Nitro, qui a créé un adaptateur Firebase pour permettre le déploiement d'applications Nuxt sur App Hosting.
Si vous souhaitez voir d'autres frameworks compatibles avec App Hosting, vous pouvez créer un adaptateur de framework ou contacter les responsables du framework pour convertir les résultats de compilation au format App Hosting. Les adaptateurs Next.js et Angular sont de bons exemples de référence pour toute personne qui crée un adaptateur.
Pour en savoir plus sur les frameworks compatibles avec la communauté, consultez Firebase Open Source. Les problèmes et les demandes de fonctionnalités concernant les frameworks compatibles avec la communauté doivent être adressés à la communauté Open Source ou aux auteurs du framework. Dans certains cas, Google peut vous aider, mais la communauté est la première ligne d'assistance pour ces adaptateurs.
Adaptateurs de framework App Hosting
Dans App Hosting, la prise en charge des frameworks préconfigurés et de ceux soutenus par la communauté est assurée par des adaptateurs de framework. Les adaptateurs de framework App Hosting ont deux rôles clés :
- Ils analysent votre code source et tous les fichiers de configuration spécifiques au framework (tels que
next.config.js) et génèrent un bundle de sortie qui peut être traité par le reste de l'infrastructure App Hosting. - Ils exécutent la commande de compilation de votre application pour générer des éléments statiques et créer une version optimisée de votre application pour la production.
Les adaptateurs de framework créent votre application Node.js avec npm run build. Ils fonctionnent mieux avec les scripts de compilation par défaut de chaque framework : next build pour Next.js et ng build pour Angular. App Hosting tentera de compiler avec des commandes de compilation personnalisées, mais ne peut pas garantir le succès de l'opération. Vous pouvez remplacer les scripts de compilation et d'exécution dans apphosting.yaml.
Le code source des adaptateurs Next.js et Angular est disponible dans firebase-framework-tools.
Environnements d'exécution pour App Hosting
Une fois qu'elle est créée et déployée par App Hosting, votre application Node.js s'exécute dans une révision Cloud Run. Par conséquent, la version d'exécution de votre application doit se situer à la fois dans la plage compatible de Cloud Run et dans celle du framework Web que vous avez choisi. Pour la compatibilité préconfigurée avec Angular et Next.js, cela signifie que les versions Node.js suivantes sont compatibles :
- Next.js 13.5.x et versions ultérieures
- Angular 18.2.x et versions ultérieures
- Node.js 18 et versions ultérieures
App Hosting ne fournit pas automatiquement d'assistance active pour les nouvelles versions de frameworks. Les versions plus récentes que la version "active" actuellement désignée seront considérées comme étant en état d'aperçu jusqu'à ce qu'elles soient officiellement marquées comme "actives" pour App Hosting.
App Hosting est compatible avec le support à long terme (LTS) pour la dernière version mineure d'une version majeure pendant un an à compter de sa période de support actif, à condition que vous mettiez régulièrement à jour les derniers correctifs de cette version mineure. Pour en savoir plus sur Next.js et Angular, consultez les tableaux suivants.
Calendrier de compatibilité Next.js
| Version | État | Obsolescence |
|---|---|---|
| 13.5.x | lts | 2026-10-9 |
| 14.2.x | lts | 2026-10-9 |
| 15.0.x | actif | pas avant le 9 octobre 2025 |
| 15.1.x | actif | pas avant le 9 octobre 2025 |
| 15.2.x | actif | - |
Calendrier de compatibilité d'Angular
| Version | État | Obsolescence |
|---|---|---|
| 18.2.x | lts | 2026-10-9 |
| 19.0.x | actif | pas avant le 9 octobre 2025 |
| 19.1.x | actif | pas avant le 9 octobre 2025 |
| 19.2.x | actif | - |
Gestionnaires de packages
App Hosting utilise des packs de création cloud natifs pour exécuter l'installation des dépendances et créer l'application à l'aide de npm, yarn ou pnpm. Les autres gestionnaires de packages, tels que JSR, ne sont pas acceptés.
NPM
- NPM est le gestionnaire de packages par défaut.
- Les dépendances de non-production sont supprimées une fois la compilation réussie.
- Vous pouvez spécifier la section de version npm à l'aide du champ
engines.npmde votre fichierpackage.json.
Laine
- Le fichier Yarn est utilisé lorsque vous incluez le fichier
yarn.lockdans votre projet. - Vous pouvez spécifier la version de yarn à utiliser dans le champ
engines.yarnoupackageManagerde votre fichierpackage.json. - App Hosting est compatible avec le mode Yarn2 PnP.
Pnpm
- Pnpm est utilisé à la place lorsque vous incluez le fichier
pnpm-lock.yamldans votre projet. - Vous pouvez spécifier une version de pnpm dans le champ
engines.pnpmoupackageManagerde votre fichierpackage.json. - Pour obtenir un exemple fonctionnel, consultez sample-node-pnpm. Flood It!
Monorepos pour App Hosting
App Hosting est compatible avec les applications basées sur Nx. Pour obtenir des conseils détaillés, consultez Utiliser des monorepos avec App Hosting.
Les versions Nx suivantes sont acceptées :
| Version | État | Obsolescence |
|---|---|---|
| 19.5.x | entretien | 2025-10-9 |
| 19.6.x | entretien | 2025-10-9 |
| 19.7.x | entretien | 2025-10-9 |
| 19.8.x | lts | 2026-10-9 |
| 20.0.x | actif | pas avant le 9 octobre 2025 |
| 20.1.x | actif | pas avant le 9 octobre 2025 |
| 20.2.x | actif | pas avant le 9 octobre 2025 |
| 20.3.x | actif | pas avant le 9 octobre 2025 |
| 20.4.x | actif | pas avant le 9 octobre 2025 |
| 20.5.x | actif | pas avant le 9 octobre 2025 |
| 20.6.x | actif | pas avant le 9 octobre 2025 |
| 20.7.x | actif | — |
Si vous avez besoin d'aide pour d'autres types d'espaces de travail monorepo, contactez-nous sur Firebase UserVoice.