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 nelle 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). Sebbene l'installazione di un'estensione non sia a pagamento, ti potrebbe essere addebitato l'utilizzo dei servizi Firebase o Cloud come Cloud Secret Manager, se il tuo utilizzo supera il livello senza costi dei servizi.

Prima di iniziare

Se non lo hai già fatto, aggiungi Firebase al tuo progetto ed esegui l'upgrade al piano Blaze (pagamento a 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 esaminare le informazioni dettagliate sull'estensione, tra cui:

  • Come funziona l'estensione, eventuali attività di preinstallazione e dettagli sull'estensione
  • Informazioni generali di identificazione e descrizione
  • Indica 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 la procedura di installazione, ti verrà chiesto di esaminare le specifiche di base dell'estensione (ad esempio le API abilitate, le risorse create, l'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

Per alcune estensioni devi completare passaggi obbligatori o facoltativi prima di poterle utilizzare. Trova queste istruzioni nella pagina dei dettagli post-installazione dell'estensione nella dashboard di 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 Firestore collezioni, Realtime Database percorsi, Cloud Storage bucket) 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 eventi (se presenti) che pubblica. Ad esempio, consulta i tipi di eventi 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