Puoi installare (e gestire) una qualsiasi delle estensioni Firebase ufficiali utilizzando la console Firebase, l'interfaccia a Firebase riga di comando di Firebase o un SDK generato automaticamente.
Assicurati di esaminare le differenze nelle azioni supportate per ogni metodo di installazione.
Per installare o gestire le estensioni, devi avere uno dei seguenti ruoli: Proprietario o Editor o Amministratore Firebase.
Per installare un'estensione, il progetto deve essere incluso nel piano Blaze (con pagamento a consumo). Sebbene l'installazione di un'estensione non comporti costi, potresti dover pagare per l'utilizzo dei servizi Firebase o dei servizi Cloud come Cloud Secret Manager, se il tuo utilizzo supera il livello senza costi dei servizi.
Prima di iniziare
Se non l'hai già fatto, aggiungi Firebase al tuo progetto ed esegui l'upgrade del tuo progetto Firebase al piano Blaze (con pagamento a consumo).
Passaggio 1: visualizza 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 di identificazione generali e descrizione
- Se le attività dell'estensione richiedono un account di fatturazione
- Servizi Google (API) e ruoli di accesso richiesti 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:
Sfoglia le estensioni Firebase ufficiali nell'Extensions Hub.
Fai clic sulla scheda di un'estensione per:
Visualizzare le informazioni dettagliate dell'estensione.
Trovare il link al codice sorgente dell'estensione nel Firebase Extensions repository del codice sorgente.
Nella directory dell'estensione dell'estensione, puoi visualizzare queste informazioni dettagliate nel file
README.
Passaggio 2: installa un'estensione
Durante la procedura di installazione, ti verrà chiesto di esaminare le specifiche di base dell'estensione (ad esempio API abilitate, risorse create, accesso concesso e così via). Ti verrà comunicato qualsiasi requisito di fatturazione e ti verrà chiesto di specificare i valori per i parametri configurabili dell'estensione.
Sfoglia le estensioni Firebase ufficiali nell'Extensions Hub.
Fai clic sulla scheda di un'estensione, quindi esamina le informazioni dettagliate dell' estensione, che possono offrire istruzioni di utilizzo specifiche ed eventuali attività di preinstallazione.
Fai clic su Installa, quindi segui le istruzioni sullo schermo per installare l'estensione.
Passaggio 3: completa la configurazione post-installazione
Alcune estensioni hanno passaggi obbligatori o facoltativi da completare prima di utilizzare le. Trova queste istruzioni nella pagina dei dettagli di post-installazione dell'estensione in the Extensions dashboard of the Firebase console (the specific link to the dashboard is displayed in the terminal after installation).
Puoi trovare queste istruzioni anche nel file POSTINSTALL.md incluso in
the directory del codice sorgente dell'estensione.
Crea risorse Firebase
Se hai configurato l'estensione in modo che utilizzi risorse Firebase (Cloud Firestore raccolte, Realtime Database percorsi, Cloud Storage bucket) che non esistono già, creale prima di utilizzare l'estensione.
Crea 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. Questo può essere utile, ad esempio, per inviare una notifica agli utenti quando le attività a lunga esecuzione vengono completate o per post-elaborare 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.
Poi, consulta Trigger di eventi personalizzati per informazioni sulla scrittura dei gestori di eventi Eventarc.
Installa più istanze dell'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 ogni istanza installata utilizzando il relativo 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
Visualizza i dettagli e la configurazione dell'estensione installata nella Firebase console.
Monitora l'attività dell'estensione installata, inclusi i controlli su integrità, utilizzo e log.
Utilizza la Firebase console, gestisci la tua estensione installata. Per le estensioni Firebase ufficiali, puoi riconfigurare o disinstallare l'estensione, nonché aggiornarla all'ultima versione.
Come best practice per tutti i progetti, assicurati di configurare gli avvisi di budget per il tuo progetto e di monitorare la dashboard Utilizzo e fatturazione nella console Firebase.