Firebase App Hosting se diseñó específicamente para admitir el desarrollo de apps web modernas centradas en frameworks. Usa esta página como referencia de las herramientas y los frameworks que App Hosting admite directamente, así como punto de partida para obtener información sobre frameworks y herramientas relacionados.
Frameworks web y App Hosting
App Hosting proporciona dos niveles amplios de compatibilidad con frameworks web modernos: compatibilidad preconfigurada para compilación e implementación, y compatibilidad a nivel de la comunidad a través de contribuciones de código abierto que cumplen con la especificación del paquete de salida. En ambos casos, un componente de adaptador de framework permite la integración de un framework específico con App Hosting.
Frameworks con compatibilidad preconfigurada para compilación e implementación
Con la compatibilidad preconfigurada para compilación e implementación, Firebase identifica qué framework usas inspeccionando el archivo package-lock.json o cualquier otro archivo de bloqueo, y optimiza los procesos de compilación e implementación de tu app. Google se compromete a mantener la compatibilidad con estos frameworks, y el equipo de asistencia de Firebase puede aceptar informes de problemas y solicitudes de funciones.
Este nivel de compatibilidad se proporciona para lo siguiente:
- Next.js
- Angular
Consulta los programas de asistencia para obtener detalles sobre las versiones y los niveles de asistencia específicos.
Si intentas implementar una app de Node.js a la que le falta un archivo de bloqueo, App Hosting
no podrá compilar ni ejecutar tu app. Puedes crear package-lock.json ejecutando npm install en tu directorio raíz.
Frameworks compatibles con la comunidad
Además de Next.js y Angular, App Hosting también admite cualquier framework web que pueda proporcionar un resultado de compilación que coincida con nuestra especificación del paquete de salida. Los autores de frameworks pueden aprovechar la especificación del paquete de salida para asegurarse de que App Hosting admita su framework App Hosting. Por ejemplo, el popular framework Nuxt es compatible con el equipo de Nitro, que creó un adaptador de Firebase para permitir la implementación de apps de Nuxt en App Hosting.
Si quieres que App Hosting admita frameworks adicionales, puedes crear un adaptador de framework o comunicarte con los responsables de mantenimiento del framework para convertir los resultados de compilación al formato de App Hosting. Los adaptadores de Next.js y Angular son buenos ejemplos de referencia para cualquier persona que cree un adaptador.
Puedes encontrar información sobre los frameworks compatibles con la comunidad en Firebase Open Source. Los problemas y las solicitudes de funciones para los frameworks compatibles con la comunidad deben dirigirse a la comunidad de código abierto o a los autores del framework. En algunos casos, es posible que Google pueda ayudar, pero la comunidad es la primera línea de asistencia para estos adaptadores.
Adaptadores de framework App Hosting
En App Hosting, la compatibilidad con frameworks preconfigurados y compatibles con la comunidad se proporciona a través de adaptadores de framework. App Hosting adaptadores de framework tienen dos funciones clave:
- Analizan tu código fuente y cualquier archivo de configuración específico del framework (como
next.config.js) y generan un paquete de salida que puede procesar el resto de la App Hosting infraestructura. - Ejecutan el comando de compilación de tu app para generar recursos estáticos y crear una versión optimizada de tu app para producción.
Los adaptadores de framework compilan tu app de Node.js con npm run build, que funciona mejor con las secuencias de comandos de compilación predeterminadas para cada framework: next build para Next.js y ng build para Angular. App Hosting intentará realizar compilaciones con comandos de compilación personalizados, pero no puede garantizar el éxito de manera confiable. Puedes
anular las secuencias de comandos de compilación y ejecución
en apphosting.yaml.
El código fuente de los adaptadores de Next.js y Angular está disponible en firebase-framework-tools.
Entornos de ejecución para App Hosting
Después de que App Hosting la compila y la lanza, tu app de Node.js se ejecuta en una Cloud Run revisión. Por lo tanto, la versión del entorno de ejecución de tu app debe estar dentro del rango compatible de Cloud Run's y del rango del framework web que elegiste. Para la compatibilidad preconfigurada con Angular y Next.js, esto significa que se admiten las siguientes versiones de Node.js:
- Next.js 13.5.x y versiones posteriores
- Angular 18.2.x y versiones posteriores
- Node.js 20 y versiones posteriores
App Hosting no proporciona automáticamente asistencia activa para las versiones de framework lanzadas recientemente. Las versiones más recientes que nuestra versión "activa" designada actualmente se considerarán en estado "vista previa" hasta que se marquen oficialmente como "activas" para App Hosting.
App Hosting admite la asistencia a largo plazo (LTS) para la versión secundaria más reciente de una versión principal durante un año a partir de su período de asistencia activa, siempre que actualices de forma coherente a las versiones de parche más recientes dentro de esa versión secundaria. Consulta las siguientes tablas para obtener detalles sobre Next.js y Angular.
Programa de asistencia de Next.js
| Versión | Estado | Baja |
|---|---|---|
| 13.5.x | lts | 2026-10-9 |
| 14.2.x | lts | 2026-10-9 |
| 15.0.x | activo | no antes del 2025-10-9 |
| 15.1.x | activo | no antes del 2025-10-9 |
| 15.2.x | activo | - |
Programa de asistencia de Angular
| Versión | Estado | Baja |
|---|---|---|
| 18.2.x | lts | 2026-10-9 |
| 19.0.x | activo | no antes del 2025-10-9 |
| 19.1.x | activo | no antes del 2025-10-9 |
| 19.2.x | activo | - |
Administradores de paquetes
App Hosting usa Cloud Native Buildpacks para ejecutar la instalación de dependencias y compila la app con npm, yarn o pnpm. No se admiten otros administradores de paquetes, como JSR.
NPM
- NPM es el administrador de paquetes predeterminado.
- Las dependencias que no son de producción se quitan después de que la compilación se realiza correctamente.
- Puedes especificar la sección de la versión de la Administración de socios de red mediante el campo
engines.npmen el archivopackage.json.
Yarn
- En su lugar, se usa Yarn cuando incluyes el archivo
yarn.locken tu proyecto. - Puedes especificar la versión de Yarn que se usará en el campo
engines.yarnopackageManagerde tu archivopackage.json. - App Hosting admite el modo PrnP de Yarn2.
Pnpm
- Pnpm se usa en su lugar cuando incluyes el archivo
pnpm-lock.yamlen el proyecto. - Puedes especificar una versión de pnpm en el campo
engines.pnpmopackageManagerde tu archivopackage.json. - Para obtener un ejemplo de funcionamiento, consulta el sample-node-pnpm. para tu app alojada en contenedores.
Monorepos para App Hosting
App Hosting admite apps basadas en Nx. Consulta Cómo usar monorepos con App Hosting para obtener instrucciones detalladas.
Se admiten las siguientes versiones de Nx:
| Versión | Estado | Baja |
|---|---|---|
| 19.5.x | mantenimiento | 2025-10-9 |
| 19.6.x | mantenimiento | 2025-10-9 |
| 19.7.x | mantenimiento | 2025-10-9 |
| 19.8.x | lts | 2026-10-9 |
| 20.0.x | activo | no antes del 2025-10-9 |
| 20.1.x | activo | no antes del 2025-10-9 |
| 20.2.x | activo | no antes del 2025-10-9 |
| 20.3.x | activo | no antes del 2025-10-9 |
| 20.4.x | activo | no antes del 2025-10-9 |
| 20.5.x | activo | no antes del 2025-10-9 |
| 20.6.x | activo | no antes del 2025-10-9 |
| 20.7.x | activo | — |
Si necesitas asistencia para otros tipos de espacios de trabajo de monorepo, comunícate con nosotros en Firebase UserVoice.