Risoluzione dei problemi e domande frequenti di Firebase Studio

Suggerimento :se non trovi una risposta alla tua domanda, contatta l'assistenza Firebase o fai una domanda nei nostri forum della community.

Firebase Studio generale

Come faccio a scaricare i miei file da Firebase Studio?

Per scaricare i file come file ZIP:

• Fai clic con il tasto destro del mouse su una directory nel riquadro Explorer e seleziona Comprimi e scarica.

Per scaricare tutti i contenuti della directory del progetto:

1. Seleziona File > Apri cartella.

2. Accetta la directory /home/user predefinita.

3. Dopo il caricamento dei file, fai clic con il tasto destro del mouse sulla directory di lavoro e seleziona Comprimi e scarica. Se utilizzi App Prototyping agent, la tua directory di lavoro sarà studio. Se utilizzi un modello o un progetto caricato, questo sarà il nome del progetto.

4. Quando ti viene chiesto di ricreare l'ambiente, fai clic su Annulla.

5. Una volta completato il download, riapri la directory di lavoro dal menu File per tornare al tuo spazio di lavoro.

Suggerimento: puoi anche esportare su GitHub.

I cookie di terze parti non sono attivi.

Prima di iniziare, potresti dover attivare i cookie di terze parti per il tuo browser. Firebase Studio richiede i cookie di terze parti nella maggior parte dei browser per autenticare gli spazi di lavoro.

Chrome

1. Apri Impostazioni.
2. Apri la scheda Privacy e sicurezza.
3. Assicurati che l'opzione Consenti tutti i cookie sia attiva.
4. Apri Firebase Studio.
5. Fai clic sull'icona di visibilità nella barra degli indirizzi visibility_off per aprire il riquadro Protezione antitracciamento. Attiva l'impostazione Cookie di terze parti per consentire temporaneamente i cookie di terze parti. In questo modo i cookie vengono attivati su Firebase Studio per 90 giorni.

Safari

1. Apri Safari > Impostazioni….
2. Disattiva le seguenti impostazioni:
   • Avanzate > Blocca tutti i cookie
   • Privacy > Impedisci monitoraggio tra siti web
3. Apri Firebase Studio.

Firefox

Non è necessario attivare i cookie di terze parti per Firefox. Apri Firebase Studio.

Opera

1. Apri Opera.
2. Apri il menu e fai clic su Impostazioni.
3. Vai alla sezione Privacy e sicurezza ed espandi l'opzione Cookie di terze parti.
4. Seleziona Blocca i cookie di terze parti in modalità di navigazione in incognito o Consenti i cookie di terze parti.
5. Apri Firebase Studio.

Arco

1. Vai a arc://settings.
2. Vai alla sezione Privacy e sicurezza ed espandi l'opzione Cookie di terze parti.
3. Seleziona Blocca i cookie di terze parti in modalità di navigazione in incognito o Consenti i cookie di terze parti.
4. Apri Firebase Studio.

Brave

Non è necessario attivare i cookie di terze parti per Brave. Apri Firebase Studio.

Perché Firebase Studio richiede l'attivazione dei cookie di terze parti?

Firebase Studio richiede l'attivazione dei cookie di terze parti, poiché eseguiamo il rendering di un iframe da un dominio (un sottodominio di cloudworkstations.dev) su un altro dominio (studio.firebase.google.com) e i cookie di terze parti consentono una comunicazione cross-origin sicura.

Quando apri un workspace, viene visualizzato il messaggio Impossibile inoltrare la richiesta al backend. Impossibile connettersi a un server sulla porta 80.

Attendi circa cinque secondi e aggiorna la pagina.

L'anteprima non viene caricata, ma non riesco a trovare problemi nel codice. Come faccio a riavviare Firebase Studio?

Se Firebase Studio non si aggiorna correttamente (in genere a causa di refactoring importanti o modifiche al file dev.nix dell'ambiente), apri la tavolozza dei comandi (Cmd+Shift+P su Mac o Ctrl+Shift+P su ChromeOS, Windows o Linux) ed esegui il comando Riavvio forzato. Se il problema persiste, prova a eseguire il comando Ricrea ambiente.

Il mio workspace non è reattivo, vedo solo una schermata vuota quando si carica

Se lo spazio di lavoro non risponde, puoi provare a reimpostare la VM. Per farlo:

1. Da Firebase Studio, fai clic sul menu Altro ( more_horiz ), poi seleziona Reimposta.

2. Quando richiesto, fai di nuovo clic su Reimposta.

3. Riapri lo spazio di lavoro.

Durante la creazione di uno spazio di lavoro, visualizzo un messaggio: Oops… We need to start a new VM (Oops… We need to start a new VM) e l'interfaccia utente si blocca.

Firebase Studio gestisce un pool caldo di VM utilizzate per il provisioning di spazi di lavoro on demand. Quando il pool è quasi esaurito, gli spazi di lavoro vengono provisionati dopo l'avvio di una nuova macchina virtuale. La procedura può richiedere tempo (a volte fino a cinque minuti), ma alla fine ha esito positivo.

[Errno 28] No space left on device

Potresti visualizzare questo messaggio se il disco è pieno. Lo spazio di lavoro Firebase Studio offre:

• 100 GiB di spazio totale su disco per i pacchetti Nix e /tmp
• 10 GiB per la directory /home

Quando creo uno spazio di lavoro, ricevo il messaggio Si è verificato un errore interno.

Nella maggior parte dei casi di errori interni durante il provisioning dello spazio di lavoro, l'aggiornamento della pagina dopo circa un minuto dovrebbe consentirti di superare l'errore e accedere allo spazio di lavoro.

Quanti spazi di lavoro posso creare?

Il piano Firebase Studio senza costi è limitato a tre spazi di lavoro per utente. Puoi aumentare il numero di spazi di lavoro che puoi creare fino a 10 se partecipi al programma per sviluppatori Google. Per eseguire l'upgrade a 30 spazi di lavoro, abbonati al programma Google Developer Premium.

Come faccio a inviare una richiesta di funzionalità o un feedback su un problema che ho riscontrato?

Se riscontri un problema durante l'utilizzo di Firebase Studio o hai una richiesta di funzionalità, contatta l'assistenza Firebase.

Stavo usando una funzionalità specifica in Firebase Studio, ma non riesco più a trovarla. Perché è stato rimosso?

Alcune funzionalità di Firebase Studio sono sperimentali. Apprezziamo il tuo feedback e lo utilizziamo attivamente per definire il nostro insieme di funzionalità attuali e pianificate, rimuovendo periodicamente le funzionalità che non soddisfano le tue aspettative o le nostre. Se ci sono funzionalità che ti piacerebbe vedere nella tua versione ideale di Firebase Studio, inviaci un feedback. Vogliamo conoscere la tua opinione.

Firebase Studio Workspace di codice

Il mio spazio di lavoro si carica, ma l'emulatore è vuoto.

Stiamo migliorando attivamente l'affidabilità dei nostri emulatori basati su cloud. Se l'aggiornamento della pagina non risolve il problema, segnala il problema all'assistenza Firebase.

Gli spazi di lavoro Firebase Studio hanno una versione di Flutter incompatibile con il mio progetto.

Puoi eseguire l'upgrade o il downgrade della versione di quasi tutti i software preinstallati all'interno di uno spazio di lavoro proprio come faresti sulla tua macchina locale (utilizzando apt-get o brew). Puoi eseguire l'upgrade o il downgrade del software nel tuo workspace, ma il software installato non è persistente tra le sessioni. Ti consigliamo di includere tutti i pacchetti richiesti nel file dev.nix.

Stiamo lavorando attivamente per migliorare la gestione delle versioni di Flutter in Firebase Studio.

Ho condiviso l'URL della mia workstation con qualcuno, ma non riesce a visualizzarlo.

Puoi condividere l'URL di uno spazio di lavoro solo con gli utenti che hanno accesso allo spazio di lavoro. Gli utenti senza autorizzazione visualizzano un errore quando tentano di visitare l'URL. Assicurati di condividere esplicitamente lo spazio di lavoro con loro.

Quando condivido la mia postazione di lavoro, cosa può vedere il mio collaboratore?

Gli utenti aggiunti al tuo spazio di lavoro hanno accesso completo all'intero file system della VM, che potrebbe contenere file sensibili come chiavi private e token di accesso archiviati su disco. Condividi il tuo spazio di lavoro solo con persone di cui ti fidi. Sebbene questo approccio aiuti gli altri utenti a visualizzare lo stato esatto del tuo spazio di lavoro, significa che vedono tutto ciò che contiene.

Ho condiviso il mio spazio di lavoro; perché il mio collaboratore non può pubblicare o monitorare la mia app?

Gli utenti aggiunti al tuo spazio di lavoro potrebbero non disporre dell'autorizzazione per il progetto Firebase sottostante che alimenta le funzionalità di pubblicazione e monitoraggio della "Panoramica dell'app". Per concedere l'autorizzazione al tuo progetto Firebase, consulta Autorizzazioni e accesso ai progetti Firebase.

Posso utilizzare framework per cui Firebase Studio non dispone di un modello per creare la mia applicazione?

Sì! Puoi personalizzare il tuo ambiente per lavorare con quasi tutti i framework o linguaggi in Firebase Studio.

Quale directory di destinazione devo selezionare quando pubblico un'app Flutter su Firebase Hosting?

Scegli la directory build/web. Questa directory deve contenere un file index.html e tutte le risorse statiche necessarie per il rendering dell'app web dopo la creazione dell'app riuscita (tramite flutter build web).

Come faccio a configurare il backend della mia app nel mio spazio di lavoro in modo che il frontend possa comunicare con lui?

Puoi aprire temporaneamente al pubblico la porta TCP su cui è in esecuzione il server di backend per semplificare lo sviluppo separato del frontend e del backend in spazi di lavoro diversi:

1. Avvia il server backend o API manualmente in un terminale oppure come parte della configurazione di anteprima del file dev.nix; oppure dell'hook del ciclo di vita onStart.

2. Fai clic sull'icona Firebase Studio nella barra delle attività (a sinistra per impostazione predefinita) per aprire il riquadro Firebase Studio.

3. 

   Espandi la sezione Porte di backend per visualizzare un elenco dei server in esecuzione, inclusi il numero di porta e l'ID processo (PID).

4. Fai clic sull'icona Rendi pubblico (un lucchetto) a sinistra del numero di porta.

   Avviso: in questo modo, chiunque su internet può accedere alla tua porta mentre lo spazio di lavoro è attivo e finché non disattivi esplicitamente l'accesso pubblico.

5. Fai clic sull'icona Copia URL a destra del numero di porta per copiare il relativo URL completo.

6. Ora puoi fare riferimento direttamente a questo URL (ad esempio, con una chiamata fetch) dal frontend.

   Nota: se il frontend è un browser web, potrebbe essere necessario attivare il supporto di CORS nel backend o nel server API (ad esempio, utilizzando il pacchetto NPM cors per app Node.js o flask-cors per app Python Flask).

Ho chiuso la scheda di anteprima. Come faccio a recuperarlo?

Apri la tavolozza dei comandi utilizzando Ctrl+Shift+P (o Cmd-Shift-P su macOS), quindi seleziona Firebase Studio: Mostra anteprima Android o Firebase Studio: Mostra anteprima web.

Che cos'è Code OSS?

Code-Open Source Software (Code-OSS) è un progetto open source che costituisce il livello principale di VS Code. Code-OSS è disponibile su GitHub con la licenza MIT standard ed è la piattaforma su cui Microsoft sviluppa il prodotto VS Code.

Come faccio a impedire che i miei completamenti del codice e i prompt della chat Gemini vengano utilizzati come dati di addestramento?

L'utilizzo di Firebase Studio è regolato dai Termini di servizio di Google.

Tuttavia, tieni presente che il tuo utilizzo delle funzionalità di AI generativa all'interno di Firebase Studio è regolato dalle Norme relative all'uso vietato dell'AI generativa e dai Termini di servizio aggiuntivi di Gemini API (in particolare regolati dai Termini di servizio aggiuntivi di Gemini API: Servizi non a pagamento).

Per bloccare l'utilizzo dei tuoi prompt e delle tue risposte per l'addestramento del modello, non utilizzare App Prototyping agent e non utilizzare Gemini in Firebase all'interno di Firebase Studio. Per bloccare l'utilizzo del tuo codice per l'addestramento del modello, disattiva il completamento del codice e l'indicizzazione del codice nelle impostazioni di Firebase Studio.

Gemini

Come faccio a visualizzare la quota di richieste al minuto per la chiave API Gemini generata automaticamente?

Puoi visualizzare le quote associate alla chiave API generata automaticamente nella pagina Quote e limiti di sistema dell'API Generative Language nella console Google Cloud.

Ho ricevuto un errore relativo al superamento del numero massimo di token consentiti

La quantità di dati (rappresentati come "token") nel tuo progetto è superiore al limite massimo accettabile per il modello. Per risolvere questo errore, modifica i file del tuo codebase che devono essere nascosti da Gemini:

1. Nel tuo spazio di lavoro, passa alla visualizzazione Code.

2. Crea un file .aiexclude.

3. Includi file o directory Gemini da ignorare per ridurre la quantità di dati nel progetto. Ad esempio, potresti voler aggiungere .next/ e tutte le sottodirectory. Il percorso deve essere relativo alla directory che contiene il file .aiexclude:

    .next/
   

4. Riprova a utilizzare Gemini. Se continui a ricevere un errore relativo al superamento del numero massimo di token, prova ad aggiungere altri file o directory di grandi dimensioni al file .aiexclude.

L'agente di prototipazione delle app

Non sono riuscito a creare un progetto

Quando esegui il provisioning di risorse come una chiave Gemini API o il deployment in Firebase App Hosting, viene eseguito automaticamente il provisioning di un progetto in base al nome del tuo spazio di lavoro Firebase Studio.

Se ricevi l'errore "Impossibile creare un progetto":

• Se il tuo Account Google fa parte di un'organizzazione, è possibile che tu non disponga dell'autorizzazione per creare progetti Google Cloud o che tu abbia raggiunto il limite della quota di progetti. Contatta l'amministratore per ricevere assistenza o consulta Creazione e gestione dei progetti.

• Se il tuo Account Google non fa parte di un'organizzazione, potresti aver raggiunto il limite di quota del progetto Google Cloud. Richiedi un aumento della quota.

  Consulta la sezione Gestione delle quote del progetto per scoprire di più sulle quote del progetto.

Scopri di più su Firebase e sui progetti Google Cloud all'indirizzo Informazioni sui progetti Firebase.

Cloud Billing account non creato

Quando esegui il provisioning di risorse come il deployment su Firebase App Hosting, puoi scegliere o creare un account Cloud Billing.

Se ricevi l'errore "Impossibile creare un account Cloud Billing":

• Assicurati di disporre dell'autorizzazione per creare account Cloud Billing. Controlla le tue autorizzazioni o contatta l'amministratore per ricevere assistenza.

Se ricevi l'errore "Troppi progetti con questo account di fatturazione":

• Potresti aver raggiunto il limite di progetti per il tuo account Cloud Billing. Puoi richiedere un aumento della quota. Scopri di più sulle quote dell'account Cloud Billing.

Scopri di più sulla creazione di un account Cloud Billing all'indirizzo Crea un nuovo account di fatturazione self-service.

Se nessuna di queste opzioni risolve il problema, contatta l'assistenza.Cloud Billing

Perché App Prototyping agent non si offre di risolvere il mio problema?

L'agente di prototipazione delle app rileva gli errori di Next.js e offre di correggerli. Se ricevi un errore e non ti viene offerta una soluzione, copia il testo del problema e incollalo nella chat.

Per ottenere risultati ottimali, fornisci maggiori informazioni sulla natura del problema, se le hai.

Ad esempio, se visualizzi un errore di Firebase come Property access is undefined on object. for 'list' @ L6, che indica un problema con le regole Cloud Firestore, introduci l'errore con la frase "Puoi aiutarmi a risolvere questo problema con le regole Cloud Firestore?".

Dopo la pubblicazione, ho ricevuto il messaggio di errore "Pubblicazione dell'app non riuscita"

In genere, gli errori di pubblicazione vengono registrati nei log di Cloud Build. Per eseguire il debug e risolvere gli errori di pubblicazione:

1. Nella pagina Dettagli app (se è ridotta a icona, fai clic su Pubblica per visualizzarla), fai clic su Visualizza dettagli. Si aprirà App Hosting nella console Firebase.

2. Nella pagina Firebase della console App Hosting, fai clic su Visualizza log Cloud Build.

   Si apre la console Firebase in cui puoi visualizzare i log di build e individuare l'errore.

3. Copia l'errore e incollalo nella chat di App Prototyping agent o Gemini in Firebase nel tuo spazio di lavoro e chiedi a Gemini di risolverlo.

4. Per verificare la correzione, passa alla visualizzazione Codice, apri il terminale ed esegui npm run build. Se visualizzi un altro errore, riprova. Se vedi un FirebaseError, vedi Perché App Prototyping agent non offre di risolvere il mio problema?

5. Se la build ha esito positivo, fai clic su npm run start e apri il link localhost fornito per testare la funzionalità dell'app. Puoi controllare il terminale per eventuali errori di runtime.

6. Se tutto va a buon fine, digita Ctrl-C in Terminale per interrompere la build con pacchetto di produzione in esecuzione nello spazio di lavoro, quindi riprova il flusso di pubblicazione App Hosting.

Non riesco ad apportare modifiche utilizzando App Prototyping agent

Se App Prototyping agent non completa le modifiche al codice richieste, torna al passaggio Progetto dell'app o restituisce ripetutamente un errore che indica che si è verificato un problema:

1. Reimposta la VM.

2. Se il problema persiste quando riapri lo spazio di lavoro, inserisci /clear nella chat App Prototyping agent.

   Nota: questo comando cancella la cronologia della chat, incluso il pulsante per ripristinare un punto precedente.

3. Se il problema persiste, puoi provare a creare un ramo da una versione precedente della tua app:

   1. Passa alla visualizzazione Code.

   2. Apri la scheda Controllo della sorgente.

   3. Nel grafico del controllo della sorgente, fai clic con il tasto destro del mouse su una versione precedente > Crea ramo. Inserisci un nome per il ramo.

   4. Torna a Prototyper mode. If the agent still doesn't respond or returns an error, try branching from an even earlier version of your app.

   5. Per passare da un ramo all'altro che crei (o tornare al ramo principale), fai clic sul nome del ramo nell'angolo in basso a sinistra della visualizzazione Code e scegli il ramo che vuoi utilizzare.