Wprowadzenie do Bazy danych czasu rzeczywistego Firebase dla C++

Baza danych Firebase Realtime Database przechowuje i synchronizuje dane za pomocą chmurowej bazy danych NoSQL. Dane są synchronizowane na wszystkich klientach w czasie rzeczywistym i pozostają dostępne, gdy aplikacja przejdzie w tryb offline.

Zanim zaczniesz

Zanim zaczniesz korzystać z Firebase Realtime Database, musisz:

  • Zarejestruj projekt C++ i skonfiguruj go do używania Firebase.

    Jeśli Twój projekt w C++ już korzysta z Firebase, jest już zarejestrowany i skonfigurowany pod kątem tej usługi.

  • Dodaj pakiet SDK Firebase C++ do projektu C++.

Pamiętaj, że dodanie Firebase do projektu C++ wymaga wykonania zadań zarówno w konsoli Firebase, jak i w otwartym projekcie C++ (np. pobieranie plików konfiguracji Firebase z konsoli i przenoszenie ich do projektu C++).

Tworzenie bazy danych

  1. W konsoli Firebase otwórz sekcję Realtime Database. Pojawi się prośba o wybranie dotychczasowego projektu Firebase. Postępuj zgodnie z procesem tworzenia bazy danych.

  2. Wybierz tryb początkowy dla Firebase Security Rules:

    Tryb testowy

    Jest to dobre rozwiązanie na początek korzystania z bibliotek klienta mobilnego i internetowego, ale pozwala każdemu odczytywać i zapisywać Twoje dane. Po przetestowaniu zapoznaj się z sekcją Omówienie reguł Firebase Realtime Database.

    Aby zacząć korzystać z pakietu SDK do przeglądarki, Apple lub Androida, wybierz tryb testowy.

    Tryb blokady

    Odrzuca wszystkie odczyty i zapisy z klientów mobilnych oraz internetowych. Twoje uwierzytelnione serwery aplikacji nadal mają dostęp do Twojej bazy danych.

  3. Wybierz lokalizację bazy danych.

    W zależności od lokalizacji bazy danych adres URL nowej bazy danych będzie miał jedną z tych form:

    • DATABASE_NAME.firebaseio.com (w przypadku baz danych w dodomenach us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app(w przypadku baz danych w innych lokalizacjach)

  4. Kliknij Gotowe.

Gdy włączysz Realtime Database, interfejs API zostanie też włączony w Menedżerze interfejsów API w chmurze.

Tworzenie i inicjowanie firebase::App

Zanim uzyskasz dostęp do Realtime Database, musisz utworzyć i zainicjować obiekt firebase::App.

Dołącz plik nagłówka firebase::App:

#include "firebase/app.h"

Android

Utwórz obiekt firebase::App, przekazując jako argumenty środowisko JNI i odniesienie do aktywności w języku Java:jobject

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

iOS+

Utwórz firebase::App:

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

Dostęp do klasy firebase::database::Database

firebase::database::Databaseto punkt wejścia do pakietu SDK C++ Firebase Realtime Database.

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

Jeśli zdecydujesz się używać dostępu publicznego w przypadku reguł, przejdź do sekcji dotyczących zapisywania i pobierania danych.

Konfigurowanie dostępu ograniczonego

Jeśli nie chcesz korzystać z dostępu publicznego, możesz dodać do aplikacji element Firebase Authentication, aby kontrolować dostęp do bazy danych.

Następne kroki

Znane problemy

  • Na platformach komputerowych (Windows, Mac, Linux) pakiet SDK Firebase C++ używa protokołu REST do uzyskiwania dostępu do bazy danych. Dlatego musisz zadeklarować indeksy, których używasz, za pomocą Query::OrderByChild() na komputerze. W przeciwnym razie odbiorniki nie będą działać.
  • Wersja workflow Realtime Database na komputery nie obsługuje pracy offline ani trwałości.