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 in tempo reale su tutti i client e rimangono disponibili quando l'app va offline.

Prima di iniziare

Prima di poter utilizzare Firebase Realtime Database, devi:

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

    Se il tuo progetto C++ utilizza già Firebase, è 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 Firebase dalla console, 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à iniziale per Firebase Security Rules:

    Modalità di prova

    Ideale per iniziare a utilizzare le librerie client web e mobile, ma consente a chiunque di leggere e sovrascrivere i tuoi dati. Dopo il test, assicurati di esaminare 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

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

  4. Scegli una posizione per il database.

    A seconda della posizione del database, l'URL del nuovo database avrà uno dei seguenti formati:

    • 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 Cloud API Manager.

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 il firebase::App:

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

Accedere alla classe firebase::database::Database

firebase::database::Database è il punto di accesso 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 regole, puoi procedere alle sezioni su salvataggio e 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() sul computer o i listener non funzioneranno.
  • La versione del flusso di lavoro desktop di Realtime Database non supporta la modalità offline o la persistenza.