Erste Schritte mit Firebase Realtime Database für C++

Die Firebase Realtime Database speichert und synchronisiert Daten mithilfe einer NoSQL-Cloud-Datenbank. Daten werden in Echtzeit über alle Clients synchronisiert und bleiben verfügbar, wenn die App offline geht.

Vorbereitung

Bevor Sie Firebase Realtime Database verwenden können, müssen Sie Folgendes tun:

  • Registrieren Sie Ihr C++-Projekt und konfigurieren Sie es für die Verwendung von Firebase.

    Wenn in Ihrem C++-Projekt bereits Firebase verwendet wird, ist es bereits für Firebase registriert und konfiguriert.

  • Fügen Sie Ihrem C++-Projekt das Firebase C++ SDK hinzu.

Das Hinzufügen von Firebase zu Ihrem C++-Projekt umfasst Aufgaben sowohl in der Firebase Console als auch in Ihrem geöffneten C++-Projekt. Sie laden beispielsweise Firebase-Konfigurationsdateien aus der Console herunter und verschieben sie dann in Ihr C++-Projekt.

Datenbank erstellen

  1. Rufen Sie in der Firebase Console den Bereich Realtime Database auf. Sie werden aufgefordert, ein vorhandenes Firebase-Projekt auszuwählen. Folgen Sie dem Workflow zur Datenbankerstellung.

  2. Wähle einen Startmodus für dein Firebase Security Rules aus:

    Testmodus

    Gut für die ersten Schritte mit den Mobil- und Web-Clientbibliotheken, allerdings können Ihre Daten von beliebigen Personen gelesen und überschrieben werden. Prüfen Sie nach dem Test den Abschnitt Firebase Realtime Database-Regeln verstehen.

    Wenn du das Web-, Apple- oder Android SDK verwenden möchtest, wähle „testmode“ aus.

    Sperrmodus

    Alle Lese- und Schreibvorgänge von Mobil- und Webclients werden abgelehnt. Ihre authentifizierten Anwendungsserver können weiterhin auf Ihre Datenbank zugreifen.

  3. Wählen Sie einen Speicherort für die Datenbank aus.

    Je nach Speicherort der Datenbank hat die URL für die neue Datenbank eines der folgenden Formate:

    • DATABASE_NAME.firebaseio.com (für Datenbanken in us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (für Datenbanken an allen anderen Speicherorten)

  4. Klicken Sie auf Fertig.

Wenn Sie Realtime Database aktivieren, wird auch die API im Cloud API Manager aktiviert.

firebase::App erstellen und initialisieren

Bevor Sie auf die Realtime Database zugreifen können, müssen Sie die firebase::App erstellen und initialisieren.

Fügen Sie die Headerdatei für firebase::App ein:

#include "firebase/app.h"

Android

Erstelle die firebase::App und übergebe als Argumente die JNI-Umgebung und einen jobject-Verweis auf die Java-Aktivität:

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"), jni_env, activity);

iOS+

Erstellen Sie firebase::App:

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"));

Auf die Klasse „firebase::database::Database“ zugreifen

firebase::database::Database ist der Einstiegspunkt für das Firebase Realtime Database C++ SDK.

::firebase::database::Database *database = ::firebase::database::Database::GetInstance(app);

Wenn Sie sich für den öffentlichen Zugriff auf Ihre Regeln entschieden haben, können Sie mit den Abschnitten zum Speichern und Abrufen von Daten fortfahren.

Eingeschränkten Zugriff einrichten

Wenn Sie den öffentlichen Zugriff nicht verwenden möchten, können Sie Ihrer App Firebase Authentication hinzufügen, um den Zugriff auf die Datenbank zu steuern.

Nächste Schritte

Bekannte Probleme

  • Auf Desktop-Plattformen (Windows, Mac, Linux) verwendet das Firebase C++ SDK REST, um auf Ihre Datenbank zuzugreifen. Aus diesem Grund müssen Sie auf dem Computer mit Query::OrderByChild() die verwendeten Indexe deklarieren. Andernfalls schlagen die Listener fehl.
  • Die Desktop-Workflowversion von Realtime Database unterstützt keine Offlinenutzung und keine Datenspeicherung.