Firebase App Hosting è progettato specificamente per supportare lo sviluppo di app web moderne incentrate sui framework. Utilizza questa pagina come riferimento per gli strumenti e i framework supportati direttamente da App Hosting, nonché come punto di partenza per scoprire di più su strumenti e framework correlati.
Framework web e App Hosting
App Hosting offre due livelli di supporto generali per i framework web moderni: supporto preconfigurato per la creazione e il deployment e supporto a livello di community tramite contributi open source conformi alla specifica del bundle di output. In entrambi i casi, un componente adattatore del framework consente l'integrazione di un framework specifico con App Hosting.
Framework con supporto preconfigurato per la compilazione e il deployment
Grazie al supporto preconfigurato per la creazione e il deployment, Firebase identifica il framework che utilizzi esaminando il file package-lock.json o un altro file di blocco e ottimizza i processi di creazione e deployment per la tua app. Google si impegna a mantenere il supporto per questi framework e il team di assistenza Firebase può accettare segnalazioni di problemi e richieste di funzionalità.
Questo livello di assistenza è fornito per:
- Next.js
- Angular
Consulta i programmi di assistenza per informazioni dettagliate su versioni specifiche e livelli di assistenza.
Se provi a eseguire il deployment di un'app Node.js a cui manca un file di blocco, App Hosting
non riuscirà a creare ed eseguire l'app. Puoi creare package-lock.json eseguendo
npm install nella directory principale.
Framework supportati dalla community
Oltre a Next.js e Angular, App Hosting supporta anche qualsiasi framework web in grado di fornire un output di build che corrisponda alla nostra specifica del bundle di output. Gli autori dei framework possono sfruttare la specifica del bundle di output per assicurarsi che il loro framework sia supportato da App Hosting. Ad esempio, il popolare framework Nuxt è supportato dal team Nitro, che ha creato un adattatore Firebase per consentire il deployment dell'app Nuxt su App Hosting.
Se vuoi che App Hosting supporti altri framework, puoi creare un adattatore del framework o contattare i manutentori del framework per convertire gli output di build nel formato App Hosting. Gli adattatori Next.js e Angular sono ottimi esempi di riferimento per chiunque crei un adattatore.
Le informazioni sui framework supportati dalla community sono disponibili su Firebase Open Source. I problemi e le richieste di funzionalità per i framework supportati dalla community devono essere indirizzati alla community open source o agli autori del framework. In alcuni casi Google potrebbe essere in grado di fornire assistenza, ma la community è la prima linea di supporto per questi adattatori.
App Hosting framework adapter
In App Hosting, il supporto per i framework preconfigurati e supportati dalla community viene fornito tramite gli adattatori del framework. Gli adattatori del framework App Hosting hanno due ruoli chiave:
- Analizzano il codice sorgente e tutti i file di configurazione specifici del framework (ad esempio
next.config.js) e generano un bundle di output che può essere elaborato dal resto dell'infrastruttura App Hosting. - Eseguono il comando di build dell'app per generare asset statici e creare una versione ottimizzata dell'app per la produzione.
Gli adattatori del framework creano la tua app Node.js con npm run build, funzionando al meglio
con gli script di build predefiniti per ogni framework: next build per Next.js e
ng build per Angular. App Hosting tenterà di eseguire build con comandi di build personalizzati, ma non può garantire in modo affidabile la riuscita. Puoi
eseguire l'override degli script di build ed esecuzione
in apphosting.yaml.
Il codice sorgente degli adattatori Next.js e Angular è disponibile in firebase-framework-tools.
Runtime per App Hosting
Dopo la creazione e l'implementazione da parte di App Hosting, l'app Node.js viene eseguita in una revisione Cloud Run. Di conseguenza, la versione del runtime per la tua app deve rientrare sia nell'intervallo supportato di Cloud Run sia nell'intervallo del framework web che hai scelto. Per il supporto preconfigurato di Angular e Next.js, sono supportate le seguenti versioni di Node.js:
- Next.js 13.5.x e versioni successive
- Angular 18.2.x e versioni successive
- Node.js 18 e versioni successive
App Hosting non fornisce automaticamente assistenza attiva per le versioni del framework rilasciate di recente. Le versioni più recenti di quella attualmente designata come "attiva" saranno considerate in stato "anteprima" finché non verranno contrassegnate ufficialmente come "attive" per App Hosting.
App Hosting supporta l'assistenza a lungo termine (LTS) per l'ultima versione secondaria di una release principale per un anno dal periodo di assistenza attiva, a condizione che esegui costantemente l'aggiornamento alle patch più recenti all'interno di quella versione secondaria. Per i dettagli relativi a Next.js e Angular, consulta le tabelle seguenti.
Programma di assistenza Next.js
| Versione | Stato | Ritiro |
|---|---|---|
| 13.5.x | lts | 2026-10-9 |
| 14.2.x | lts | 2026-10-9 |
| 15.0.x | attivo | non prima del 09/10/2025 |
| 15.1.x | attivo | non prima del 09/10/2025 |
| 15.2.x | attivo | - |
Programma di assistenza di Angular
| Versione | Stato | Ritiro |
|---|---|---|
| 18.2.x | lts | 2026-10-9 |
| 19.0.x | attivo | non prima del 09/10/2025 |
| 19.1.x | attivo | non prima del 09/10/2025 |
| 19.2.x | attivo | - |
Gestori di pacchetti
App Hosting utilizza Cloud Native Buildpacks per eseguire l'installazione delle dipendenze e crea l'app utilizzando npm, yarn o pnpm. Altri gestori di pacchetti come JSR non sono supportati.
NPM
- NPM è il gestore di pacchetti predefinito.
- Le dipendenze non di produzione vengono eliminate dopo la build.
- Puoi specificare la sezione della versione di npm utilizzando il campo
engines.npmnel filepackage.json.
Filato
- Yarn viene utilizzato invece quando includi il file
yarn.locknel progetto. - Puoi specificare la versione di Yarn da utilizzare nel campo
engines.yarnopackageManagerdel filepackage.json. - App Hosting supporta la modalità PnP di Yarn2.
Pnpm
- Pnpm viene utilizzato invece quando includi il file
pnpm-lock.yamlnel tuo progetto. - Puoi specificare una versione di pnpm nel campo
engines.pnpmopackageManagerdel filepackage.json. - Per un esempio funzionante, consulta sample-node-pnpm. Flood-It!
Monorepo per App Hosting
App Hosting supporta le app basate su Nx. Per indicazioni dettagliate, consulta Utilizzare i monorepo con App Hosting.
Sono supportate le seguenti versioni di Nx:
| Versione | Stato | Ritiro |
|---|---|---|
| 19.5.x | manutenzione | 2025-10-9 |
| 19.6.x | manutenzione | 2025-10-9 |
| 19.7.x | manutenzione | 2025-10-9 |
| 19.8.x | lts | 2026-10-9 |
| 20.0.x | attivo | non prima del 09/10/2025 |
| 20.1.x | attivo | non prima del 09/10/2025 |
| 20.2.x | attivo | non prima del 09/10/2025 |
| 20.3.x | attivo | non prima del 09/10/2025 |
| 20.4.x | attivo | non prima del 09/10/2025 |
| 20.5.x | attivo | non prima del 09/10/2025 |
| 20.6.x | attivo | non prima del 09/10/2025 |
| 20.7.x | attivo | — |
Se hai bisogno di assistenza per altri tipi di spazi di lavoro monorepo, comunicacelo su Firebase UserVoice.