Firebase Realtime Database for C++ を使ってみる

Firebase Realtime Database は NoSQL クラウドデータベースを使用してデータの保管と同期を行います。データはすべてのクライアントにわたってリアルタイムで同期され、アプリがオフラインになっても利用可能な状態が維持されます。

始める前に

Firebase Realtime Database を使用するには、事前に次の作業を行っておく必要があります。

C++ プロジェクトを登録して Firebase を使用するように構成します。

C++ プロジェクトですでに Firebase を使用している場合、この登録と構成はすでに行われています。
Firebase C++ SDK を C++ プロジェクトに追加します。

Firebase を C++ プロジェクトに追加するには、Firebase コンソールと開いている C++ プロジェクトの両方でこのタスクを行う必要があります（コンソールから Firebase 構成ファイルをダウンロードして C++ プロジェクトに移動するなど）。

データベースを作成する

Firebase コンソールの [Realtime Database] セクションに移動します。既存の Firebase プロジェクトを選択するよう求められます。データベース作成ワークフローに従います。
Firebase セキュリティルールの開始モードを選択します。

テストモード

モバイルおよびウェブクライアントライブラリを使用する場合に適していますが、すべてのユーザーがデータを読み取り、上書きできます。テストが終わったら、Firebase Realtime Database ルールについてを確認してください。

注: テストモードでデータベースを作成し、トライアル期間内にデフォルトの公開読み取り可能ルールと公開書き込み可能ルールに変更を加えていない場合は、メールで通知され、その後、データベースルールはすべてのリクエストを拒否します。Firebase コンソールの設定フロー中に有効期限を確認します。

ウェブ、Apple、Android SDK を使用する場合は、テストモードを選択します。

ロックモード

モバイルおよびウェブクライアントからのすべての読み書きを拒否します。認証されたアプリケーションサーバーは引き続きデータベースにアクセスできます。
データベースのロケーションを選択します。

データベースのロケーションに応じて、新しいデータベースの URL は次のいずれかの形式になります。
- DATABASE_NAME.firebaseio.com（us-central1 のデータベースの場合）
- DATABASE_NAME.REGION.firebasedatabase.app（他のすべてのロケーションのデータベースの場合）
[完了] をクリックします。

Realtime Database を有効にすると、Cloud API Manager で API も有効になります。

firebase::App を作成して初期化する

Realtime Database にアクセスするには、事前に firebase::App を作成して初期化する必要があります。

firebase::App のヘッダーファイルを追加します。

#include "firebase/app.h"

Android

firebase::App を作成し、引数として JNI 環境と jobject 参照を Java アクティビティに渡します。

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::database::Database は、Firebase Realtime Database C++ SDK のエントリポイントです。

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

公開アクセスルールを使用することにした場合は、データの保存と取得に関するセクションに進むことができます。

アクセス制限を設定する

公開アクセスを使用しない場合、アプリに Firebase Authentication を追加して、データベースに対するアクセスを制御できます。

次のステップ

Realtime Database でのデータの構造化を学習する。
複数のデータベースインスタンスにデータをスケーリングする。
データを保存する。
データを取得する。
Firebase コンソールでデータベースを表示する。
アプリをリリースする準備をします。
- Google Cloud Console でプロジェクトの予算アラートを設定する。
- Firebase コンソールの [使用量と請求額] ダッシュボードをモニタリングして、複数の Firebase サービスを通じたプロジェクトの全体的な使用状況を確認する。使用状況の詳しい情報を確認するには、Realtime Database の使用状況ダッシュボードをご利用ください。
- Firebase リリースチェックリストを確認する。

既知の問題

デスクトッププラットフォーム（Windows、Mac、Linux）では、Firebase C++ SDK は、REST を使用してデータベースにアクセスします。そのため、デスクトップの Query::OrderByChild() と合わせて使用するインデックスを宣言する必要があります。宣言しないとリスナーが失敗します。
Realtime Database のデスクトップワークフローバージョンでは、オフラインや永続性はサポートされていません。