Questa pagina fornisce risposte alle domande frequenti (FAQ) su
App Hosting.
Domande frequenti su App Hosting
App Hosting supporta framework diversi da Next.js e Angular?
App Hosting fornisce supporto preconfigurato per la creazione e il deployment di
Next.js e Angular, per i quali ci impegniamo a comprendere
i framework e a interpretare le loro configurazioni native. Per una serie di
altri framework, la community di sviluppatori supporta gli adattatori di framework App Hosting. Inoltre, per qualsiasi applicazione Node.js
con uno script di creazione e avvio, App Hosting
tenterà di eseguire le build, ma non può garantirne l'esito positivo. Consulta Integrazione del framework.
Quali regioni supporta Firebase App Hosting?
È probabile che le regioni per App Hosting si espandano nel tempo. Per informazioni aggiornate, consulta
App Hosting località.
Posso utilizzare GitLab o altri provider Git oltre a GitHub per i deployment?
Al momento non è possibile, ma il supporto per altri provider è previsto nella roadmap a lungo termine
per App Hosting.
Perché non riesco a trovare il mio repository nell'interfaccia utente della console Firebase?
Se il repository non viene visualizzato nell'elenco delle opzioni quando
crei un nuovo backend nella console Firebase, prova prima a selezionare
Aggiorna elenco. Se il repository preferito non è ancora
disponibile, potresti doverlo aggiungere utilizzando l'opzione Concedi l'accesso a
un nuovo repository in GitHub.
Inoltre, puoi gestire i repository con l'applicazione GitHub Firebase App Hosting. Per farlo, vai al tuo profilo GitHub, seleziona
Impostazioni e poi Applicazioni. Nella riga della tabella per l'applicazione Firebase App Hosting, fai clic su Configura per gestire i repository.
Perché il mio sito non viene visualizzato normalmente in WebView dell'app mobile Android?
Le app che hanno configurato un dominio personalizzato con la Firebase console
prima del terzo trimestre del 2025 potrebbero riscontrare che il sito non viene visualizzato correttamente in Android
WebView. Questo accade perché i record CNAME utilizzati in quel periodo non erano
compatibili con Android WebView.
Per risolvere il problema, rimuovi il dominio personalizzato dal App Hosting
backend e aggiungilo di nuovo. L'interfaccia utente della console aggiornata fornirà 3 nuovi record, un record A
e un record TXT per il dominio e un record CNAME per il sottodominio della sfida ACME
(per i certificati); utilizza questi record al posto del record CNAME
precedente.
Come faccio a modificare il repository associato al mio progetto App Hosting?
Al momento non è possibile modificare il repository. Tuttavia, puoi
creare un nuovo backend associato al repository preferito all'interno dello stesso
progetto o creare un nuovo backend in un progetto separato.
Le intestazioni dipendono dal framework. Fai quello che faresti normalmente per
il tuo framework.
Esiste un emulatore per lo sviluppo locale con App Hosting?
Sì, puoi eseguire test locali della tua app prima del App Hosting deployment utilizzando l'App Hosting emulatore, che fa parte di Firebase Local Emulator Suite. Consulta Testare localmente
il deployment dell'app .
Perché vedo errori in App Hosting ma non in Cloud Build?
In questi casi, è possibile che l'errore provenga da Cloud Run.
Per esserne certo, controlla lo stato dell'implementazione.
Come faccio a modificare o rimuovere un account GitHub collegato?
Per rimuovere l'account GitHub collegato, apri Developer
Connect, assicurati che il progetto sia selezionato ed elimina la
connessione firebase-app-hosting-github-oath e la
connessione che inizia con apphosting-github-conn-. Quando
apri App Hosting nella console Firebase, dovresti essere
in grado di configurare una nuova connessione GitHub.
Come faccio a impostare i cookie per il mio sito App Hosting?
Sebbene non fosse disponibile al momento del lancio dell'anteprima di App Hosting, l'intestazione della risposta HTTP
Set-Cookie ora funziona come previsto.
Limitazioni generali e risoluzione dei problemi di App Hosting
- A causa di un problema nell'Cloud Runinfrastruttura,
la creazione o l'aggiornamento delle risorse potrebbe essere più lento del
previsto in alcune regioni come
us-central1.
Se la latenza del deployment è un problema in una determinata regione, Google consiglia di eseguire il deployment in un'altra regione.
- La CDN di App Hosting può includere solo un insieme specifico di intestazioni della richiesta nelle
chiavi della cache. Questo elenco include le intestazioni
RSC, Next-Router-State-Tree,
Next-Router-Prefetch, Next-Router-Segment-Prefetch, e Next-Url
di NextJS, nonché le intestazioni standard Accept, Accept-Encoding,
Access-Control-Request-Headers, Access-Control-Request-Method, Origin,
Sec-Fetch-Dest, Sec-Fetch-Mode, Sec-Fetch-Site,
X-Goog-Allowed-Resources, e X-Origindi Cloud CDN. Se una risposta contiene un'intestazione Vary con un valore non elencato qui, la nostra CDN non la memorizzerà nella cache.
- I file statici non memorizzati nella cache vengono pubblicati da Cloud Run; in una
release successiva, verranno archiviati e pubblicati dall'origine App Hostingper un rendimento migliore.
- La console Firebase potrebbe mostrare in modo intermittente un errore "build non trovata e
non valida" durante la creazione del backend.
- Tutti i backend dello stesso progetto condividono un'organizzazione/un account GitHub.
Possono essere collegati a repository diversi all'interno di questa organizzazione/account.
Per creare backend collegati a account GitHub diversi, inseriscili in progetti separati.
Limitazioni e risoluzione dei problemi delle app Angular
Sebbene il supporto App Hosting per Angular sia in fase di sviluppo attivo e in espansione, presenta le seguenti limitazioni:
- I18n: sebbene la funzionalità I18n di base funzioni, la navigazione diretta alle pagine SSR può causare errori.
- Localizzazione: la creazione di versioni per impostazioni locali diverse non è supportata.
- Generatori: al momento è supportato solo il generatore di applicazioni.
- Ambienti e strumenti monorepo: i progetti Angular con più di
una destinazione dell'applicazione non andranno a buon fine. Per un supporto monorepo più completo,
utilizza Nx.
Limitazioni e risoluzione dei problemi di Next.js
- Per impostazione predefinita, l'ottimizzazione delle immagini NextJS integrata è disattivata in App
Hosting, a meno che tu non imposti esplicitamente
images.unoptimized su false o utilizzi
un Image Loader personalizzato. Consulta Ottimizzare il caricamento delle immagini in Next.js.
- I percorsi URL contenenti caratteri codificati in percentuale vengono decodificati da
Cloud Run. Ciò potrebbe causare problemi con le funzionalità che prevedono solo percorsi URL codificati, come il routing parallelo di Next.js.
- Al momento, App Hosting limita la memorizzazione nella cache per le app NextJS che utilizzano
il middleware.
Nel tempo, le percentuali di successo della cache dovrebbero migliorare.
- I percorsi URL contenenti caratteri codificati in percentuale vengono decodificati da Cloud Run.
Ciò potrebbe causare problemi con le funzionalità che prevedono solo percorsi URL codificati, come
il routing parallelo di Next.js
