Auf dieser Seite finden Sie kurze Übersichten zu einigen wichtigen Konzepten im Zusammenhang mit Firebase-Projekten. Folgen Sie den Links, um detailliertere Informationen zu Funktionen, Diensten, Tools und Best Practices zu erhalten.
Beziehung zwischen Firebase-Projekten, ‑Apps und ‑Produkten
Ein Firebase-Projekt ist die Entität der obersten Ebene 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 Leitfaden für den Einstieg
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. die iOS- und Android-Versionen einer App oder die kostenlose und die kostenpflichtige Version einer App.
Alle Firebase-Apps, die im selben Firebase-Projekt registriert sind, nutzen dieselben Ressourcen und Dienste, die für das Projekt bereitgestellt werden, 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 damit im Hintergrund ein Google Cloud project. Sie können auch zuerst ein Google Cloud Projekt erstellen, dann später Firebase hinzufügen. Ein Google Cloud Projekt ist ein virtueller Container für Daten, Code, Konfigurationen und Dienste.
Konfigurationen und Dienste aktiviert wurden.Google CloudFür alle Firebase-Projekte fügt Firebase Ihrem Projekt automatisch
das Label firebase:enabled auf der Seite IAM und Verwaltung >
Labels
in der Google Cloud Console hinzu. Weitere Informationen zu diesem Label finden Sie in den
FAQs.
Da ein Firebase-Projekt ist ein Google Cloud Projekt:
Sie können in der Firebase Console sowie in der Google Cloud Console und Google APIs Console auf das Projekt zugreifen und damit interagieren.
Sie können mit dem Projekt über die Firebase CLI, die gcloud CLI, und jede Terraform-Ressource von Google interagieren.
Sie können Produkte und APIs von Firebase und Google Cloud im Projekt verwenden.
IAM-Berechtigungen und ‑Rollen für das Projekt werden von Firebase und Google Cloudgemeinsam genutzt. Jeder Zugriff, den ein Projektmitglied (d. h. ein Prinzipal) auf Ihr Google Cloud Projekt hat, 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 Firebase-Preismodell „Blaze“ (Pay as you go) angewendet.
Eindeutige Kennungen für das Projekt (z. B. Projektnummer und Projekt-ID) werden von Firebase und Google Cloudgemeinsam genutzt.
Jede Ressourcenhierarchie die auf Ihr Google Cloud Projekt angewendet wird (z. B. Organisation, Ordner, usw.) gilt 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 für Firebase und 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 Entwicklungs-Workflow einrichten, der in der Regel die Verwendung mehrerer Umgebungen umfasst. In unserer Dokumentation zu Entwickler-Workflowsfinden Sie allgemeine Best Practices und allgemeine Sicherheitsrichtlinien für das Einrichten von Firebase-Projekten und das Registrieren von Apps, mit denen Sie Ihren Entwicklungs- Workflow erstellen können.
Mit einem Firebase-Projekt interagieren
Neben den Produkt-SDKs können Sie mit verschiedenen Tools und Oberflächen direkt mit einem Firebase-Projekt interagieren.
Firebase console
Die Firebase Console bietet die umfassendste Umgebung für die Verwaltung von Firebase Produkten, ‑Apps und ‑Einstellungen auf Projektebene.
Im linken Bereich der Console sind die Firebase-Produkte nach Kategorien der obersten Ebene geordnet. Klicken Sie oben im linken Bereich auf
In der Mitte der Console werden Schaltflächen angezeigt, mit denen Sie Einrichtungsworkflows starten können, um verschiedene Arten von Apps zu registrieren. Nachdem Sie Firebase verwenden, ändert sich der Hauptbereich der Console in ein Dashboard mit Statistiken zu den von Ihnen verwendeten Produkten.
Da ein Firebase-Projekt auch ein Google Cloud Projekt ist, müssen Sie möglicherweise für verschiedene Aufgaben oder Produkte die Google Cloud Konsole anstelle der Firebase Konsole verwenden.
Firebase CLI (Befehlszeilentool)
Firebase bietet auch die Firebase CLI zum Konfigurieren und Verwalten bestimmter Firebase-Produkte wie Firebase Hosting, Cloud Functions for Firebase und Firebase Extensions.
Nach der Installation der Firebase CLI haben Sie Zugriff auf den
globalen Befehl firebase. Verwenden Sie die
Firebase CLI, um
Ihr lokales App-Verzeichnis mit einem Firebase-Projekt zu verknüpfen,
dann neue Versionen von in Firebase gehosteten Inhalten oder
Updates für Funktionen bereitzustellen.
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 in einem Projekt registrieren oder die bereits registrierten Apps auflisten (iOS+ | Android | Web).
Firebase-Projektkennungen
Ein Firebase-Projekt kann im Firebase-Back-End und in verschiedenen Entwickleroberflächen mit verschiedenen Kennungen identifiziert werden, darunter der Projektname, die Projektnummer und die Projekt-ID.
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 CLI. Der Projektname wird in keinem öffentlich sichtbaren Firebase- oder Google Cloud Produkt, ‑Dienst oder ‑Ressource angezeigt. Er dient lediglich dazu, mehrere Projekte leichter zu unterscheiden.
Sie können einen Projektnamen jederzeit im oberen Bereich des
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 nie wieder von einem anderen Projekt verwendet werden.
Projekt-ID
Ein Firebase-Projekt (und das zugehörige Google Cloud Projekt) hat eine Projekt-ID. Dies ist eine vom Nutzer definierte 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 jedoch während der Einrichtung des Projekts bearbeiten. Diese Kennung dient in der Regel als praktischer Alias, um auf das Projekt zu verweisen.
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, das 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.
Eine Firebase-Konfigurationsdatei oder ein Firebase-Konfigurationsobjekt verknüpft eine App mit einem bestimmten Firebase-Projekt und seinen Ressourcen (Datenbanken, Speicher-Buckets usw.). Die Konfiguration enthält „Firebase-Optionen“. Das sind Parameter, die von Firebase- und Google-Diensten benötigt werden, um mit den Firebase-Server-APIs zu kommunizieren und Clientdaten mit dem Firebase-Projekt und der Firebase-App zu verknüpfen. Hier sind die erforderlichen Mindestoptionen für Firebase:
API-Schlüssel: Ein einfach verschlüsselter String, der beim Aufrufen bestimmter APIs verwendet wird, die nicht auf private Nutzerdaten zugreifen müssen (Beispielwert:
AIzaSyDOCAbC123dEf456GhI789jKl012-MnO).Projekt-ID: Eine vom Nutzer definierte 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 Ihr Projekt zu verweisen. (Beispielwert:
myapp-project-123)Anwendungs-ID („App-ID“): Die eindeutige Kennung für die Firebase-App in Firebase 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. Verwenden Sie daher Firebase Security Rules , um Ihre Daten und Dateien in Realtime Database, Cloud Firestore, und Cloud Storage zu schützen.
Für Open-Source-Projekte empfehlen wir in der Regel nicht, die Firebase-Konfigurationsdatei oder das Firebase-Konfigurationsobjekt der App in die Quellcodeverwaltung aufzunehmen, da Ihre Nutzer in den meisten Fällen eigene 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)
- Tarif „Spark“: Das Kontingent für die Projekterstellung ist auf eine kleine Anzahl von Projekten begrenzt (in der Regel etwa 5 bis 10).
- Blaze-Preismodell: Das Kontingent für die Projekterstellung ist weiterhin begrenzt, kann aber durch die Verknüpfung eines Cloud Billing Kontos mit gutem Status erhöht werden.
Beachten Sie Folgendes zum Limit für das Kontingent für die Projekterstellung:
- Dieses Limit gilt nicht nur für Firebase. Die Limits für das Projektkontingent von Firebase sind dieselben wie für Google Cloud.
- In seltenen Fällen können Sie eine Erhöhung des Projektkontingents beantragen.
- Das vollständige Löschen eines Projekts dauert 30 Tage und wird auf das Projektkontingent angerechnet, bis das Projekt vollständig gelöscht ist.
Weitere Informationen zu den empfohlenen allgemeinen Best Practices von Firebase für das Einrichten von Firebase-Projekten.
Anzahl der Apps pro Projekt
Firebase beschränkt die Gesamtzahl der Firebase-Apps in einem Firebase-Projekt auf 30.
Alle Firebase-Apps in einem einzelnen Firebase-Projekt sollten aus Sicht des Endnutzers Plattformvarianten derselben Anwendung sein. Weitere Informationen zur Mehrinstanzenfähigkeit finden Sie in unserer Dokumentation zu Best Practices.
Weitere Informationen zum Limit für Apps pro Projekt finden Sie in den FAQs.
Anzahl der Hosting Websites pro Projekt
Die Firebase Hosting Funktion für mehrere Websites unterstützt maximal 36 Websites pro Projekt.
App starten
- Richten Sie Budget benachrichtigungen für Ihr Projekt in der Google Cloud Console ein.
- Auf dem Nutzung und Abrechnung Dashboard in der Firebase Console erhalten Sie einen Überblick über die Nutzung Ihres Projekts in mehreren Firebase-Diensten.
- Prüfen Sie die Firebase-Start-Checkliste.