Installare un'estensione Firebase

Puoi installare (e gestire) qualsiasi delle estensioni Firebase ufficiali utilizzando la console Firebase, l'interfaccia a riga di comando Firebase o un SDK generato automaticamente.

Assicurati di esaminare le differenze tra le azioni supportate per ciascun metodo di installazione.



Per installare o gestire le estensioni, devi disporre di uno dei seguenti ruoli: Proprietario o Editor o Amministratore Firebase.

Per installare un'estensione, il progetto deve essere nel piano Blaze (pagamento a consumo). Anche se l'installazione di un'estensione è senza costi, potrebbe esserti addebitato il costo dell'utilizzo di servizi Firebase o Cloud come Cloud Secret Manager, se l'utilizzo supera il livello senza costi dei servizi.

Prima di iniziare

Se non l'hai ancora fatto, aggiungi Firebase al tuo progetto ed esegui l'upgrade del progetto Firebase al piano Blaze (pagamento in base al consumo).

Passaggio 1: visualizza le informazioni dettagliate su un'estensione

Questo passaggio è facoltativo, ma vivamente consigliato.

Prima di installare un Firebase Extension, ti consigliamo di consultare le informazioni dettagliate sull'estensione, tra cui:

  • Come funziona l'estensione, eventuali attività di preinstallazione e dettagli sull'estensione
  • Informazioni identificative generali e descrizione
  • Se le attività dell'estensione richiedono un account di fatturazione
  • Servizi Google (API) e ruoli di accesso necessari per il funzionamento
  • Risorse create per l'estensione (ad esempio funzioni)
  • Descrizioni dei parametri configurabili dall'utente

Per visualizzare le informazioni dettagliate di un'estensione:

  1. Sfoglia le estensioni ufficiali di Firebase in Extensions Hub.

  2. Fai clic sulla scheda di un'estensione per:

Passaggio 2: installa un'estensione

Durante il processo di installazione, ti verrà chiesto di rivedere le specifiche di base per l'estensione (ad esempio API abilitate, risorse create, accesso concesso e così via). Ti verranno comunicati eventuali requisiti di fatturazione e ti verrà anche chiesto di specificare i valori per i parametri configurabili dell'estensione.

  1. Sfoglia le estensioni ufficiali di Firebase in Extensions Hub.

  2. Fai clic sulla scheda di un'estensione, quindi esamina le informazioni dettagliate relative all'estensione, che possono offrire istruzioni di utilizzo specifiche e eventuali attività di preinstallazione.

  3. Fai clic su Installa, quindi segui le istruzioni sullo schermo per installare l'estensione.

Passaggio 3: completa la configurazione post-installazione

Alcune estensioni prevedono passaggi obbligatori o facoltativi che devi completare prima di utilizzarle. Puoi trovare queste istruzioni nella pagina dei dettagli post-installazione dell'estensione nella dashboard Extensions della console Firebase (il link specifico alla dashboard viene visualizzato nel terminale dopo l'installazione).

Puoi trovare queste istruzioni anche nel file POSTINSTALL.md incluso nella directory di origine dell'estensione.

Creare risorse Firebase

Se hai configurato l'estensione in modo che utilizzi risorse Firebase (Cloud Firestorecollezioni, Realtime Databasepercorsi, Cloud Storagebucket) che non esistono già, creale prima di utilizzare l'estensione.

Crea gestori di eventi Eventarc

Alcune estensioni pubblicano in Eventarc quando si verificano eventi importanti durante l'esecuzione. Se un'estensione pubblica eventi e li hai attivati durante l'installazione, puoi scrivere funzioni che reagiscono a questi eventi con la tua logica personalizzata. Questo può essere utile, ad esempio, per informare gli utenti al termine di attività che richiedono molto tempo o per eseguire il post-trattamento dell'output di una funzione di estensione.

Consulta la documentazione dell'estensione per un elenco degli eventuali eventi pubblicati dall'estensione. Ad esempio, consulta i tipi di evento per l'estensione Esegui pagamenti con Stripe.

Poi, consulta Trigger di eventi personalizzati per informazioni su come scrivere gestori di eventi Eventarc.

Installare più istanze di estensioni

Puoi installare la stessa estensione più di una volta nello stesso progetto. Ogni istanza installata può avere la propria configurazione personalizzata e le proprie risorse di estensione. Identifica e fai riferimento a ogni istanza installata utilizzando il suo ID istanza, che è univoco all'interno del progetto.

Ti verrà chiesto di confermare o modificare l'ID istanza di ogni istanza aggiuntiva dell'estensione che installi.

Passaggi successivi