Check out what’s new from Firebase at Google I/O 2022. Learn more

Начните работу с базой данных Firebase Realtime для C++

База данных Firebase Realtime хранит и синхронизирует данные с помощью облачной базы данных NoSQL. Данные синхронизируются между всеми клиентами в режиме реального времени и остаются доступными, когда ваше приложение отключается.

Прежде чем вы начнете

Прежде чем вы сможете использовать базу данных Firebase Realtime , вам необходимо:

  • Зарегистрируйте свой проект C++ и настройте его для использования Firebase.

    Если ваш проект C++ уже использует Firebase, значит, он уже зарегистрирован и настроен для Firebase.

  • Добавьте Firebase C++ SDK в свой проект C++.

Обратите внимание, что добавление Firebase в ваш проект C++ включает задачи как в консоли Firebase , так и в вашем открытом проекте C++ (например, вы загружаете файлы конфигурации Firebase из консоли, а затем перемещаете их в свой проект C++).

Создать базу данных

  1. Перейдите в раздел Realtime Database консоли Firebase . Вам будет предложено выбрать существующий проект Firebase. Следуйте рабочему процессу создания базы данных.

  2. Выберите начальный режим для ваших правил безопасности Firebase:

    Режим тестирования

    Хорошо подходит для начала работы с мобильными и веб-клиентскими библиотеками, но позволяет любому читать и перезаписывать ваши данные. После тестирования обязательно ознакомьтесь с разделом « Понимание правил базы данных Firebase Realtime ».

    Чтобы начать работу с Интернетом, Apple или Android SDK, выберите тестовый режим.

    Заблокированный режим

    Запрещает все операции чтения и записи из мобильных и веб-клиентов. Ваши аутентифицированные серверы приложений по-прежнему могут получать доступ к вашей базе данных.

  3. Выберите место для базы данных.

    В зависимости от расположения базы данных URL-адрес новой базы данных будет иметь одну из следующих форм:

    • DATABASE_NAME .firebaseio.com (для баз данных в us-central1 )

    • DATABASE_NAME . REGION .firebasedatabase.app (для баз данных во всех других местах)

  4. Щелкните Готово .

Когда вы включаете базу данных в реальном времени, она также включает API в Cloud API Manager .

Создать и инициализировать firebase::App

Прежде чем вы сможете получить доступ к базе данных реального времени, вам необходимо создать и инициализировать firebase::App .

Включите заголовочный файл для firebase::App :

#include "firebase/app.h"

Андроид

Создайте jobject firebase::App , передав среду JNI и ссылку на проект Java Activity в качестве аргументов:

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

iOS+

Создайте firebase::App :

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

Доступ к классу firebase::database::Database

Firebase firebase::database::Database — это точка входа для Firebase Realtime Database C++ SDK.

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

Если вы решили использовать публичный доступ для своих правил, вы можете перейти к разделам, посвященным сохранению и получению данных.

Настройка ограниченного доступа

Если вы не хотите использовать публичный доступ, вы можете добавить аутентификацию Firebase в свое приложение, чтобы контролировать доступ к базе данных.

Следующие шаги

Известные проблемы

  • На настольных платформах (Windows, Mac, Linux) Firebase C++ SDK использует REST для доступа к вашей базе данных. Из-за этого вы должны объявить индексы, которые вы используете с Query::OrderByChild() на рабочем столе, иначе ваши слушатели не будут работать.
  • Настольная версия рабочего процесса базы данных реального времени не поддерживает автономный режим или сохраняемость.