Installa un'estensione Firebase

Puoi installare (e gestire ) qualsiasi estensione ufficiale di Firebase utilizzando la console Firebase o la CLI Firebase (interfaccia a riga di comando).

Assicurati di esaminare le differenze nelle azioni supportate per la CLI Firebase e la console Firebase.


Per installare o gestire le estensioni, è necessario che ti venga assegnato uno di questi ruoli: Proprietario o Editor o Amministratore Firebase .

Per installare un'estensione, il tuo progetto deve rientrare nel piano Blaze (pagamento in base al consumo). Sebbene non sia previsto alcun costo per l'installazione di un'estensione, ti potrebbe essere addebitato l'utilizzo dei servizi Firebase o dei servizi cloud come Cloud Secret Manager , se l'utilizzo supera il livello gratuito dei servizi.

Prima di iniziare

Se non l'hai già fatto, aggiungi Firebase al tuo progetto e aggiorna il tuo progetto Firebase al piano Blaze (pagamento in base al consumo).

Passaggio 1 : visualizza informazioni dettagliate su un'estensione

Questo passaggio è facoltativo, ma fortemente consigliato.

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

  • Come funziona l'estensione, eventuali attività di preinstallazione e dettagli sull'estensione
  • Informazioni generali identificative 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 (come funzioni)
  • Descrizioni dei parametri configurabili dall'utente

Per visualizzare le informazioni dettagliate di un'estensione:

  1. Sfoglia le estensioni ufficiali di Firebase nell'hub delle estensioni .

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

Passaggio 2 : installa un'estensione

Durante il processo di installazione, ti verrà richiesto di rivedere le specifiche di base dell'estensione (come API abilitate, risorse create, accesso concesso, ecc.). Ti verranno comunicati eventuali requisiti di fatturazione e ti verrà anche richiesto di specificare i valori per i parametri configurabili dell'estensione.

  1. Sfoglia le estensioni ufficiali Firebase nell'hub delle estensioni .

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

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

Passaggio 3 : completare la configurazione post-installazione

Alcune estensioni prevedono passaggi obbligatori o facoltativi da completare prima di utilizzarle. Trova queste istruzioni nella pagina dei dettagli post-installazione dell'estensione nel dashboard Estensioni della console Firebase (il collegamento specifico al dashboard viene visualizzato nel terminale dopo l'installazione).

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

Crea risorse Firebase

Se hai configurato l'estensione per utilizzare risorse Firebase (raccolte Cloud Firestore, percorsi Realtime Database, bucket Cloud Storage) che non esistono già, creale prima di utilizzare l'estensione.

Creare gestori di eventi Eventarc

Alcune estensioni pubblicano su Eventarc quando si verificano eventi importanti durante l'esecuzione. Se un'estensione pubblica eventi e hai abilitato gli eventi durante l'installazione, puoi scrivere funzioni che reagiscono a questi eventi con la tua logica personalizzata. Ciò può essere utile, ad esempio, per avvisare gli utenti quando vengono completate attività di lunga durata o per postelaborare l'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 .

Consulta quindi Trigger di eventi personalizzati per informazioni sulla scrittura dei gestori eventi Eventarc.

Installa più istanze di estensione

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. Identifichi e fai riferimento a ciascuna istanza installata utilizzando il relativo ID istanza , che è univoco all'interno del tuo progetto. Ti verrà richiesto di confermare o modificare l'ID istanza di ogni istanza aggiuntiva dell'estensione installata.

Prossimi passi