Pubblicare l'app con Firebase Studio

Firebase Studio offre diverse opzioni di pubblicazione, che ti consentono di scegliere il metodo più adatto alle esigenze del tuo progetto. Di seguito è riportata una panoramica delle opzioni disponibili:

  • Firebase App Hosting: ideale per la pubblicazione di applicazioni Next.js e Angular dinamiche, App Hosting offre supporto integrato per i framework, integrazione con GitHub e integrazione con altri prodotti Firebase come Firebase Authentication, Cloud Firestore e Firebase AI Logic.

    Se hai sviluppato un'app Next.js con l'agente di prototipazione delle appApp Prototyping agent, puoi pubblicarla direttamente da Firebase Studio in pochi clic.

  • Firebase Hosting: ideale per l'hosting di app web e contenuti web statici (HTML, CSS, JavaScript, immagini e altre risorse statiche) e app a pagina singola. Firebase Hosting offre una distribuzione rapida dei contenuti tramite una rete CDN globale, certificati SSL senza costi e supporto per domini personalizzati.

    Se hai sviluppato un'app web statica o a pagina singola in Firebase Studio, puoi pubblicarla direttamente da Firebase Studio chiedendo a Gemini di pubblicare l'app.

  • Cloud Run: Utilizza Cloud Run per eseguire il deployment di applicazioni containerizzate. È una buona scelta per la pubblicazione di applicazioni scalabili e portatili che possono essere eseguite su qualsiasi piattaforma.

  • Altre opzioni di deployment: esegui il deployment nella soluzione di hosting che preferisci, incluse altre piattaforme o il tuo server.

Pubblicare e monitorare l'app con Firebase App Hosting

Dopo aver testato l'app e averla trovata soddisfacente nell'area di lavoro, puoi pubblicarla sul web con Firebase App Hosting.

Quando configuri App Hosting, Firebase Studio crea un progetto Firebase per te (se non ne è già stato creato uno tramite la generazione automatica di una chiave Gemini API o di altri servizi di backend) e ti guida nel collegamento di un account Cloud Billing.

Per pubblicare l'app:

  1. Fai clic su Pubblica per configurare il tuo progetto Firebase e pubblicare l'app. Viene visualizzato il riquadro Pubblica la tua app.

  2. Nel passaggio Progetto Firebase, App Prototyping agent visualizza il progetto Firebase associato all'area di lavoro. Se non esiste già un progetto Firebase, il App Prototyping agent crea un nuovo progetto per te. Fai clic su Avanti per continuare.

  3. Nel passaggio Collega Cloud Billing account, scegli una delle seguenti opzioni:

    • Seleziona l'account Cloud Billing che vuoi collegare al progetto Firebase.

    • Se non hai un account Cloud Billing o vuoi crearne uno nuovo, fai clic su Crea un account Cloud Billing. Si apre la Google Cloud console, dove puoi creare un nuovo account self-service Cloud Billing. Dopo aver creato l'account, torna a Firebase Studio e seleziona l'account dall'elenco Collega Cloud Billing.

  4. Fai clic su Avanti. Firebase Studio collega l'account di fatturazione al progetto associato all'area di lavoro, creato quando hai generato automaticamente una Gemini API chiave o quando hai fatto clic su Pubblica.

  5. Fai clic su Configura servizi. Il App Prototyping agent inizia il provisioning dei servizi Firebase.

  6. Fai clic su Pubblica adesso. Firebase Studio configura i servizi Firebase e avvia l'implementazione di App Hosting rollout. Il completamento può richiedere diversi minuti. Per scoprire di più su cosa succede dietro le quinte, consulta Il processo di compilazione.App Hosting

  7. Al termine del passaggio di pubblicazione, viene visualizzata la Panoramica dell'app con un URL e insight sull'app basati sull'App Hosting osservabilità. Per utilizzare un dominio personalizzato (ad es. example.com o app.example.com) anziché il dominio generato da Firebase, puoi aggiungere un dominio personalizzato nella Firebase console.

Per saperne di più su App Hosting, consulta Informazioni su App Hosting e sul suo funzionamento.

(Cloud Firestore solo) Aggiungere indici e verificare le regole di sicurezza in produzione

Al termine della pubblicazione e dopo il deployment dell'app in Firebase, Cloud Firestore e Firebase Authentication sono pronti per essere testati in produzione.

Generare indici per il database Cloud Firestore

Quando esegui il deployment dell'app in Cloud Firestore, gli indici non vengono generati automaticamente. Ciò significa che, dopo la pubblicazione, potrebbe essere necessario generare indici per le query.

Potresti vedere questo problema nei messaggi di errore o nella console per gli sviluppatori del browser .

Per generare gli indici dopo la pubblicazione:

  1. Da un'app pubblicata:nel riquadro Panoramica dell'app (fai clic su Pubblica se non è visibile), individua e fai clic sul link Visita la tua app.

    Dall'anteprima Firebase Studio:apri la console per gli sviluppatori del browser e individua il messaggio di errore 200 generato da Cloud Firestore.

  2. Testa tutti i flussi all'interno dell'app. Potrebbe essere visualizzato un messaggio di errore simile a "Errore durante il caricamento delle ricette. La query richiede un indice. Puoi crearlo qui:" con un link alla Firebase console.

  3. Segui il link per accedere alla Firebase console e viene visualizzato un indice consigliato.

  4. Fai clic su Salva per accettare l'indice consigliato.

  5. Torna all'app e ricarica la pagina.

  6. Continua a testare tutti i flussi dell'app per aggiungere gli indici, se necessario.

Scopri di più su come gestire gli indici in Cloud Firestore.

Visualizzare i dati di Cloud Firestore e Firebase Authentication nella console Firebase

Dopo la pubblicazione, puoi visualizzare i dati in tempo reale della tua app nella console Firebase dopo.

  • Per visualizzare il database Cloud Firestore in tempo reale, apri la Firebase console e scegli Build > Database Firestore dal menu di navigazione.

    Da qui puoi ispezionare i dati archiviati, visualizzare e testare le regole di sicurezza e creare indici. Scopri di più su Cloud Firestore.

  • Per visualizzare i dati Firebase Authentication in tempo reale, apri la Firebase console e scegli Build > Authentication dal menu di navigazione.

    Da qui puoi ispezionare la configurazione di autenticazione e gli utenti dell'app. Scopri di più su Firebase Authentication.

Testare le regole di Cloud Firestore in produzione

Dopo aver pubblicato l'app, devi testare di nuovo le regole di sicurezza Cloud Firestore nell'ambiente di produzione. In questo modo, puoi assicurarti che i dati siano accessibili agli utenti autorizzati e protetti da accessi non autorizzati.

Puoi testare le regole utilizzando tutti i seguenti metodi:

  • Test dell'applicazione: interagisci con l'applicazione di cui hai eseguito il deployment, eseguendo operazioni che attivano vari pattern di accesso ai dati (letture, scritture, eliminazioni) per diversi ruoli o stati utente. Questo test in condizioni reali ti aiuta a verificare che le regole vengano applicate correttamente in pratica.

  • Playground regole: per controlli mirati, utilizza il Playground regole nella console Firebase. Questo strumento ti consente di simulare le richieste (letture, scritture, eliminazioni) nel tuo Cloud Firestore database utilizzando le regole di produzione. Puoi specificare lo stato di autenticazione dell'utente, il percorso dei dati e il tipo di operazione per verificare se le regole consentono o negano l'accesso come previsto.

  • Test delle unità: per test più completi, puoi scrivere test delle unità per le regole di sicurezza rules. Il backend di anteprima Firebase Studio basato su Firebase Local Emulator Suite ti consente di eseguire questi test in locale, simulando il comportamento delle regole di produzione. Questo è un modo efficace per verificare la logica delle regole complesse e confermare la copertura per vari scenari. Dopo il deployment, devi ricontrollare che i test delle unità che utilizzano l'emulatore funzionino come previsto e coprano tutti gli scenari.

Monitorare l'app con l'osservabilità App Hosting

Il riquadro Panoramica dell'app in Firebase Studio fornisce metriche e informazioni chiave sulla tua app, consentendoti di monitorare il rendimento della tua app web utilizzando App Hosting's built-in observability tools. Dopo l'implementazione del sito, puoi accedere alla panoramica facendo clic su Pubblica. Da questo riquadro puoi:

  • Fai clic su Pubblica per rilasciare una nuova versione dell'app.
  • Condividi il link alla tua app o apri l'app direttamente in Visita la tua app.
  • Esamina un riepilogo del rendimento dell'app negli ultimi 7 giorni, incluso il numero totale di richieste e lo stato dell'ultima implementazione. Fai clic su Visualizza dettagli per accedere a ulteriori informazioni nella Firebase console.
  • Visualizza un grafico del numero di richieste ricevute dall'app nelle ultime 24 ore, suddivise per codice di stato HTTP.
  • Visualizza lo stato di attivazione dei servizi Firebase come Firebase Authentication e Cloud Firestore.

Se chiudi il riquadro Panoramica dell'app, puoi riaprirlo in qualsiasi momento facendo clic su Pubblica.

Scopri di più sulla gestione e il monitoraggio delle implementazioni di App Hosting in Gestire implementazioni e release.

Eseguire il rollback del sito App Hosting

Se hai eseguito il deployment di versioni successive dell'app in App Hosting, puoi eseguire il rollback a una delle versioni precedenti. Puoi anche rimuoverla.

  • Per eseguire il rollback di un sito pubblicato:

    1. Apri App Hosting nella Firebase console.

    2. Individua il backend dell'app, fai clic su Visualizza e poi su Implementazioni.

    3. Accanto al deployment di cui vuoi eseguire il rollback, fai clic su Altro , scegli Esegui il rollback a questa build e conferma.

    Scopri di più in Gestire implementazioni e release.

  • Per rimuovere il dominio App Hosting dal web:

    1. Dalla Firebase console, apri App Hosting e fai clic su Visualizza nella sezione dell'app Firebase Studio.

    2. Nella sezione Informazioni sul backend, fai clic su Gestisci. Viene caricata la pagina Domini.

    3. Accanto al dominio, fai clic su Altro , scegli Disattiva dominio, e conferma.

    Il dominio viene rimosso dal web. Per rimuovere completamente il backend App Hosting, segui le istruzioni riportate in Eliminare un backend.

Firebase Hosting

Puoi pubblicare app web statiche e a pagina singola su Firebase Hosting da dalla tua area di lavoro Firebase Studio.

Se non disponi delle autorizzazioni del progetto Firebase richieste, chiedi a un proprietario del progetto Firebase di assegnarti il ruolo applicabile nella Firebase pagina Utenti e autorizzazioni della console Firebase. Se hai domande sull'accesso al progetto Firebase, inclusa la ricerca o l'assegnazione di un Proprietario, consulta Autorizzazioni e accesso ai progetti Firebase.

Pubblicare con l'assistenza di Gemini

  1. Nella chat con Gemini, inserisci un prompt come "Pubblica la mia app."

  2. Gemini ti guida nei passaggi necessari. Se non l'hai già fatto, potrebbe essere necessario includere la creazione di un progetto Firebase e la registrazione della tua app.

Pubblicare dal riquadro Firebase Studio

Firebase Hosting è ottimizzato per i siti statici e le applicazioni a pagina singola. Se il tuo progetto ha contenuti dinamico, Gemini potrebbe non avviare il flusso di pubblicazione. Se ciò accade, ma vuoi comunque utilizzare Firebase Hosting, pubblica il progetto dal Firebase Studio riquadro:

  1. Se non l'hai già fatto, crea un progetto Firebase e registra l'app.

  2. Apri l'area di lavoro Firebase Studio.

    • Se utilizzi il App Prototyping agent, fai clic Passa al codice per aprire la visualizzazione Code.Icona di un interruttore di codice
  3. Nel riquadro di navigazione, fai clic sull'icona Firebase Studio per aprire il riquadro, quindi espandi la sezione Firebase Hosting.

  4. Fai clic su Autentica Firebase e segui le istruzioni nella finestra del terminale per autenticare il tuo account Firebase.

  5. Fai clic su Inizializza Firebase Hosting e segui le istruzioni nella finestra del terminale per configurare il deployment.

  6. Per eseguire il deployment dell'app, fai clic su Esegui il deployment in produzione o Esegui il deployment nel canale nella sezione Firebase Hosting del Firebase Studio riquadro.

Cloud Run

Prima di eseguire il deployment utilizzando Cloud Run, assicurati di configurare un Google Cloud progetto e di attivare Cloud Billing.

  1. Apri l'area di lavoro Firebase Studio. Se utilizzi il App Prototyping agent, fai clic Passa al codice per aprire la visualizzazione Code.Icona di un interruttore di codice

  2. Fai clic sull'icona Firebase Studio nel riquadro di navigazione per aprire il riquadro Firebase Studio e fai clic su Esegui il deployment in Cloud Run.

  3. Seleziona Consenti a questa area di lavoro di accedere alle risorse Google Cloud utilizzando il mio Account Google e poi seleziona un progetto Google Cloud con la fatturazione attivata dalle finestre di dialogo.

  4. Fai clic su Autentica nella sezione Cloud Run del Firebase Studio riquadro e segui le istruzioni per l'autenticazione.

  5. Fai clic su Esegui il deployment e segui le istruzioni per configurare il deployment ed eseguire il deployment dell'app.

Passaggi successivi