Domande frequenti e risoluzione dei problemi

Questa pagina fornisce risposte alle domande frequenti su App Hosting.

App Hosting Domande frequenti

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 siamo impegnati 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 build e avvio, App Hosting tenterà le build, ma non può garantire in modo affidabile la riuscita. Consulta la sezione Integrazione del framework.

Quali regioni supporta Firebase App Hosting?

È probabile che le regioni per App Hosting si espandano nel tempo. Consulta le sedi dei App Hosting per le informazioni più aggiornate.

Posso utilizzare GitLab o altri provider Git oltre a GitHub per i deployment?

Al momento non è possibile, ma il supporto di altri fornitori è 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 console Firebase prima del terzo trimestre del 2025 potrebbero riscontrare problemi di visualizzazione del sito in Android WebView. Ciò si verifica perché i record CNAME utilizzati in quel periodo non erano compatibili con Android WebView.

Per risolvere il problema, rimuovi il dominio personalizzato dal backend App Hosting e aggiungilo di nuovo. La UI della console aggiornata fornirà tre nuovi record: un record A e un record TXT per il dominio e un record CNAME per il sottodominio di verifica ACME (per i certificati). Utilizza questi record al posto del precedente record CNAME.

Come faccio a cambiare 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 oppure creare un nuovo backend in un progetto separato.

Come faccio a impostare le intestazioni per il mio sito App Hosting?

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 deployment utilizzando l'emulatore App Hosting, che fa parte di Firebase Local Emulator Suite.App Hosting 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. Controlla lo stato dell'implementazione per sicurezza.

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, ora 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 lancio dell'anteprima di App Hosting, l'intestazione della risposta HTTP Set-Cookie ora funziona come previsto.

Limitazioni e risoluzione dei problemi generali di App Hosting

• La CDN di App Hosting può includere solo un insieme specifico di intestazioni delle richieste nelle chiavi 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-Origin di 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 versione successiva, verranno archiviati e pubblicati dall'origine App Hosting per prestazioni migliori.
• La console Firebase potrebbe mostrare a intermittenza un errore "build non trovata e non valida" durante la creazione del backend.
• Tutti i backend nello stesso progetto condividono un account/organizzazione GitHub. Possono essere collegati a repository diversi nell'organizzazione/account. Per creare backend connessi a diversi account GitHub, inseriscili in progetti separati.

Limitazioni e risoluzione dei problemi delle app Angular

Sebbene il supporto di App Hosting per Angular sia in fase di sviluppo attivo e in espansione, presenta i seguenti limiti:

• I18n: sebbene la funzionalità I18n di base funzioni, la navigazione diretta alle pagine SSR può causare errori.
• Localizzazione: la creazione di versioni per impostazioni internazionali diverse non è supportata.
• Builder: al momento è supportato solo il builder di applicazioni.
• Ambienti e strumenti Monorepo: i progetti Angular con più di un target di applicazione non andranno a buon fine. Per un supporto più completo dei monorepo, utilizza Nx.

Limitazioni e risoluzione dei problemi di Next.js

• Per impostazione predefinita, l'ottimizzazione delle immagini NextJS integrata è disattivata su 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 su 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 middleware. Nel tempo, le percentuali di successo della cache dovrebbero migliorare.
• I percorsi URL contenenti caratteri con codifica percentuale vengono decodificati da Cloud Run. Ciò potrebbe causare problemi con le funzionalità che prevedono solo percorsi URL codificati, ad esempio il routing parallelo di Next.js.