Firebase App Hosting est conçu spécifiquement pour prendre en charge le développement d'applications Web modernes centrées sur le framework. Utilisez cette page comme référence pour les outils et les frameworks compatibles avec App Hosting directement, ainsi qu'un point de départ pour en savoir plus sur les frameworks et les outils associés.
Frameworks Web et App Hosting
App Hosting fournit deux grands niveaux de compatibilité avec les frameworks Web modernes : une compatibilité avec la compilation et le déploiement préconfigurés, et une compatibilité au niveau de la communauté via des contributions Open Source conformes à la spécification du bundle de sortie. Dans les deux cas, un composant adaptateur de framework permet d'intégrer un framework spécifique à App Hosting.
Frameworks avec prise en charge de la compilation et du déploiement préconfigurées
Avec la prise en charge préconfigurée de la compilation et du 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 prise en charge de 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 et les niveaux de compatibilité spécifiques, consultez les calendriers de compatibilité.
Si vous essayez de déployer une application Node.js à laquelle il manque un 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 pris en charge par la communauté
En plus de Next.js et d'Angular, App Hosting est également compatible avec tous les frameworks Web capables de fournir une sortie de compilation correspondant à notre spécification 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 pris en charge par l'équipe Nitro, qui a créé un adaptateur Firebase pour permettre le déploiement d'applications Nuxt sur App Hosting.
Si vous souhaitez que d'autres frameworks soient compatibles avec App Hosting, vous pouvez créer un adaptateur de framework ou contacter les responsables du framework pour convertir les sorties 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 pris en charge par la communauté, consultez Firebase Open Source. Les problèmes et les demandes de fonctionnalités concernant les frameworks gérés par 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 pris en charge 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 pouvant ê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 compilent votre application Node.js avec npm run build, qui fonctionne 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 créer des builds avec des commandes de compilation personnalisées, mais ne peut pas garantir leur réussite de manière fiable. Vous pouvez ignorer 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 compilé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 trouver dans la plage compatible avec Cloud Run et dans la plage du framework Web de votre choix. 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 ou version ultérieure
App Hosting ne fournit pas automatiquement une prise en charge active des nouvelles versions du framework. Les versions plus récentes que la version actuellement désignée comme "active" seront considérées comme "preview" jusqu'à ce qu'elles soient officiellement marquées comme "actives" pour App Hosting.
App Hosting propose une prise en charge à long terme (LTS) pour la dernière version mineure d'une version majeure pendant un an à compter de la période de prise en charge active, à condition que vous passiez régulièrement aux dernières versions de correctifs de cette version mineure. Pour en savoir plus sur Next.js et Angular, consultez les tableaux suivants.
Calendrier de compatibilité de 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 paquets
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 paquets tels que JSR ne sont pas acceptés.
NPM
- NPM est le gestionnaire de packages par défaut.
- Les dépendances non de production sont supprimées une fois la compilation terminée.
- 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 monorépertoires avec App Hosting.
Les versions Nx suivantes sont compatibles:
| 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 monorépertoire, contactez-nous sur Firebase UserVoice.