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

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 progetto C++ comporta attività sia nella console Firebase sia nel progetto C++ aperto (ad esempio, scarichi i file di configurazione Firebase dalla console, quindi li sposti nel progetto C++).

Creare 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 per la creazione del database.

  2. Seleziona una modalità di avvio per il tuo Firebase Security Rules:

    Modalità di test

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

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

    Modalità di blocco

    Rifiuta tutte le operazioni di lettura e scrittura da client web e mobile. I tuoi server di applicazioni autenticati possono comunque accedere al tuo database.

  3. Scegli una posizione per il database.

    A seconda della posizione 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à)

  4. Fai clic su Fine.

Se attivi Realtime Database, viene attivata anche l'API in Cloud API Manager.

Crea e inizializza firebase::App

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

Includi il file di intestazione per firebase::App:

#include "firebase/app.h"

Android

Crea firebase::App passando come argomenti l'ambiente JNI e un riferimento jobject alla Java Activity:

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 contatto 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 passare alle sezioni relative al salvataggio e al recupero dei dati.

Configurare l'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 gli ascoltatori non funzioneranno.
  • La versione del flusso di lavoro desktop di Realtime Database non supporta la modalità offline o la persistenza.