Framework e strumenti per l'hosting delle app

Firebase App Hosting è progettato specificamente per supportare lo sviluppo di app web moderne incentrate su framework. Utilizza questa pagina come riferimento per gli strumenti e i framework supportati direttamente da App Hosting, nonché come punto di partenza per scoprire strumenti e framework correlati.

Framework web e App Hosting

App Hosting fornisce due ampi livelli di supporto per i framework web moderni: supporto per la compilazione e il deployment preconfigurato 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 per la compilazione e il deployment preconfigurati

Con il supporto preconfigurato per la compilazione e il deployment, Firebase identifica il framework in uso ispezionando il file package-lock.json o un altro file di blocco e ottimizza le procedure di compilazione e deployment per la tua app. Google si impegna a mantenere il supporto per questi framework e il team di assistenza di Firebase può accettare segnalazioni di problemi e richieste di funzionalità.

Questo livello di assistenza viene fornito per:

• Next.js
• Angular

Consulta le pianificazioni dell'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 compilare 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 compilazione corrispondente alla nostra specifica del bundle di output. Gli autori di framework possono sfruttare la specifica del bundle di output per verificare che il loro framework sia supportato da App Hosting. Ad esempio, il popolare framework Nuxt è supportato dal team di Nitro, che ha creato un adattatore Firebase per abilitare il deployment delle app Nuxt su App Hosting.

Se vuoi conoscere altri framework supportati da App Hosting, puoi creare un adattatore del framework o contattare i relativi amministratori per convertire gli output di compilazione nel formato App Hosting. Gli adattatori Next.js e Angular sono ottimi esempi di riferimento per chiunque crei un adattatore.

Puoi trovare informazioni sui framework supportati dalla community 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 comunità è la prima linea di assistenza per questi adattatori.

App Hosting framework adapters

In App Hosting, il supporto sia per i framework preconfigurati sia per quelli supportati dalla community viene fornito tramite gli adattatori di framework. Gli adattatori del framework App Hosting hanno due ruoli chiave:

• Analizzano il codice sorgente e eventuali 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 compilazione dell'app per generare asset statici e creare una versione ottimizzata dell'app per la produzione.

Gli adattatori del framework creano l'app Node.js con npm run build e funzionano al meglio con gli script di compilazione predefiniti per ciascun framework: next build per Next.js e ng build per Angular. App Hosting tenterà di eseguire build con comandi di compilazione personalizzati, ma non può garantire in modo affidabile il successo. Puoi sostituire gli script di compilazione ed esecuzione in apphosting.yaml.

Il codice sorgente degli adattatori Next.js e Angular è disponibile in firebase-framework-tools.

Runtime per App Hosting

Dopo essere stata creata ed eseguita il deployment da App Hosting, l'app Node.js viene eseguita in una revisione Cloud Run. Di conseguenza, la versione di runtime per la tua app deve rientrare nell'intervallo supportato da Cloud Run e nell'intervallo del framework web scelto. Per il supporto preconfigurato di Angular e Next.js, ciò significa che 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 appena rilasciate. Le versioni più recenti della versione attualmente designata come "attiva" verranno considerate in stato di "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 attivo, a condizione che effettui costantemente l'aggiornamento alle release patch più recenti all'interno di quella versione secondaria. Per maggiori dettagli su Next.js e Angular, consulta le tabelle seguenti.

Programma di assistenza di Next.js

Programma di assistenza Angular

Gestori dei pacchetti

App Hosting utilizza Cloud Native Buildpacks per eseguire l'installazione delle dipendenze e compila l'app utilizzando npm, yarn o pnpm. Altri gestori dei pacchetti come JSR non sono supportati.

NPM

• NPM è il gestore dei pacchetti predefinito.
• Le dipendenze non di produzione vengono eliminate dopo il completamento della build.
• Puoi specificare la sezione della versione npm utilizzando il campo engines.npm nel package.json file.

Filato

• Quando includi il file yarn.lock nel progetto, viene utilizzato Yarn.
• Puoi specificare la versione del filato da utilizzare nel campo engines.yarn o packageManager del file package.json.
• App Hosting supporta la modalità PnP di Yarn2.

Pnpm

• Pnpm viene utilizzato invece quando includi il file pnpm-lock.yaml nel progetto.
• Puoi specificare una versione di pnpm nel campo engines.pnpm o packageManager del file package.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:

Se hai bisogno di assistenza per altri tipi di spazi di lavoro monorepo, contattaci su Firebase UserVoice.