Auf dieser Seite finden Sie kurze Übersichten über mehrere wichtige Konzepte im Zusammenhang mit Firebase-Projekten. Wenn verfügbar, folgen Sie den Links, um weitere Informationen zu Funktionen, Diensten, Tools und Best Practices zu erhalten.
Beziehung zwischen Firebase-Projekten, ‑Apps und ‑Produkten
Ein Firebase-Projekt ist die übergeordnete Entität für Firebase. In einem Projekt können Sie Ihre Apple-, Android- oder Web-Apps registrieren. Nachdem Sie Ihre Apps bei Firebase registriert haben, können Sie die Firebase SDKs für eine beliebige Anzahl von Firebase-Produkten hinzufügen, z. B. Analytics, Cloud Firestore, Performance Monitoring oder Remote Config.
Weitere Informationen zu diesem Prozess finden Sie im Startleitfaden für Ihre Plattform:
iOS+ | Android |
Web | Unity | C++ |
Flutter.
Hierarchie von Firebase-Projekten
Dieses Diagramm zeigt die grundlegende Hierarchie eines Firebase-Projekts. Hier sind die wichtigsten Beziehungen:
Ein Firebase-Projekt ist wie ein Container für alle Ihre Apps und alle Ressourcen und Dienste, die für das Projekt bereitgestellt werden.
In einem Firebase-Projekt können eine oder mehrere Firebase-Apps registriert sein, z. B. sowohl die iOS- als auch die Android-Version einer App oder sowohl die kostenlose als auch die kostenpflichtige Version einer App.
Alle Firebase-Apps, die im selben Firebase-Projekt registriert sind, teilen sich alle Ressourcen und Dienste, die für das Projekt bereitgestellt wurden, und haben Zugriff darauf. Hier einige Beispiele:
Alle Firebase-Apps, die im selben Firebase-Projekt registriert sind, nutzen dieselben Back-Ends, z. B. Firebase Hosting, Authentication, Realtime Database, Cloud Firestore, Cloud Storage und Cloud Functions.
Alle Firebase-Apps, die im selben Firebase-Projekt registriert sind, sind mit derselben Google Analytics-Property verknüpft. Jede Firebase-App ist ein separater Datenstream in dieser Property.
Beziehung zwischen Firebase-Projekten und Google Cloud
Wenn Sie ein neues Firebase-Projekt erstellen, erstellen Sie im Hintergrund ein Google Cloud-Projekt. Sie können auch zuerst ein Google Cloud-Projekt erstellen und Firebase später hinzufügen. Sie können sich ein Google Cloud-Projekt als virtuellen Container für Daten, Code, Konfiguration und Dienste vorstellen.
Beachten Sie, dass Firebase für alle Firebase-Projekte automatisch ein Label mit dem Wert firebase:enabled auf der Seite IAM & Verwaltung > Labels der Google Cloud Console hinzufügt. Weitere Informationen zu diesem Label finden Sie in den FAQs.
Da ein Firebase-Projekt ein Google Cloud-Projekt ist, gilt Folgendes:
Sie können in der Firebase Console, der Google Cloud Console und der Google APIs Console auf das Projekt zugreifen und damit interagieren.
Sie können mit dem Projekt über die Firebase-Befehlszeile, die gcloud CLI und jede Terraform-Ressource von Google interagieren.
Sie können im Projekt Produkte und APIs von Firebase und Google Cloud verwenden.
IAM-Berechtigungen und -Rollen für das Projekt werden von Firebase und Google Cloud gemeinsam genutzt. Der Zugriff eines Projektmitglieds (also eines Hauptkontos) auf Ihr Google Cloud-Projekt gilt auch für Ihr Firebase-Projekt (und umgekehrt).
Die Abrechnung für das Projekt wird von Firebase und Google Cloud gemeinsam genutzt. Wenn die Abrechnung für Ihr Google Cloud-Projekt aktiviert ist, wird für Ihr Firebase-Projekt das Blaze-Preismodell (Pay as you go) von Firebase verwendet.
Eindeutige Kennungen für das Projekt (z. B. Projektnummer und Projekt-ID) werden von Firebase und Google Cloud gemeinsam genutzt.
Alle Ressourcenhierarchien, die auf Ihr Google Cloud-Projekt angewendet werden (z. B. Organisation, Ordner usw.), gelten auch für Ihr Firebase-Projekt.
Wenn Sie das Projekt löschen, wird es in Firebase und Google Cloud gelöscht.
Wenn Sie eine Ressource oder Daten im Projekt löschen oder ändern, gilt das sowohl für Firebase als auch für Google Cloud.
Firebase-Projekt einrichten und Apps registrieren
Sie können ein Firebase-Projekt einrichten und Apps in der Firebase Console registrieren. Für erweiterte Anwendungsfälle können Sie auch die Firebase Management REST API oder die Firebase-CLI verwenden. Wenn Sie ein Projekt einrichten und Apps registrieren, müssen Sie einige organisatorische Entscheidungen treffen und Ihren lokalen Projekten Firebase-spezifische Konfigurationsinformationen hinzufügen.
Für Produktions-Apps müssen Sie einen klaren Entwicklungsworkflow einrichten, der in der Regel die Verwendung mehrerer Umgebungen umfasst. Lesen Sie unsere Dokumentation zu Entwickler-Workflows, einschließlich allgemeiner Best Practices und allgemeiner Sicherheitsrichtlinien zum Einrichten von Firebase-Projekten und Registrieren von Apps, um Ihren Entwicklungs-Workflow zu erstellen.
Mit einem Firebase-Projekt interagieren
Neben den Produkt-SDKs können Sie über verschiedene Tools und Schnittstellen direkt mit einem Firebase-Projekt interagieren.
Firebase-Konsole
Die Firebase Console bietet die umfangreichste Umgebung zum Verwalten von Firebase-Produkten, ‑Apps und Einstellungen auf Projektebene.
Im linken Bereich der Console werden die Firebase-Produkte nach übergeordneten Kategorien aufgelistet. Klicken Sie oben im linken Bereich auf
In der Mitte der Console werden Schaltflächen angezeigt, mit denen Sie Einrichtungs-Workflows zum Registrieren verschiedener Arten von Anwendungen starten können. Nachdem Sie Firebase verwendet haben, ändert sich der Hauptbereich der Console in ein Dashboard, in dem Statistiken zu den von Ihnen verwendeten Produkten angezeigt werden.
Da ein Firebase-Projekt auch ein Google Cloud-Projekt ist, kann es sein, dass Sie für verschiedene Aufgaben oder Produkte die Google Cloud Console anstelle der Firebase Console verwenden müssen.
Firebase-Befehlszeile (ein Befehlszeilentool)
Firebase bietet auch die Firebase-Befehlszeile zum Konfigurieren und Verwalten bestimmter Firebase-Produkte wie Firebase Hosting, Cloud Functions for Firebase und Firebase Extensions.
Nach der Installation der Firebase-Befehlszeile haben Sie Zugriff auf den globalen firebase-Befehl. Verwenden Sie die Firebase-Befehlszeile, um Ihr lokales App-Verzeichnis mit einem Firebase-Projekt zu verknüpfen. Anschließend können Sie neue Versionen von in Firebase gehosteten Inhalten oder Aktualisierungen von Funktionen bereitstellen.
Firebase Management REST API
Mit der Firebase Management REST API können Sie ein Firebase-Projekt programmatisch verwalten. Sie können beispielsweise eine App programmatisch bei einem Projekt registrieren oder die bereits registrierten Apps auflisten (iOS+ | Android | Web).
Firebase-Projektkennungen
Ein Firebase-Projekt kann im Firebase-Backend und in verschiedenen Entwicklerschnittstellen anhand verschiedener Kennungen identifiziert werden, darunter der Projektname, die Projektnummer und die Projekt-ID.
Der Projektname
Wenn Sie ein Projekt erstellen, geben Sie einen Projektnamen an. Diese Kennung ist der nur intern verwendete Name für ein Projekt in der Firebase Console, der Google Cloud Console und der Firebase-Befehlszeile. Der Projektname wird in keinem öffentlich sichtbaren Firebase- oder Google Cloud-Produkt, -Dienst oder -Ressource angezeigt. Er dient lediglich dazu, mehrere Projekte leichter voneinander zu unterscheiden.
Sie können einen Projektnamen jederzeit im oberen Bereich der Firebase-Console auf dem Tab
Die Projektnummer
Ein Firebase-Projekt (und das zugehörige Google Cloud-Projekt) hat eine Projektnummer. Dies ist die von Google zugewiesene, global eindeutige kanonische Kennung für das Projekt. Sie können sie für das Konfigurieren von Integrationen und/oder zum Senden von API-Aufrufen an Firebase, Google oder Drittanbieterdienste verwenden.
Sie können eine Projektnummer nicht bearbeiten. Wenn Sie ein Projekt löschen, wird auch die Projektnummer gelöscht und kann von keinem anderen Projekt mehr verwendet werden.
Projekt-ID
Ein Firebase-Projekt (und das zugehörige Google Cloud-Projekt) hat eine Projekt-ID. Dies ist eine benutzerdefinierte eindeutige Kennung für das Projekt in Firebase und Google Cloud. Wenn Sie ein Firebase-Projekt erstellen, weist Firebase dem Projekt automatisch eine eindeutige ID zu. Sie können diese ID jedoch während der Projekteinrichtung bearbeiten. Diese Kennung sollte im Allgemeinen als praktischer Alias für das Projekt behandelt werden.
Firebase-Konfigurationsdateien und -objekte
Wenn Sie eine App in einem Firebase-Projekt registrieren, stellt die Firebase-Konsole eine Firebase-Konfigurationsdatei (Apple-/Android-Apps) oder ein Konfigurationsobjekt (Web-Apps) bereit, die Sie direkt Ihrem lokalen App-Verzeichnis hinzufügen.
- Für Apple-Apps fügen Sie eine
GoogleService-Info.plist-Konfigurationsdatei hinzu. - Für Android-Apps fügen Sie eine
google-services.json-Konfigurationsdatei hinzu. - Für Web-Apps fügen Sie ein Firebase-Konfigurationsobjekt hinzu.
Sie können jederzeit die Firebase-Konfigurationsdatei oder das Firebase-Konfigurationsobjekt einer App abrufen.
Eine Firebase-Konfigurationsdatei oder ein Firebase-Konfigurationsobjekt verknüpft eine App mit einem bestimmten Firebase-Projekt und seinen Ressourcen (Datenbanken, Storage-Buckets usw.). Die Konfiguration umfasst „Firebase-Optionen“. Das sind Parameter, die von Firebase- und Google-Diensten benötigt werden, um mit Firebase-Server-APIs zu kommunizieren und Clientdaten mit dem Firebase-Projekt und der Firebase-App zu verknüpfen.
Hier sind die mindestens erforderlichen „Firebase-Optionen“:
Firebase API-Schlüssel: Ein eindeutiger String, der verwendet wird, um Anfragen an Ihr Firebase-Projekt weiterzuleiten. Dieser API-Schlüssel sollte nur für Firebase-bezogene APIs verwendet werden. (Beispielwert:
AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)Firebase-Projekt-ID: Eine benutzerdefinierte, global eindeutige Kennung für das Projekt in Firebase und Google Cloud. Diese Kennung kann in URLs oder Namen für einige Firebase-Ressourcen verwendet werden. Generell dient sie aber als praktischer Alias, um auf das Projekt zu verweisen. (Beispielwert:
myapp-project-123)Firebase-Anwendungs-ID („App-ID“): Die global eindeutige Kennung für die Firebase-App in ganz Firebase und Google Cloud mit einem plattformspezifischen Format:
- Firebase-Apple-Apps:
GOOGLE_APP_ID(Beispielwert:1:1234567890:ios:321abc456def7890)
Dies ist keine Apple-Paket-ID. - Firebase-Android-Apps:
mobilesdk_app_id(Beispielwert:1:1234567890:android:321abc456def7890)
Dies ist kein Android-Paketname oder keine Android-Anwendungs-ID. - Firebase-Web-Apps:
appId(Beispielwert:1:65211879909:web:3ae38ef1cdcb2e01fe5f0c)
- Firebase-Apple-Apps:
Der Inhalt der Firebase-Konfigurationsdatei oder des Firebase-Konfigurationsobjekts gilt als öffentlich, einschließlich der plattformspezifischen ID der App (Apple-Bundle-ID oder Android-Paketname) und der Firebase-projektspezifischen Werte wie API-Schlüssel, Projekt-ID, Realtime Database-URL und Cloud Storage-Bucket-Name. Daher sollten Sie Firebase Security Rules verwenden, um Ihre Daten und Dateien in Realtime Database, Cloud Firestore und Cloud Storage zu schützen.
Bei Open-Source-Projekten empfehlen wir im Allgemeinen nicht, die Firebase-Konfigurationsdatei oder das Firebase-Konfigurationsobjekt der App in die Versionsverwaltung aufzunehmen, da Ihre Nutzer in den meisten Fällen ihre eigenen Firebase-Projekte erstellen und ihre Apps auf ihre eigenen Firebase-Ressourcen verweisen sollten (über ihre eigene Firebase-Konfigurationsdatei oder ihr eigenes Firebase-Konfigurationsobjekt).
Allgemeine Limits für Firebase-Projekte, ‑Apps und ‑Websites
Hier sind einige allgemeine Limits für Firebase-Projekte, ‑Apps und ‑Websites:
Anzahl der Projekte pro Google-Konto (E-Mail-Adresse)
- Spark-Preismodell: Das Kontingent für die Projekterstellung ist auf eine kleine Anzahl von Projekten beschränkt (normalerweise etwa 5–10).
- Blaze-Preismodell: Das Kontingent für die Projekterstellung ist weiterhin begrenzt, kann sich aber durch die Verknüpfung eines einwandfreien Cloud Billing-Kontos erhöhen.
Beachten Sie Folgendes bezüglich des Limits für das Kontingent zur Projekterstellung:
- Dieses Limit gilt nicht nur für Firebase. Die Limits von Firebase für das Projektkontingent sind mit denen für Google Cloud identisch.
- In seltenen Fällen können Sie eine Erhöhung des Projektkontingents anfordern.
- Das vollständige Löschen eines Projekts dauert 30 Tage und wird auf das Projektkontingent angerechnet, bis das Projekt vollständig gelöscht ist.
Allgemeine Best Practices für die Einrichtung von Firebase-Projekten
Anzahl der Apps pro Projekt
Firebase beschränkt die Gesamtzahl der Firebase-Apps in einem Firebase-Projekt auf 30.
Sie sollten darauf achten, dass alle Firebase-Apps in einem Firebase-Projekt Plattformvarianten derselben Anwendung aus Sicht des Endnutzers sind. Weitere Informationen zur Mehrmandantenfähigkeit finden Sie in unseren Best Practices-Dokumenten.
Weitere Informationen zum Limit für Apps pro Projekt finden Sie in den FAQs.
Anzahl der Hosting-Standorte pro Projekt
Das Firebase Hosting-Multisite-Feature unterstützt maximal 36 Standorte pro Projekt.
App starten
- Richten Sie in der Google Cloud-Konsole Budgetbenachrichtigungen für Ihr Projekt ein.
- Im Dashboard „Nutzung und Abrechnung“ in der Firebase-Konsole können Sie sich einen Überblick über die Nutzung Ihres Projekts in mehreren Firebase-Diensten verschaffen.
- Sehen Sie sich die Checkliste für die Einführung von Firebase an.