Ritiro di Firebase Studio e migrazione dei progetti

Firebase Studio verrà ritirato il 22 marzo 2027. Stiamo semplificando le nostre offerte per sviluppatori di AI trasferendo le lezioni apprese dall'anteprima di Firebase Studio nei nostri strumenti di punta: Google AI Studio e Google Antigravity.

Sebbene l'interfaccia per la creazione di app sia in continua evoluzione, il nostro impegno nei confronti dell'ecosistema Firebase è più forte che mai. Integrando le funzionalità agenti direttamente nelle nostre piattaforme AI di punta, ci assicuriamo che Firebase continui a fornire un backend affidabile e senza interruzioni per lo sviluppo basato sull'AI. I servizi Firebase principali, come Cloud Firestore, Authentication e App Hosting, continueranno a funzionare al di fuori di Firebase Studio.

Perché stiamo apportando questa modifica

Firebase Studio è stato lanciato come anteprima per esplorare il futuro dello sviluppo full-stack basato sull'AI. In base ai feedback ricevuti, stiamo semplificando i nostri strumenti per fornire percorsi più chiari e potenti:

• Per lo sviluppo agentico incentrato sul codice: ci stiamo concentrando su Antigravity, il nostro IDE di nuova generazione progettato per flussi di lavoro locali autonomi e ad alta velocità.

• Per la prototipazione rapida basata su browser: abbiamo integrato Cloud Firestore e Firebase Authentication direttamente in Google AI Studio per fornire il percorso più rapido dal prompt alla produzione.

I tuoi servizi Firebase principali (Cloud Firestore, Authentication, App Hosting e così via) non sono interessati. I tuoi database e i dati utente continueranno a funzionare normalmente. Il ritiro riguarda solo l'ambiente di sviluppo Firebase Studio.

Cronologia del tramonto

Stiamo fornendo un periodo di transizione di un anno per assicurarci che tu abbia tutto il tempo necessario per migrare i tuoi progetti:

• 19 marzo 2026: annuncio del ritiro e inizio dell'implementazione degli strumenti di migrazione per Firebase Studio.
• 22 giugno 2026: la creazione di nuovi spazi di lavoro è disattivata. Puoi continuare a lavorare e a eseguire la migrazione degli spazi di lavoro esistenti.
• 22 marzo 2027: Firebase Studio viene arrestato e tutti i dati rimanenti vengono eliminati definitivamente e non possono essere recuperati.

Scegliere il percorso di migrazione

A seconda di come utilizzi Firebase Studio, scegli il percorso di migrazione più adatto al tuo flusso di lavoro.

Esegui la migrazione a Google Antigravity

Per un'esperienza di sviluppo basata sul codice e sugli agenti, ti consigliamo di eseguire la migrazione ad Antigravity. Si tratta del nostro IDE di nuova generazione progettato per flussi di lavoro locali autonomi e ad alta velocità. Devi scegliere Antigravity se soddisfi uno dei seguenti criteri:

• Preferisci lavorare in un ambiente di sviluppo locale, code-first, con un controllo più approfondito del codebase
• Hai creato la tua app utilizzando un modello integrato o un repository importato in Firebase Studio
• Utilizza principalmente l'ambiente della Vista codice in Firebase Studio
• Vuoi accedere direttamente a funzionalità di sviluppo di AI agentiche all'avanguardia all'interno di un IDE potente, con il supporto per l'utilizzo di diversi modelli come Claude e GPT-OSS, oltre a Gemini
• Avvio: Prototyper mode, but added significant features or execution scripts that require a local environment without cloud limitations

Migrazione a Google AI Studio

Per un ambiente di prototipazione basato sul web che porta la potenza dell'AI nel tuo browser, ti consigliamo di eseguire la migrazione a Google AI Studio. Offre il percorso più rapido dal prompt all'app di produzione full-stack. Devi scegliere Google AI Studio se soddisfi uno dei seguenti criteri:

• Preferisci un'esperienza basata sul web, ideale per workflow multi-dispositivo o ambienti in cui non è possibile installare software locali
• Hai creato la tua app utilizzando App Prototyping agent in Firebase Studio e apprezzi la prototipazione rapida e la generazione di app basata su prompt
• Vuoi il percorso più veloce dal prompt all'app di produzione full-stack

Esegui la migrazione delle app a Google AI Studio

Google AI Studio offre il percorso più veloce dal prompt all'app di produzione full-stack.

Passaggio 1: trasferisci il tuo spazio di lavoro

1. Fai clic sul pulsante Sposta ora nella parte superiore dello spazio di lavoro, quindi seleziona Prepara per AI Studio.
2. Al termine del passaggio di preparazione, fai clic su Passa a Google AI Studio.
3. Se richiesto, leggi e accetta i Termini di servizio. Il codice si aprirà automaticamente in un nuovo spazio di lavoro Google AI Studio.

Potrebbero essere necessari diversi minuti per convertire e caricare la tua app. Riceverai una notifica al termine dell'operazione.Google AI Studio Al termine, puoi continuare a perfezionare la tua app con l'aiuto dell'agente Google AI Studio. Scopri di più sulla creazione di app in Google AI Studio.

Passaggio 2: scegli il metodo di pubblicazione

A seconda delle tue esigenze di deployment e se vuoi conservare l'URL dell'applicazione esistente, seleziona uno dei seguenti metodi di pubblicazione.

Opzione A: pubblica su App Hosting e mantieni l'URL esistente

Se hai pubblicato in precedenza la tua app tramite Firebase Studio e vuoi mantenere l'URL *.hosted.app o il dominio personalizzato, proteggi la tua chiave API Gemini e utilizza la sincronizzazione GitHub:

1. Proteggi la tua chiave API Gemini:
   1. Nella console Firebase, vai alla pagina App Hosting.
   2. Trova il backend esistente (di solito denominato studio) e fai clic su Visualizza.
   3. Nella scheda Impostazioni, vai ad Ambiente.
   4. Fai clic su Aggiungi nuovo e incolla i contenuti del file .env nel campo Chiave per archiviare in modo sicuro la chiave API Gemini come variabile di ambiente.

2. Sincronizza con GitHub da Google AI Studio:

   1. In Google AI Studio, fai clic sull'icona Impostazioni e vai al pannello GitHub.
   2. Fai clic su Accedi a GitHub e installa l'app GitHub Google AI Studio.

   3. Fai clic su Crea repository GitHub.

   4. Seleziona Organizza e conferma tutte le modifiche.

3. Connetti il repository a App Hosting:

   1. Nella console Firebase, vai alla pagina App Hosting.
   2. Trova il backend esistente (di solito denominato studio) e fai clic su Visualizza.
   3. Nella scheda Impostazioni, seleziona Deployment > Connetti a GitHub.
   4. Accedi a GitHub e installa l'app GitHub Firebase App Hosting.
   5. Seleziona il repository, imposta il ramo su main e la directory radice su /.
   6. Fai clic su Salva e implementa.

4. Sincronizza le modifiche con GitHub ed esegui il deployment:

   1. In Google AI Studio, vai al pannello GitHub.
   2. Rivedi le modifiche da pubblicare.
   3. Fai clic su Stage and commit all changes (Prepara e conferma tutte le modifiche).
   4. Vai alla console Firebase per monitorare l'avanzamento del deployment di App Hosting.

Opzione B: passare a Cloud Run e pubblicare l'app su un nuovo URL

Se preferisci un'esperienza con un solo clic e non hai ancora pubblicato la tua app o non ti preoccupa un nuovo URL (*.run.app), utilizza il pulsante Pubblica in Google AI Studio:

1. Apri l'app in Google AI Studio e fai clic su Pubblica.
2. Nel selettore progetti, fai clic su Importa progetto.
3. Cerca e seleziona il nome del progetto utilizzato da Firebase Studio (che si trova nella barra di navigazione superiore del workspace Firebase Studio).
4. Fai clic su Importa e poi su Pubblica.

Eseguire la migrazione delle app ad Antigravity

Antigravity è un IDE locale agent-first che porta la potenza dell'AI nel tuo ambiente di sviluppo locale.

Prerequisiti

Assicurati di aver installato localmente e aggiornato completamente quanto segue:

• Google Antigravity IDE
• Node.js (versione 20 o successive)
• Firebase CLI (versione 15.10.0 o successive)

Passaggio 1: esporta e inizializza l'app

npx firebase-tools@latest studio:export PATH

Passaggio 2: visualizza l'anteprima dell'app

Una volta estratto il progetto e aperto in Antigravity, puoi visualizzare l'applicazione in locale:

1. In Antigravity, vai al menu Esegui e debug nella barra laterale a sinistra.
2. Fai clic sul pulsante di riproduzione per avviare il server di sviluppo locale.
3. Segui le istruzioni nel terminale per visualizzare l'anteprima dell'app.

Passaggio 3: pubblica l'app

Antigravity utilizza le competenze dell'agente per pubblicare la tua app utilizzando le best practice di Firebase.

1. Nel riquadro della chat, inserisci il seguente prompt:

   Publish my app
   

2. Quando ti viene chiesto di eseguire firebase deploy, scegli Sì. L'agente verrà pubblicato nell'URL esistente se hai già pubblicato in Firebase App Hosting. Se è la prima volta che pubblichi su App Hosting, l'agente ti guiderà nella procedura.

3. Per gli aggiornamenti futuri, chiedi all'agente di publish my app nel pannello della chat Antigravity.

Eseguire la migrazione delle app ad altre piattaforme

Se preferisci spostare il progetto in un ambiente di sviluppo o una piattaforma di hosting diversi, puoi esportare il codice sorgente e gestire manualmente i deployment.

Passaggio 1: esporta l'origine del progetto

Prima della data di ritiro, devi scaricare una copia locale dei file del progetto:

1. Fai clic sul pulsante Sposta ora nella parte superiore dell'area di lavoro > Comprimi e scarica.
2. Estrai l'archivio sul tuo computer locale.

Passaggio 2: scegli il metodo di pubblicazione

Una volta che il codice è locale, puoi continuare a pubblicare la tua app utilizzando i seguenti metodi:

• Firebase CLI (mantiene l'URL esistente)

  1. Installa la CLI Firebase utilizzando npm eseguendo il seguente comando:

     npm install -g firebase-tools
     

  2. Nel terminale, vai alla directory del progetto.

  3. Esegui questo comando per configurare i deployment App Hosting per il tuo progetto locale:

     firebase init apphosting
     

  4. Quando richiesto, seleziona Collega a un backend esistente e scegli il backend denominato studio. In questo modo, l'URL della tua app rimarrà invariato.

  5. Segui le istruzioni per completare la configurazione. La configurazione di App Hosting verrà aggiunta a firebase.json.

  6. Esegui il deployment dell'applicazione:

     firebase deploy
     

• Hosting esterno:poiché il codice esportato è un'applicazione web standard, puoi inizializzarlo con qualsiasi provider di hosting. Tieni presente che il passaggio a un fornitore esterno comporterà un nuovo URL.

• Solo sviluppo locale:puoi continuare a sviluppare e testare la tua app localmente utilizzando Firebase Local Emulator Suite per test offline più rapidi senza il deployment in un ambiente live.

Risoluzione dei problemi e domande frequenti

Consulta le seguenti domande frequenti e i passaggi per la risoluzione dei problemi relativi alla migrazione dei tuoi progetti Firebase Studio.

Posso continuare a utilizzare Firebase Studio fino al ritiro?

Sì, puoi accedere agli spazi di lavoro esistenti fino al 22 marzo 2027. Continueremo a fornire patch di sicurezza critiche e aggiornamenti del modello Gemini per garantire la stabilità dei tuoi progetti attuali. Tieni presente che la creazione di nuovi spazi di lavoro verrà disabilitata a partire dal 22 giugno 2026.

Verrà eseguita la migrazione della cronologia chat del mio agente?

La cronologia chat dell'agente non fa parte del file ZIP esportato corrente. Tuttavia, puoi trovare i file della cronologia chat di Gemini per gli agenti App Prototyping agent e Gemini in Firebase all'interno del tuo workspace nella directory /home/user/.idx/ai del tuo workspace Firebase Studio. Contiene prompt e risposte di tutte le modalità di chat Gemini.

Ecco come creare un file ZIP contenente la cronologia:

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 .idx/ai e seleziona Comprimi e scarica.
4. Quando ti viene chiesto di ricreare l'ambiente, fai clic su Annulla.
5. Al termine del download, riapri la directory di lavoro dal menu File per tornare al tuo spazio di lavoro.

Per Prototyper sessions, you can also view your prompts as part of the git log. Here's how to locate them:

1. Apri la visualizzazione Codice ().

2. Esegui una delle seguenti operazioni:

   • Apri una sessione del terminale (Cmd-Shift-C su Mac o Ctrl-Shift-C su ChromeOS, Windows o Linux) e digita git log.
   • Apri Controllo della sorgente (Cmd+Shift+G su Mac o Ctrl-Shift+G su ChromeOS, Windows o Linux) e visualizza la cronologia della sorgente.

Ho provato a comprimere e scaricare i miei file in Firebase Studio, ma non è successo nulla.

Questo problema è in genere causato da un blocco dei popup del browser. Poiché il flusso di migrazione apre una nuova interfaccia per elaborare la tua richiesta, alcuni browser potrebbero segnalarla come popup indesiderato.

Per risolvere il problema, cerca la notifica "Popup bloccato" nella barra degli indirizzi del browser (di solito sul lato destro). Fai clic sull'icona e seleziona l'opzione per consentire i popup, quindi prova a fare di nuovo clic sul pulsante.

Se non funziona, segui le istruzioni riportate in Come faccio a scaricare i miei file da Firebase Studio? per eseguire il comando Zip and Download manualmente.

Posso eseguire la migrazione degli spazi di lavoro Firebase Studio che sono stati condivisi con me?

Solo la persona che ha creato lo spazio di lavoro Firebase Studio può utilizzare il pulsante Sposta ora. Se vuoi una copia del progetto, puoi procedere in uno dei seguenti modi:

• Duplica lo spazio di lavoro: crea una copia del progetto nel tuo account, in modo da poterlo collegare al tuo progetto Firebase e utilizzare gli strumenti di migrazione.
• Esporta manualmente il codice:dalla Vista codice, puoi aprire la tavolozza dei comandi (Cmd+Shift+P su Mac o Ctrl+Shift+P su ChromeOS, Windows o Linux) ed eseguire il comando Firebase Studio: Zip & Download.

Dove posso trovare le app di cui ho eseguito la migrazione a Google AI Studio?

La pagina Le tue app fornisce un elenco unificato di tutti i tuoi progetti, inclusi quelli creati da zero in Google AI Studio e quelli che hai eseguito la migrazione.

Firebase Authentication con Accedi con Google non funziona dopo la migrazione a Google AI Studio.

Se la tua app utilizza Accedi con Google, devi autorizzare il nuovo dominio del progetto.

1. Nella console Firebase, vai alla pagina delle impostazioni di Authentication.
2. Fai clic su Domini autorizzati.
3. Fai clic su Aggiungi dominio e aggiungi il dominio della tua app Google AI Studio.

Cosa devo fare se l'agente Google AI Studio smette di funzionare o se visualizzo errori in Google AI Studio dopo la migrazione?

Poiché l'agente Google AI Studio gestisce attività in background complesse durante la migrazione dell'app, a volte può riscontrare problemi come "attività annullata", messaggi ripetuti o thread che non rispondono.

• Se l'agente si interrompe a metà attività senza un errore chiaro, un prompt come "Continua da dove avevi interrotto" o "Prova di nuovo l'ultimo passaggio" spesso riavvia la procedura.
• Se viene visualizzato un messaggio che indica che si sono verificati errori durante l'esecuzione del codice, fai clic sul pulsante Correggi per chiedere all'agente di risolverli automaticamente.

Cosa succede se l'esportazione si blocca o scade?

Se il processo di migrazione si blocca durante la preparazione dei file, spesso è dovuto a una cartella del progetto di dimensioni eccessive.

Per preparare il terreno a una migrazione riuscita:

• Elimina node_modules: nell'ambito del processo di migrazione, questa cartella viene generalmente rimossa. Tuttavia, se l'hai rinominato o spostato oppure prevedi di comprimerlo e scaricarlo manualmente, eliminalo prima di avviare la migrazione. Non devi eseguire la migrazione di questa cartella perché puoi eseguire npm install dopo aver eseguito la migrazione al nuovo ambiente.
• Rimuovi gli artefatti di grandi dimensioni: elimina tutti i file multimediali di grandi dimensioni, le esportazioni di database o le cartelle di build che non sono strettamente necessari per il codice sorgente.
• Controlla la presenza di "bloat" nascosto: assicurati di non comprimere accidentalmente una cronologia .git o log locali di grandi dimensioni.

Dopo aver eliminato i file di grandi dimensioni, riprova a eseguire la migrazione del progetto.

Perché i miei comandi Firebase CLI o npx non vanno a buon fine nel terminale Antigravity?

Se riscontri errori "comando non trovato" o problemi durante l'esecuzione di comandi npx in Antigravity, anche se funzionano nel terminale di sistema standard, è probabile che il problema sia dovuto al modo in cui viene inizializzato l'ambiente shell.

L'ambiente terminale di Antigravity cerca le impostazioni di configurazione in ~/.bash_profile. Molti sviluppatori memorizzano le configurazioni di npx e dei percorsi in ~/.bashrc. Se queste impostazioni non vengono condivise, Antigravity non saprà dove trovare i tuoi strumenti.

Per risolvere il problema, recupera il file .bashrc all'interno di .bash_profile. In questo modo, tutte le configurazioni esistenti vengono caricate ogni volta che viene avviato Antigravity.

1. Apri il file ~/.bash_profile in Antigravity.

2. Aggiungi il seguente blocco di codice al file:

   if [ -f ~/.bashrc ]; then
       source ~/.bashrc
   fi
   

3. Salva il file.

4. Riavvia Antigravity.

Altre risorse

• Prova il Firebase Studio al codelab di migrazione di Antigravity.
• Esplora la documentazione di Antigravity.
• Esplora la documentazione di Google AI Studio.

Serve aiuto?

Se hai domande, feedback o riscontri problemi durante la migrazione dei tuoi progetti, contattaci in uno dei seguenti modi:

• Contatta l'assistenza Firebase.
• Pubblica un post nel forum della community Firebase Studio.