Firebase App Hosting se diseñó específicamente para admitir el desarrollo de apps web modernas centradas en el framework. Usa esta página como referencia para las herramientas y los frameworks que admite App Hosting 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 generales de compatibilidad con frameworks web modernos: compatibilidad preconfigurada con la compilación y la 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 la compilación y la implementación
Con la compatibilidad preconfigurada para la compilación y la implementación, Firebase identifica qué framework usas inspeccionando el archivo package-lock.json o algún otro archivo de bloqueo, y optimiza los procesos de compilación y de implementación para 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 asistencia se proporciona para lo siguiente:
- Next.js
- Angular
Consulta los programas de asistencia para obtener detalles sobre las versiones específicas y los niveles de asistencia.
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 con asistencia de 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 de paquete de salida. Los autores de frameworks pueden aprovechar la especificación del paquete de salida para garantizar que App Hosting admita su framework. Por ejemplo, el popular framework de Nuxt cuenta con la asistencia del equipo de Nitro, que creó un adaptador de Firebase para habilitar la implementación de apps de Nuxt en App Hosting.
Si deseas ver frameworks adicionales compatibles con App Hosting, puedes crear un adaptador de framework o comunicarte con los mantenedores del framework para convertir los resultados de la compilación al formato 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 se deben dirigir a la comunidad de código abierto o a los autores del framework. En algunos casos, Google puede brindar asistencia, pero la comunidad es la primera línea de asistencia para estos adaptadores.
App Hosting adaptadores de frameworks
En App Hosting, la compatibilidad con los frameworks preconfigurados y los que admite la comunidad se proporciona a través de adaptadores de frameworks. Los adaptadores del framework de App Hosting tienen dos roles 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 infraestructura de App Hosting. - 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 frameworks compilan tu app de Node.js con npm run build, y funcionan 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 forma 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 compile y lance, tu app de Node.js se ejecutará en una revisión de Cloud Run. En consecuencia, la versión del entorno de ejecución de tu app debe estar dentro del rango compatible de Cloud Run y del rango de tu framework web elegido. 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 frameworks lanzadas recientemente. Las versiones más recientes que nuestra versión "activa" designada actualmente se considerarán en estado de "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 constante 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 9 de octubre de 2025 |
| 15.1.x | activo | No antes del 9 de octubre de 2025 |
| 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 9 de octubre de 2025 |
| 19.1.x | activo | No antes del 9 de octubre de 2025 |
| 19.2.x | activo | - |
Actualizaciones automáticas de imágenes base (ABIU)
Las Actualizaciones Automáticas de la Imagen Base (ABIU) son una función que aplica automáticamente parches de seguridad a tu entorno de ejecución subyacente sin necesidad de que actives un nuevo lanzamiento de la app.
App Hosting habilita ABIU de forma predeterminada para los backends nuevos, con estos requisitos específicos:
- Entornos de ejecución versionados: Para usar ABIU, debes especificar un entorno de ejecución versionado (como
nodejs20,nodejs22onodejs24). App Hosting admite versiones de Node.js con números pares, lo que refleja la compatibilidad de Cloud Run. - Coincidencia de package.json: La versión de Node que selecciones para App Hosting debe ser compatible con la versión especificada en el campo
enginesde tu archivopackage.json. Si hay una discrepancia, se producirá un error en el tiempo de compilación de Cloud Build. Cada vez que cambies el campoengines, asegúrate de actualizar el tiempo de ejecución de tu backend antes de la implementación.
Cómo inhabilitar ABIU
Si quieres inhabilitar ABIU, puedes hacerlo durante la incorporación o seleccionando "Not Specified" para tu tiempo de ejecución en la consola de Firebase. Cuando se usa un valor predeterminado de nodejs sin versión, ABIU se inhabilita automáticamente.
Administra versiones del entorno de ejecución
Puedes ver y cambiar la versión del tiempo de ejecución y la preferencia de ABIU de tu backend en cualquier momento en la pestaña Configuración de tu panel de App Hosting. Sin embargo, ten en cuenta que cambiar la versión del entorno de ejecución puede dañar tu aplicación si la nueva versión no es compatible con tu código.
Con el tiempo, las versiones del entorno de ejecución alcanzan el final de su ciclo de vida de asistencia. Es importante mantener actualizados los tiempos de ejecución para evitar cambios rotundos:
- Tiempos de ejecución obsoletos: Si el tiempo de ejecución que elegiste queda obsoleto, tu aplicación seguirá funcionando en general. Recibirás una advertencia en la consola y deberás cambiar a una versión más reciente lo antes posible. Para obtener más información, consulta la documentación de Cloud Run sobre el ciclo de vida del tiempo de ejecución.
- Tiempos de ejecución retirados: Los tiempos de ejecución retirados no son compatibles en absoluto. No podrás crear compilaciones ni backends nuevos con una versión retirada, y si lo intentas, se generará un error de compilación. Es posible que las implementaciones existentes que se ejecutan en versiones retiradas dejen de funcionar, y Cloud Run se reserva el derecho de borrarlas.
Para obtener una lista completa de las versiones de Node compatibles, obsoletas y retiradas, consulta la documentación de compatibilidad con el entorno de ejecución de Cloud Run. Para obtener más detalles técnicos sobre cómo funcionan las actualizaciones de imágenes base, consulta la documentación de ABIU de Cloud Run.
Administradores de paquetes
App Hosting usa buildpacks nativos de la nube 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 para usar en el campo
engines.yarnopackageManagerdel archivopackage.json. - App Hosting admite el modo PnP 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.pnpmopackageManagerdel archivopackage.json. - Para ver un ejemplo funcional, consulta sample-node-pnpm. para tu app alojada en contenedores.
Monorepos para App Hosting
App Hosting admite apps basadas en Nx. Consulta Usa monorepos con App Hosting para obtener orientación detallada.
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 9 de octubre de 2025 |
| 20.1.x | activo | No antes del 9 de octubre de 2025 |
| 20.2.x | activo | No antes del 9 de octubre de 2025 |
| 20.3.x | activo | No antes del 9 de octubre de 2025 |
| 20.4.x | activo | No antes del 9 de octubre de 2025 |
| 20.5.x | activo | No antes del 9 de octubre de 2025 |
| 20.6.x | activo | No antes del 9 de octubre de 2025 |
| 20.7.x | activo | — |
Si necesitas asistencia para otros tipos de espacios de trabajo de monorepositorio, infórmanos en Firebase UserVoice.