Sie können alle offiziellen Firebase Erweiterungen entweder über die Firebase Konsole, die Firebase CLI (Befehlszeilenschnittstelle) oder ein automatisch generiertes SDK installieren und verwalten.
Beachten Sie die Unterschiede bei den unterstützten Aktionen für die einzelnen Installationsmethoden.
Zum Installieren oder Verwalten von Erweiterungen muss Ihnen eine der folgenden Rollen zugewiesen sein: Inhaber oder Bearbeiter oder Firebase-Administrator.
Ihr Projekt muss den Blaze -Tarif (nutzungsabhängige Bezahlung) haben, um eine Erweiterung installieren zu können. Die Installation einer Erweiterung ist zwar kostenlos, aber für die Nutzung von Firebase-Diensten oder Cloud-Diensten wie Cloud Secret Managerkönnen Gebühren anfallen, wenn Ihre Nutzung die kostenlose Stufe der Dienste übersteigt.
Hinweis
Schritt 1: Detaillierte Informationen zu einer Erweiterung ansehen
Dieser Schritt ist optional, wird aber dringend empfohlen.
Bevor Sie eine Firebase Extension installieren, sollten Sie sich detaillierte Informationen dazu ansehen, darunter:
- Funktionsweise der Erweiterung, Aufgaben vor der Installation und Details zur Erweiterung
- Allgemeine Informationen zur Identifizierung und Beschreibung
- Ob für die Aufgaben der Erweiterung ein Abrechnungskonto erforderlich ist
- Google-Dienste (APIs) und Zugriffsrollen, die für den Betrieb erforderlich sind
- Ressourcen, die für die Erweiterung erstellt wurden (z. B. Funktionen)
- Beschreibungen der vom Nutzer konfigurierbaren Parameter
So rufen Sie detaillierte Informationen zu einer Erweiterung auf:
Suchen Sie im Extensions Hub nach offiziellen Firebase Erweiterungen.
Klicken Sie auf die Karte einer Erweiterung, um Folgendes zu tun:
Detaillierte Informationen zur Erweiterung aufrufen
Den Link zum Quellcode der Erweiterung im Firebase Extensions Quellcode-Repository aufrufen
Im Erweiterungsverzeichnis der Erweiterung finden Sie diese detaillierten Informationen in der Datei
README.
Schritt 2: Erweiterung installieren
Während der Installation werden Sie aufgefordert, die grundlegenden Spezifikationen für die Erweiterung zu prüfen (z. B. aktivierte APIs, erstellte Ressourcen, gewährter Zugriff). Sie werden über alle Abrechnungsanforderungen informiert und aufgefordert, Werte für die konfigurierbaren Parameter der Erweiterung anzugeben.
Suchen Sie im Extensions Hub nach offiziellen Firebase Erweiterungen.
Klicken Sie auf die Karte einer Erweiterung und sehen Sie sich die detaillierten Informationen zur Erweiterung an. Dort finden Sie möglicherweise spezifische Nutzungsanweisungen und Aufgaben vor der Installation.
Klicken Sie auf Installieren und folgen Sie der Anleitung auf dem Bildschirm, um die Erweiterung zu installieren.
Schritt 3: Einrichtung nach der Installation abschließen
Bei einigen Erweiterungen müssen Sie vor der Verwendung erforderliche oder optionale Schritte ausführen. Diese Anweisungen finden Sie auf der Seite mit den Details nach der Installation der Erweiterung im Extensions Dashboard der Firebase Konsole. Der spezifische Link zum Dashboard wird nach der Installation im Terminal angezeigt.
Sie finden diese Anweisungen auch in der POSTINSTALL.md Datei im
Quellverzeichnis der Erweiterung.
Firebase-Ressourcen erstellen
Wenn Sie die Erweiterung so konfiguriert haben, dass sie Firebase-Ressourcen verwendet (Cloud Firestore Sammlungen, Realtime Database Pfade, Cloud Storage Buckets), die noch nicht vorhanden sind, erstellen Sie sie, bevor Sie die Erweiterung verwenden.
Eventarc-Event-Handler erstellen
Einige Erweiterungen veröffentlichen Ereignisse in Eventarc wenn während der Ausführung wichtige Ereignisse auftreten. Wenn eine Erweiterung Ereignisse veröffentlicht, und Sie Ereignisse während der Installation aktiviert haben, können Sie Funktionen schreiben, die mit Ihrer eigenen benutzerdefinierten Logik auf diese Ereignisse reagieren. Das kann beispielsweise nützlich sein, um Nutzer zu benachrichtigen, wenn zeitaufwendige Aufgaben abgeschlossen sind, oder um die Ausgabe einer Erweiterungsfunktion nachzubearbeiten.
In der Dokumentation der Erweiterung finden Sie eine Liste der Ereignisse, die sie veröffentlicht (falls vorhanden). Informationen zu den Ereignistypen für die Erweiterung „Run Payments with Stripe“
Unter Benutzerdefinierte Ereignistrigger finden Sie Informationen zum Schreiben von Eventarc-Event-Handlern.
Mehrere Erweiterungsinstanzen installieren
Sie können dieselbe Erweiterung mehrmals im selben Projekt installieren. Jede installierte Instanz kann eine eigene angepasste Konfiguration und eigene Erweiterungsressourcen haben. Sie identifizieren und verweisen auf jede installierte Instanz mit ihrer Instanz-ID, die innerhalb Ihres Projekts eindeutig ist.
Sie werden aufgefordert, die Instanz-ID jeder zusätzlichen Instanz der Erweiterung, die Sie installieren, zu bestätigen oder zu bearbeiten.
Nächste Schritte
Sehen Sie sich die Details und die Konfiguration Ihrer installierten Erweiterung in der Firebase Konsole an.
Behalten Sie die Aktivität Ihrer installierten Erweiterung im Blick, einschließlich Prüfungen des Status, der Nutzung und der Logs.
Verwalten Sie Ihre installierte Erweiterung mit der Firebase Konsole. Bei offiziellen Firebase Erweiterungen können Sie Ihre Erweiterung neu konfigurieren oder deinstallieren sowie auf die neueste Version aktualisieren.
Als Best Practice für alle Projekte sollten Sie Budgetbenachrichtigungen für Ihr Projekt einrichten und das Nutzung und Abrechnung Dashboard in der Firebase Konsole im Blick behalten.