Firebase App Hosting está diseñado 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 los 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 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 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.
Adaptadores de frameworks App Hosting
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 los secuencias de comandos de compilación predeterminados para cada framework: next build para Next.js y ng build para Angular. App Hosting intentará compilar 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.
Tiempos 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. Por lo tanto, la versión del entorno de ejecución de tu app debe estar dentro del rango admitido de Cloud Run y del rango del framework web que elegiste. En el caso de 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 18 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 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.
Lana
- 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 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 monorepositorio, infórmanos en Firebase UserVoice.