Google is committed to advancing racial equity for Black communities. See how.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

Premiers pas avec Firebase Realtime Database pour C ++

La base de données Firebase Realtime stocke et synchronise les données à l'aide d'une base de données cloud NoSQL. Les données sont synchronisées sur tous les clients en temps réel et restent disponibles lorsque votre application est hors ligne.

Avant que tu commences

Avant de pouvoir utiliser Firebase Realtime Database , vous devez:

  • Enregistrez votre projet C ++ et configurez-le pour utiliser Firebase.

    Si votre projet C ++ utilise déjà Firebase, il est déjà enregistré et configuré pour Firebase.

  • Dans votre fichier build.gradle niveau du build.gradle , assurez-vous d'inclure le référentiel Maven de Google dans vos sections buildscript et allprojects .

  • Ajoutez le SDK Firebase C ++ à votre projet C ++.

Notez que l'ajout de Firebase à votre projet C ++ implique des tâches à la fois dans la console Firebase et dans votre projet C ++ ouvert (par exemple, vous téléchargez les fichiers de configuration Firebase depuis la console, puis les déplacez dans votre projet C ++).

Créer une base de données

  1. Si vous ne l'avez pas déjà fait, créez un projet Firebase: dans la console Firebase , cliquez sur Ajouter un projet , puis suivez les instructions à l'écran pour créer un projet Firebase ou pour ajouter des services Firebase à un projet GCP existant.

  2. Accédez à la section Base de données de la console Firebase . Vous serez invité à sélectionner un projet Firebase existant. Suivez le workflow de création de base de données.

  3. Sélectionnez un mode de démarrage pour vos règles de sécurité Firebase:

    Mode d'essai

    Idéal pour démarrer avec les bibliothèques clientes mobiles et Web, mais permet à quiconque de lire et d'écraser vos données. Après le test, assurez-vous de consulter la section Comprendre les règles de base de données en temps réel Firebase .

    Pour démarrer avec le SDK Web, iOS ou Android, sélectionnez le mode test.

    Mode verrouillé

    Refuse toutes les lectures et écritures des clients mobiles et Web. Vos serveurs d'applications authentifiés peuvent toujours accéder à votre base de données.

  4. Cliquez sur Terminé .

Lorsque vous activez la base de données en temps réel, elle active également l'API dans Cloud API Manager .

Créer et initialiser firebase :: App

Avant de pouvoir accéder à la base de données en temps réel, vous devez créer et initialiser firebase::App .

Incluez le fichier d'en-tête pour firebase::App :

#include "firebase/app.h"

Android

Créez le firebase::App , en passant l'environnement JNI et une référence de jobject à l'activité Java comme arguments:

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

iOS

Créez la firebase::App :

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

Accédez à la classe firebase :: database :: Database

firebase::database::Database est le point d'entrée du SDK C ++ Firebase Realtime Database.

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

Si vous avez choisi d'utiliser l'accès public pour vos règles, vous pouvez passer aux sections sur l'enregistrement et la récupération des données.

Configuration de l'accès restreint

Si vous ne souhaitez pas utiliser l'accès public, vous pouvez ajouter l'authentification Firebase à votre application pour contrôler l'accès à la base de données.

Prochaines étapes

Problèmes connus

  • Sur les plates-formes de bureau (Windows, Mac, Linux), le SDK Firebase C ++ utilise REST pour accéder à votre base de données. Pour cette raison, vous devez déclarer les index que vous utilisez avec Query :: OrderByChild () sur le bureau, sinon vos écouteurs échoueront.
  • La version de workflow de bureau de Realtime Database ne prend pas en charge hors ligne ou la persistance.