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 Firebase console 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. Vai alla sezione Realtime Database della console Firebase. Ti verrà chiesto di selezionare un progetto Firebase esistente. Segui il flusso di lavoro di creazione del database.

  2. 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 Comprendere le 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.

  3. 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à)

  4. 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 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 tue regole, puoi procedere alle sezioni sul salvataggio e sul 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 tuo 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.