Inizia a utilizzare Firebase Realtime Database per C++

Firebase Realtime Database archivia e sincronizza i dati utilizzando un database cloud NoSQL. I dati vengono sincronizzati su tutti i client in tempo reale e rimangono disponibili quando l'app è offline.

Prima di iniziare

Per poter usare Firebase Realtime Database, devi:

  • Registra il tuo progetto C++ e configuralo in modo che utilizzi Firebase.

    Se il tuo progetto C++ utilizza già Firebase, significa che è già registrato e configurato per Firebase.

  • Aggiungi l'SDK Firebase C++ al tuo progetto C++.

Tieni presente che l'aggiunta di Firebase al tuo progetto C++ comporta attività sia nella console Firebase sia nel progetto C++ aperto (ad esempio, scarichi i file di configurazione di Firebase dalla console e poi li sposti nel progetto C++).

Crea un database

  1. Nella console Firebase, vai a Database e spazio di archiviazione > Realtime Database.

  2. Fai clic su Crea database.

  3. Seleziona una modalità di avvio per Firebase Security Rules:

    Modalità di test

    Ideale per iniziare a utilizzare le librerie client mobile e web, ma consente a chiunque di leggere e sovrascrivere i tuoi dati. Dopo i test, assicurati di consultare la sezione Informazioni sulle regole di Firebase Realtime Database.

    Per iniziare a utilizzare l'SDK per il web, Apple o Android, seleziona testmode.

    Modalità di blocco

    Rifiuta tutte le operazioni di lettura e scrittura dei client web e su dispositivi mobili. I server delle applicazioni autenticati possono comunque accedere al tuo database.

  4. Scegli una località per il database.

    A seconda della località del database, l'URL del nuovo database avrà una delle seguenti forme:

    • DATABASE_NAME.firebaseio.com (per i database in us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (per i database in tutte le altre località)

  5. Fai clic su Fine.

Quando abiliti Realtime Database, viene abilitata anche l'API in Gestione API Cloud.

Crea e inizializza firebase::App

Prima di poter accedere a Realtime Database, devi creare e inizializzare firebase::App.

Includi il file di intestazione per firebase::App:

#include "firebase/app.h"

Android

Crea firebase::App, passando l'ambiente JNI e un riferimento jobject all'attività Java come argomenti:

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

iOS+

Crea firebase::App:

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

Accedi alla classe firebase::database::Database

firebase::database::Database è il punto di ingresso per l'SDK C++ Firebase Realtime Database.

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

Se hai scelto di utilizzare l'accesso pubblico per le tue regole, puoi procedere alle sezioni relative al salvataggio e al recupero dei dati.

Configurazione dell'accesso limitato

Se non vuoi utilizzare l'accesso pubblico, puoi aggiungere Firebase Authentication alla tua app per controllare l'accesso al database.

Passaggi successivi

Problemi noti

  • Sulle piattaforme desktop (Windows, Mac, Linux), l'SDK Firebase C++ utilizza REST per accedere al database. Per questo motivo, devi dichiarare gli indici che utilizzi con Query::OrderByChild() su computer, altrimenti i listener non funzioneranno.
  • La versione del workflow desktop di Realtime Database non supporta la modalità offline o la persistenza.