Informationen zu Firebase-Projekten

Auf dieser Seite finden Sie eine kurze Übersicht über einige wichtige Konzepte für Firebase-Projekte. Wenn verfügbar, 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 oberste 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 beliebig viele Firebase-Produkte 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

Diagramm mit der grundlegenden Hierarchie eines Firebase-Projekts, einschließlich des Projekts, der registrierten Apps sowie der bereitgestellten Ressourcen und Dienste 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 für das Projekt bereitgestellten Ressourcen und Dienste.

  • Bei 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 für dasselbe Firebase-Projekt registriert sind, teilen sich die für das Projekt bereitgestellten Ressourcen und Dienste und haben Zugriff darauf. Hier sind einige Beispiele:

    • Alle Firebase-Apps, die für dasselbe Firebase-Projekt registriert sind, verwenden dieselben Backends, z. B. Firebase Hosting, Authentication, Realtime Database, Cloud Firestore, Cloud Storage und Cloud Functions.

    • Alle Firebase-Apps, die mit demselben Firebase-Projekt registriert sind, sind mit derselben Google Analytics-Property verknüpft. Dabei ist jede Firebase-App 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 dann später hinzufügen. Sie können sich ein Google Cloud-Projekt als virtuellen Container für Daten, Code, Konfiguration und Dienste vorstellen.

Für alle Firebase-Projekte wird in der Google Cloud Console auf der Seite Labels automatisch das Label firebase:enabled für Ihr Projekt hinzugefügt. Weitere Informationen zu diesem Label findest du in unseren FAQs.

Da ein Firebase-Projekt ein Google Cloud-Projekt ist:

  • Sie können über die Firebase Console, die Google Cloud Console und die Google APIs Console auf das Projekt zugreifen und mit ihm 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 sowohl Produkte als auch 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 (d. h. eines Prinzipals) auf Ihr Google Cloud-Projekt gilt auch für Ihr Firebase-Projekt und umgekehrt.

  • Die Abrechnung für das Projekt wird zwischen Firebase und Google Cloud geteilt. Wenn die Abrechnung für Ihr Google Cloud-Projekt aktiviert ist, wird für Ihr Firebase-Projekt der Firebase-Tarif „Blaze“ (Pay as you go) angewendet.

  • Eindeutige Kennungen für das Projekt (z. B. Projektnummer und Projekt-ID) werden in Firebase und Google Cloud gemeinsam verwendet.

  • Die 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 (oder für erweiterte Anwendungsfälle über die Firebase Management REST API oder die Firebase CLI). 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 Entwicklungsablauf einrichten, der in der Regel die Verwendung mehrerer Umgebungen umfasst. In unserer Dokumentation zu Entwicklerworkflows finden Sie allgemeine Best Practices und allgemeine Sicherheitsrichtlinien zum Einrichten von Firebase-Projekten und Registrieren von Apps, um Ihren Entwicklungsworkflow zu erstellen.

Mit einem Firebase-Projekt interagieren

Neben den Produkt-SDKs können Sie mit mehreren verschiedenen Tools und Schnittstellen direkt mit einem Firebase-Projekt interagieren.

Firebase-Konsole

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 aufgelistet. Klicken Sie oben links in der Seitenleiste auf , um die Einstellungen eines Projekts aufzurufen. Die Einstellungen eines Projekts umfassen Integrationen, Zugriffsberechtigungen und Abrechnung.

In der Mitte der Konsole werden Schaltflächen angezeigt, mit denen Einrichtungsabläufe gestartet werden, um verschiedene Arten von Apps zu registrieren. Nachdem Sie Firebase verwendet haben, wird der Hauptbereich der Konsole in ein Dashboard umgewandelt, in dem Statistiken zu den von Ihnen verwendeten Produkten angezeigt werden.

Da ein Firebase-Projekt auch ein Google Cloud-Projekt ist, kann es vorkommen, dass Sie für verschiedene Aufgaben oder Produkte die Google Cloud Console anstelle der Firebase Console verwenden müssen.

Firebase Befehlszeile (Befehlszeilentool)

Firebase bietet außerdem die Firebase CLI zum Konfigurieren und Verwalten bestimmter Firebase-Produkte wie Firebase Hosting, Cloud Functions for Firebase und Firebase Extensions.

Nach der Installation der Befehlszeile haben Sie Zugriff auf den globalen firebase-Befehl. Verwenden Sie die Befehlszeile, um Ihr lokales App-Verzeichnis mit einem Firebase-Projekt zu verknüpfen, und stellen Sie dann neue Versionen von Firebase-gehosteten Inhalten oder Updates für Funktionen bereit.

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-Projekt-IDs

Ein Firebase-Projekt kann im Firebase-Backend und in verschiedenen Entwickleroberflächen anhand verschiedener 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 voneinander unterscheiden zu können.

Sie können den Projektnamen jederzeit in den Projekteinstellungen der Firebase-Konsole bearbeiten. Der Projektname wird im oberen Bereich angezeigt.

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.

Projektnummern können nicht bearbeitet werden. Wenn Sie ein Projekt löschen, wird auch die Projektnummer gelöscht und kann nie wieder für ein anderes 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, wird dem Projekt automatisch eine eindeutige ID zugewiesen. Sie können diese jedoch während der Projekteinrichtung bearbeiten. Diese Kennung dient in der Regel als praktischer Alias, um auf das Projekt zu verweisen.

Firebase-Konfigurationsdateien und ‑objekte

Wenn Sie eine App bei einem Firebase-Projekt registrieren, wird in der Firebase Console eine Firebase-Konfigurationsdatei (Apple-/Android-Apps) oder ein Konfigurationsobjekt (Web-Apps) bereitgestellt, 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 Konfigurationsdatei vom Typ google-services.json 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.

In einer Firebase-Konfigurationsdatei oder einem Firebase-Objekt wird eine App mit einem bestimmten Firebase-Projekt und seinen Ressourcen (Datenbanken, Speicher-Buckets usw.) verknüpft. Die Konfiguration enthält „Firebase-Optionen“. Das sind Parameter, die von Firebase- und Google-Diensten zur Kommunikation mit Firebase-Server-APIs und zum Verknüpfen von Clientdaten mit dem Firebase-Projekt und der Firebase-App benötigt werden. Hier sind die erforderlichen „Firebase-Optionen“ im Mindestumfang:

  • API-Schlüssel: Ein einfacher verschlüsselter String, der beim Aufruf bestimmter APIs verwendet wird, die nicht auf private Nutzerdaten zugreifen müssen (Beispielwert: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)

  • Projekt-ID: eine benutzerdefinierte, 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)

  • App-ID („AppID“): 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-Bundle-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)

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.

Bei Open-Source-Projekten empfehlen wir in der Regel nicht, die Firebase-Konfigurationsdatei oder das Firebase-Konfigurationsobjekt der App in die Versionskontrolle aufzunehmen. In den meisten Fällen sollten Ihre Nutzer ihre eigenen Firebase-Projekte erstellen und ihre Apps über eine eigene Firebase-Konfigurationsdatei oder ein eigenes Firebase-Konfigurationsobjekt auf ihre eigenen Firebase-Ressourcen verweisen.

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 Konto

    • Spark-Tarif: Das Kontingent für die Projekterstellung ist auf eine geringere Anzahl von Projekten beschränkt (in der Regel 5–10).
    • Blaze-Preisplan: Das Kontingent für die Projekterstellung pro Konto wird erheblich erhöht, solange das zugehörige Cloud Billing-Konto ordnungsgemäß geführt wird.

    Das Limit für das Kontingent für die Projekterstellung ist für die meisten Entwickler selten ein Problem. Bei Bedarf können Sie jedoch 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.

  • Anzahl der Apps pro Projekt

    Firebase begrenzt die Gesamtzahl der Firebase-Apps in einem Firebase-Projekt auf 30.

    Alle Firebase-Apps in einem einzelnen Firebase-Projekt sollten aus Sicht der Endnutzer Plattformvarianten derselben Anwendung sein. Weitere Informationen zur Mehrinstanzenfä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-Websites pro Projekt

    Die Firebase Hosting-Mehrfachwebsite-Funktion unterstützt maximal 36 Websites pro Projekt.

App veröffentlichen