Ritiro di Firebase Studio e migrazione dei progetti

Firebase Studio verrà ritirato il 22 marzo 2027. Stiamo semplificando le nostre offerte per gli sviluppatori di AI applicando le lezioni apprese dall'anteprima di Firebase Studio ai 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 capacità agentiche direttamente nelle nostre piattaforme AI di punta, garantiamo 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.

Il motivo di questa modifica

Firebase Studio è stato lanciato in anteprima per esplorare il futuro dello sviluppo full-stack basato sull'AI. In base al tuo feedback, stiamo semplificando i nostri strumenti per fornire percorsi più chiari ed efficaci:

• Per lo sviluppo agentico incentrato sul codice: ci stiamo concentrando su Antigravity, la nostra piattaforma di nuova generazione progettata per Agentic Workflows autonomi ad alta velocità.

• Per una 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 servizi Firebase principali (Cloud Firestore, Authentication, App Hosting ecc.) non sono interessati. I tuoi database e i dati utente continueranno a funzionare normalmente. Questo ritiro si applica solo all'ambiente di sviluppo Firebase Studio.

Cronologia del ritiro

Stiamo offrendo un periodo di transizione di un anno per assicurarci che tu abbia tutto il tempo necessario per eseguire la migrazione dei 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 e la registrazione degli utenti sono disattivate. Puoi continuare a lavorare nei workspace esistenti ed eseguirne la migrazione.
• 22 marzo 2027: Firebase Studio verrà chiuso e tutti i dati rimanenti verranno eliminati definitivamente e non potranno essere recuperati.

Scegli il percorso di migrazione

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

Migrazione a Google Antigravity

Per un'esperienza di sviluppo agentico incentrata sul codice, ti consigliamo di eseguire la migrazione a Antigravity. Si tratta della nostra piattaforma di nuova generazione, incentrata sugli agenti, progettata per workflow autonomi ad alta velocità e orchestrazione multi-agente. Devi scegliere Antigravity se soddisfi uno dei seguenti criteri:

• Preferisci lavorare in un ambiente desktop incentrato sugli agenti con un controllo più approfondito della tua codebase utilizzando l'IDE Antigravity o il terminale
• Hai creato la tua app utilizzando un template integrato o un repository importato in Firebase Studio
• Utilizzare principalmente l'ambiente Vista codice in Firebase Studio
• Vuoi accedere direttamente a funzionalità di sviluppo di AI agentica allo stato dell'arte all'interno di un potente hub di agenti, con supporto per l'utilizzo di modelli diversi come Claude e GPT-OSS, oltre a Gemini
• Iniziato in modalità Prototyper, ma con l'aggiunta di funzionalità o script di esecuzione significativi che richiedono un ambiente locale senza limitazioni del cloud

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. Dovresti scegliere Google AI Studio se soddisfi uno dei seguenti criteri:

• Preferisci un'esperienza basata sul web, ideale per flussi di lavoro multi-dispositivo o ambienti in cui non puoi installare software locale
• 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 l'area di lavoro

1. Fai clic sul pulsante Sposta ora nella parte superiore dell'area di lavoro, quindi seleziona Preparati per AI Studio.
2. Al termine della fase di preparazione, fai clic su Sposta in Google AI Studio.
3. Se richiesto, leggi e accetta i Termini di servizio. Il codice si aprirà automaticamente in una nuova area di lavoro Google AI Studio.

La conversione e il caricamento della tua app da parte di Google AI Studio potrebbero richiedere diversi minuti. Riceverai una notifica al termine dell'operazione. Al termine, puoi continuare a eseguire l'iterazione della 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 in precedenza hai pubblicato 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 GitHub Sync:

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 riquadro 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 Prepara ed esegui il commit di 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 tuo repository, imposta il branch su main e la directory root su /.
   6. Fai clic su Salva ed esegui il deployment.

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

   1. In Google AI Studio, vai al riquadro GitHub.
   2. Esamina le modifiche da pubblicare.
   3. Fai clic su Prepara ed esegui il commit di tutte le modifiche.
   4. Vai alla consoleFirebase per monitorare l'avanzamento del deployment di App Hosting.

Opzione B: passa a Cloud Run e pubblica la tua app su un nuovo URL

Se preferisci un'esperienza con un solo clic e non hai pubblicato l'app in precedenza o non ti dispiace 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 dei progetti, fai clic su Importa progetto.
3. Cerca e seleziona il nome del progetto utilizzato da Firebase Studio (disponibile nella barra di navigazione in alto del tuo workspace Firebase Studio).
4. Fai clic su Importa e poi su Pubblica.

Esegui la migrazione delle app a Antigravity

Antigravity è una piattaforma locale agent-first e un hub di agenti che porta la potenza degli Agentic Workflows multi-agente nel tuo ambiente di sviluppo locale.

Prerequisiti

Assicurati di aver installato localmente e di aver aggiornato completamente quanto segue:

• IDE Google Antigravity: tra le opzioni di download, scegli Antigravity IDE (l'ambiente dell'editor). Questo è l'ambiente di lavoro code-first in cui aprirai ed eseguirai l'app di cui è stata eseguita la migrazione.
• 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

Dopo aver estratto il progetto e averlo aperto nell'IDE Antigravity, puoi visualizzare l'applicazione localmente:

1. Nell'IDE Antigravity, vai al menu Esegui e debug situato nella barra laterale 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 skill dell'agente per pubblicare la tua app utilizzando le best practice di Firebase.

1. Nel riquadro della chat dell'agente, 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à attraverso la procedura.

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

Esegui la migrazione delle app ad altre piattaforme

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

Passaggio 1: esporta l'origine del progetto

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

1. Fai clic sul pulsante Sposta ora nella parte superiore dell'area di lavoro > Comprimi e scarica.
2. Estrai l'archivio sulla tua macchina 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:

• CLI Firebase (mantiene l'URL esistente)

  1. Installa l'interfaccia a riga di comando Firebase utilizzando npm eseguendo questo comando:

     npm install -g firebase-tools
     

  2. Vai alla directory del progetto nel terminale.

  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 rimane invariato.

  5. Segui le istruzioni per completare la configurazione. La tua 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 host. Tieni presente che il passaggio a un provider esterno comporterà un nuovo URL.

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

Risoluzione dei problemi e domande frequenti

Consulta le seguenti domande comuni 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 dei modelli Gemini per garantire che i tuoi progetti attuali rimangano stabili. Tieni presente che la creazione di nuove aree di lavoro verrà disattivata a partire dal 22 giugno 2026.

La cronologia chat del mio agente verrà migrata?

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

Ecco come creare un file ZIP contenente la tua cronologia:

1. Seleziona File > Apri cartella.
2. Accetta la directory /home/user predefinita.
3. Dopo aver caricato i 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 all'area di lavoro.

Per le sessioni di Prototyper, puoi anche visualizzare i tuoi prompt come parte del log di git. Ecco come trovarli:

1. Apri la vista 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 del codice sorgente (Cmd+Shift+G su Mac o Ctrl-Shift+G su ChromeOS, Windows o Linux) e visualizza la cronologia del codice sorgente.

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

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

Per risolvere il problema, cerca una 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 manualmente il comando Comprimi e scarica.

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

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

• Duplica l'area 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: da 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: Comprimi e scarica.

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 di cui 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, occasionalmente 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 "Riprova l'ultimo passaggio" spesso riavvia il processo.
• 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 di progetto di dimensioni eccessive.

Per preparare il terreno per una migrazione di successo:

• Elimina node_modules: nell'ambito del processo di migrazione, questa cartella viene generalmente rimossa. Tuttavia, se lo hai rinominato o spostato o se prevedi di comprimere e scaricare manualmente il codice, eliminalo prima di avviare la migrazione. Non è necessario eseguire la migrazione di questa cartella perché puoi eseguire npm install una volta eseguito il passaggio 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 bloatware "nascosto": assicurati di non comprimere accidentalmente una cronologia .git o log locali di grandi dimensioni.

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

Perché i miei comandi dell'interfaccia a riga di comando Firebase o npx non vanno a buon fine nel terminale Antigravity?

Se riscontri errori "comando non trovato" o problemi durante l'esecuzione dei comandi npx all'interno di Antigravity, anche se funzionano nel terminale di sistema standard, è probabile che il problema sia dovuto alla modalità di inizializzazione dell'ambiente shell.

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

Puoi risolvere il problema eseguendo il sourcing del file .bashrc all'interno di .bash_profile. In questo modo, tutte le configurazioni esistenti vengono caricate all'avvio di 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 codelab sulla migrazione da Firebase Studio a 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 di Firebase Studio.