Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Firebase-Projekte verstehen

Diese Seite bietet einen kurzen Überblick über mehrere wichtige Konzepte zu Firebase-Projekten. Wenn verfügbar, folgen Sie den Links, um detailliertere Informationen zu Funktionen, Diensten und sogar anderen Plattformen zu erhalten. Eine Liste der am unteren Ende dieser Seite finden allgemeine Best Practices für Firebase Projekte.

Beziehung zwischen Firebase-Projekten, Apps und Produkten

Ein Firebase-Projekt ist die oberste Entität für Firebase. In einem Projekt erstellen Sie Firebase-Apps, indem Sie Ihre iOS-, Android- oder Web-Apps registrieren. Nachdem Sie Ihre Anwendungen mit Firebase registrieren, können Sie die Firebase SDKs für beliebig viele hinzufügen Firebase Produkte , wie Analytics, Wolke Firestor, Performance Monitoring, oder Remote - Konfiguration.

Weitere ausführliche Informationen zu diesem Prozess in dem Getting Started Guides ( iOS | Android | web | Einheit | C ++ ).

Beziehung zwischen Firebase-Projekten und Google Cloud

Wenn Sie ein neues Projekt in der Firebase Firebase - Konsole zu erstellen, sind die Schaffung Sie tatsächlich eine Google Cloud - Projekt hinter den Kulissen. Sie können sich ein Google Cloud-Projekt als virtuellen Container für Daten, Code, Konfiguration und Dienste vorstellen. Ein Firebase-Projekt ist ein Google Cloud-Projekt mit zusätzlichen Firebase-spezifischen Konfigurationen und Diensten. Sie können sogar zuerst ein Google Cloud-Projekt erstellen und dann Firebase später zum Projekt hinzufügen.

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

  • Projekte , die in der erscheinen Firebase Konsole auch im erscheinen Google Cloud Console und Google APIs - Konsole .

  • Billing und Berechtigungen für Projekte werden über Firebase und Google Cloud geteilt.

  • Eindeutige Kennungen für ein Projekt (wie die Projektnummer und das Projekt - ID ) werden über Firebase und Google Cloud geteilt.

  • Sie können Produkte und APIs sowohl von Firebase als auch von Google Cloud in einem Projekt verwenden.

  • Wenn Sie ein Projekt löschen, wird es in Firebase und Google Cloud gelöscht.

Ein Firebase-Projekt einrichten und Apps registrieren

Sie können ein Projekt Firebase und registrieren Apps im einrichten Firebase - Konsole (oder für fortgeschrittene Anwendungsfälle, über den 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.

Achten Sie darauf , einige überprüfen allgemeine Projektebene bewährte Verfahren (unten auf dieser Seite) vor dem Einrichten eines Projekts und Registrierung Apps.

Der Projektname

Wenn Sie ein Projekt erstellen, geben Sie einen Projektnamen. Diese Kennung ist der ausschließlich interner Name für ein Projekt in der Firebase - Konsole , die Google Cloud Console und die Firebase CLI . Der Projektname ist in keinem öffentlich sichtbaren Firebase- oder Google Cloud-Produkt, -Dienst oder -Ressource verfügbar. es dient lediglich dazu, Sie leichter zwischen mehreren Projekten unterscheiden zu können.

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

Die Projektnummer

Ein Projekt Firebase (und sein zugehöriges Google Cloud - Projekt ) hat eine Projektnummer. Dies ist die von Google zugewiesene weltweit eindeutige kanonische Kennung für das Projekt. Verwenden Sie diese Kennung, wenn Sie Integrationen konfigurieren und/oder API-Aufrufe an Firebase, Google oder Drittanbieterdienste tätigen.

API-Aufrufe und die Projektnummer

Bei vielen API-Aufrufen müssen Sie einen eindeutigen Bezeichner für ein Projekt angeben. Obwohl viele APIs das akzeptieren Projekt - ID , wird empfohlen , dass Sie die Projektnummer für die Herstellung von API - Aufrufe zu verwenden Firebase, Google oder Dienste von Drittanbietern.

Erfahren Sie mehr über Projekt - IDs verwenden, insbesondere die Projektnummer, in der Google- AIP 2510 Standard .

Finden Sie die Projektnummer

  • Firebase - Konsole: Klicken Sie auf Projekteinstellungen . Die Projektnummer wird im oberen Bereich angezeigt.

  • Firebase CLI: Run firebase projects:list . Die Projektnummer wird zusammen mit allen Firebase-Projekten angezeigt, die mit Ihrem Konto verknüpft sind.

  • Firebase - Management REST API: Aufruf projects.list . Die Antwortkörper enthält die Projektnummer im FirebaseProject Objekt.

Die Projekt-ID

Ein Projekt Firebase (und sein zugehöriges Google Cloud - Projekt ) eine Projekt - ID. Dies ist eine benutzerdefinierte eindeutige Kennung für das Projekt in ganz Firebase und Google Cloud. Wenn Sie ein Firebase-Projekt erstellen, weist Firebase dem Projekt automatisch eine eindeutige ID zu, die Sie jedoch während der Projekteinrichtung bearbeiten können. Dieser Bezeichner sollte im Allgemeinen als praktischer Alias ​​verwendet werden, um auf das Projekt zu verweisen.

Wenn Sie ein Projekt löschen, wird auch die Projekt-ID gelöscht und kann von keinem anderen Projekt mehr verwendet werden.

Firebase-Ressourcen und die Projekt-ID

Die Projekt-ID wird in öffentlich sichtbaren Firebase-Ressourcen angezeigt, zum Beispiel:

  • Standard - Hosting - Sub - Domain - PROJECT_ID .web.app und PROJECT_ID .firebaseapp.com
  • Standard Realtime Datenbank - URL - PROJECT_ID -default-rtdb.firebaseio.com oder PROJECT_ID -default-rtdb. REGION_CODE .firebasedatabase.app
  • Standard Cloud Storage Bucketnamen - PROJECT_ID .appspot.com

Für alle oben genannten Ressourcen können Sie nicht standardmäßige Instanzen erstellen. Die öffentlich sichtbaren Namen von Nicht-Standardwerten sind vollständig anpassbar. Sie können benutzerdefinierte Domänen verbinden zu einer Firebase-gehostete Website, Scherbe , die Echtzeit - Datenbank , und erstellen Sie mehrere Cloud Storage Eimer (besuchen Sie die plattformspezifischen Erste Schritte Seite).

Die Firebase-CLI und die Projekt-ID

In einigen Anwendungsfällen sind möglicherweise mehrere Firebase-Projekte mit demselben lokalen App-Verzeichnis verknüpft. In diesen Situationen , wenn Sie die Verwendung Firebase CLI , müssen Sie das passieren --project Flagge mit den firebase Befehle , die Firebase - Projekt , mit dem Sie interagieren wollen kommunizieren.

Sie können auch ein einrichten Projekt Alias für jedes Projekt Firebase , damit Sie müssen Projekt - IDs nicht mehr erinnern.

API-Aufrufe und die Projekt-ID

Bei vielen API-Aufrufen müssen Sie einen eindeutigen Bezeichner für ein Projekt angeben. Obwohl viele APIs die Projekt - ID akzeptieren, ist es empfehlenswert , dass Sie die Verwendung Projektnummer für die Herstellung von API - Aufrufe zu Firebase, Google oder Dienste von Drittanbietern.

Erfahren Sie mehr über Projekt - IDs verwenden, insbesondere die Projektnummer, in der Google- AIP 2510 Standard .

Finden Sie die Projekt-ID

  • Firebase - Konsole: Klicken Sie auf Projekteinstellungen . Die Projekt-ID wird im oberen Bereich angezeigt.

  • Firebase CLI: Run firebase projects:list . Die Projekt-ID wird zusammen mit allen Firebase-Projekten angezeigt, die mit Ihrem Konto verknüpft sind.

  • Firebase - Management REST API: Aufruf projects.list . Der Antworttext enthält die Projekt - ID in dem FirebaseProject Objekt.

Firebase-Konfigurationsdateien und -Objekte

Wenn Sie eine App bei einem Firebase-Projekt registrieren, stellt die Firebase-Konsole eine Firebase-Konfigurationsdatei (iOS-/Android-Apps) oder ein Konfigurationsobjekt (Web-Apps) bereit, die Sie direkt zu Ihrem lokalen App-Verzeichnis hinzufügen.

  • Für iOS - Apps, fügen Sie eine GoogleService-Info.plist Konfigurationsdatei.
  • Bei Android - Apps, fügen Sie eine google-services.json Konfigurationsdatei.
  • Für Web-Apps fügen Sie ein Firebase-Konfigurationsobjekt hinzu.

Zu jeder Zeit können Sie ein App Firebase - Konfigurationsdatei oder das Objekt erhalten .

Eine Firebase-Konfigurationsdatei oder ein Firebase-Objekt verknüpft eine App mit einem bestimmten Firebase-Projekt und seinen Ressourcen (Datenbanken, Speicher-Buckets usw.). Die Konfiguration umfasst "Firebase-Optionen", 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 erforderlichen, minimalen "Firebase-Optionen":

  • API - AIzaSyDOCAbC123dEf456GhI789jKl012-MnO Schlüssel : eine einfache verschlüsselte Zeichenfolge verwendet , wenn bestimmte APIs aufrufen , die nicht brauchen , um Zugang zu privaten Benutzerdaten (zB Wert: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

  • Projekt ID : eine benutzerdefinierte eindeutige Kennung für das Projekt über alle Firebase und Google Cloud. Dieser Bezeichner kann in URLs oder Namen einiger Firebase-Ressourcen vorkommen, sollte jedoch im Allgemeinen als einfacher Alias ​​zum Verweisen auf das Projekt behandelt werden. (Beispielwert: myapp-project-123 )

  • Anwendungs - ID ( „AppID“): die eindeutige Kennung für die Firebase App über alle Firebase mit einem plattformspezifischen Format:

    • Feuerbasis IOS apps: GOOGLE_APP_ID (Beispielwert: 1:1234567890:ios:321abc456def7890 )
      Dies ist nicht eine Apple - Bundle - ID.
    • Firebase Android Apps: mobilesdk_app_id (zB Wert: 1:1234567890:android:321abc456def7890 )
      Dies ist kein Android Paketnamen oder Android - Anwendung ID.
    • Firebase Web - Anwendungen: appId (zB Wert: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c )

Der Inhalt der Firebase-Konfigurationsdatei oder des Firebase-Objekts gilt als öffentlich, einschließlich der plattformspezifischen ID der App (iOS-Bundle-ID oder Android-Paketname) und der projektspezifischen Firebase-Werte wie API-Schlüssel, Projekt-ID, Echtzeitdatenbank-URL und Name des Cloud Storage-Buckets. Angesichts dieser Tatsache Gebrauch Firebase Sicherheitsregeln auf Ihre Daten und Dateien in Schutz Echtzeit - Datenbank , Wolke Firestor und Cloud Storage .

Bei Open-Source-Projekten empfehlen wir im Allgemeinen nicht, die Firebase-Konfigurationsdatei oder das Objekt der App in die Quellcodeverwaltung aufzunehmen, da Ihre Benutzer in den meisten Fällen ihre eigenen Firebase-Projekte erstellen und ihre Apps auf ihre eigenen Firebase-Ressourcen verweisen sollten (über ihre eigene Firebase-Konfiguration). Datei oder Objekt).

Verwalten eines Firebase-Projekts

Achten Sie auf die Bewertung allgemeiner Projektebene Best Practices (am Ende der Seite) für Überlegungen , die beeinflussen könnten , wie Sie ein Projekt Firebase verwalten.

Tools zum Verwalten eines Projekts

Firebase-Konsole

Die Firebase Konsole bietet die umfangreichste Umgebung für die Verwaltung von Firebase Produkte, Apps und Projektebene Einstellungen.

Firebase-Konsole - Projektübersichtsbildschirm

Im linken Bereich der Konsole werden die Firebase-Produkte aufgelistet, die nach Kategorien der obersten Ebene geordnet sind. An der Spitze der linken Seitenwand, den Zugriff eines Einstellungen des Projekts , indem Sie auf . Ein Projekteinstellungen umfassen Integrationen , Zugriffsberechtigungen und Abrechnung .

In der Mitte der Konsole werden Schaltflächen angezeigt, die Setup-Workflows starten, um verschiedene Arten von Apps zu registrieren. Nachdem Sie Firebase verwenden, ändert sich der Hauptbereich der Konsole in ein Dashboard, das Statistiken zu den von Ihnen verwendeten Produkten anzeigt.

Firebase CLI (ein Befehlszeilentool)

Firebase bietet auch die Firebase CLI für die Konfiguration und Verwaltung von spezifischen Firebase - Produkte, wie Feuerbasis für Firebase Hosting und Cloud - Funktionen.

Nach der CLI installieren, haben Sie Zugriff auf die globalen firebase Befehl . Verwenden Sie die CLI auf Ihrem lokalen App - Verzeichnis in ein Projekt Firebase zu verknüpfen , dann implementieren neue Versionen von Firebase gehostete Inhalte oder Updates Funktionen.

Firebase Management-REST-API

Mit Hilfe des Firebase - Management REST - API , können Sie programmatisch ein Projekt verwalten Firebase. Zum Beispiel können Sie programmatisch eine App mit einem Projekt registrieren oder die Apps aufgelistet , die bereits registriert ist ( iOS | Android | web ).

Allgemeine Best Practices

Apps zu einem Projekt hinzufügen

Stellen Sie sicher , dass alle Anwendungen innerhalb eines Projekts sind plattform Varianten derselben Anwendung aus einer Perspektive des Endbenutzers. Es ist ratsam, die iOS-, Android- und Webversion derselben App oder desselben Spiels mit demselben Firebase-Projekt zu registrieren. Alle Apps in einem Projekt verwenden im Allgemeinen dieselben Firebase-Ressourcen (Datenbank, Speicher-Buckets usw.).

Wenn Sie mehr Build - Varianten mit verschiedenen iOS - IDs oder Android Paketnamen bündeln definiert, können Sie jede Variante mit einem separaten Projekt Firebase registrieren. Wenn Sie jedoch haben Varianten , die teilen die gleichen Ressourcen Firebase, registrieren Sie sie mit dem gleichen Projekt Firebase.

Hier sind einige allgemeine Beschränkungen für Firebase-Projekte, -Apps und -Sites:

  • Anzahl Projekte pro Konto

    • Spark-Preisplan – Das Kontingent für die Projekterstellung ist auf eine geringere Anzahl von Projekten beschränkt (normalerweise etwa 5-10).
    • Blaze-Preisplan – Das Projekterstellungskontingent pro Konto erhöht sich erheblich, solange das zugehörige Cloud-Rechnungskonto einwandfrei ist.

    Die Grenze für Projekterstellungsquote ist selten ein Problem für die meisten Entwickler, aber wenn nötig, können Sie eine Erhöhung der Projekt Quote beantragen .

    Beachten Sie, dass das vollständige Löschen eines Projekts 30 Tage dauert und auf das Projektkontingent angerechnet wird, bis das Projekt vollständig gelöscht ist.

  • Anzahl Apps pro Projekt

    Firebase beschränkt die Gesamtzahl der Firebase-Apps in einem Firebase-Projekt auf 30.

    Sie sollten sicherstellen, dass alle Firebase-Apps innerhalb eines einzelnen Firebase-Projekts aus Sicht des Endnutzers Plattformvarianten derselben Anwendung sind. Lesen Sie mehr über Best Practices für die Multi-Tenancy unten.

    Erfahren Sie mehr über die Grenze für Anwendungen pro Projekt in der FAQ.

  • Anzahl der Hosting-Sites pro Projekt

    Die Firebase Multisite - Funktion Hosting unterstützt maximal 36 Stellen pro Projekt.

Mandantenfähigkeit

Es wird nicht empfohlen, mehrere verschiedene logisch unabhängige Apps und/oder Websites mit einem einzigen Firebase-Projekt zu verbinden (oft als "Mandantenfähigkeit" bezeichnet). Die Mandantenfähigkeit kann zu schwerwiegenden Problemen bei der Konfiguration und dem Datenschutz führen, einschließlich unbeabsichtigter Probleme bei der Analyseaggregation, gemeinsamer Authentifizierung, übermäßig komplexer Datenbankstrukturen und Schwierigkeiten mit Sicherheitsregeln.

Im Allgemeinen, wenn eine Reihe von Anwendungen stark nicht die gleichen Daten und Konfigurationen teilen, sollten Sie jede Anwendung mit einem anderen Projekt Firebase Registrierung.

Wenn Sie beispielsweise eine White-Label-Anwendung entwickeln, sollte jede unabhängig gekennzeichnete App über ein eigenes Firebase-Projekt verfügen, aber die iOS- und Android-Versionen dieses Labels können sich im selben Projekt befinden. Jede unabhängig gekennzeichnete App sollte (aus Datenschutzgründen) keine Daten mit anderen teilen.

Starten Ihrer App