開始使用 C++ 適用的 Firebase 即時資料庫

Firebase 即時資料庫會使用 NoSQL 雲端資料庫儲存及同步處理資料。資料會即時同步處理所有用戶端的資料，且會在應用程式離線期間持續提供服務。

事前準備

如要使用 Firebase Realtime Database， 請先完成下列步驟：

  • 註冊 C++ 專案，並設定使用 Firebase。

    如果 C++ 專案已使用 Firebase，則專案已註冊並設定 Firebase。

  • 將 Firebase C++ SDK 新增至 C++ 專案。

請注意，將 Firebase 新增至 C++ 專案時，您需要在Firebase主控台和開啟的 C++ 專案中執行工作 (例如從主控台下載 Firebase 設定檔，然後移至 C++ 專案)。

建立資料庫

  1. 前往 Firebase 控制台的「Realtime Database」部分。系統會提示您選取現有的 Firebase 專案。 按照資料庫建立工作流程操作。

  2. 選取 Firebase Security Rules 的起始模式：

    測試模式

    適合用來開始使用行動和網路用戶端程式庫，但允許任何人讀取及覆寫您的資料。測試完畢後，請務必查看「瞭解 Firebase 即時資料庫規則」一節。

    如要開始使用網頁、Apple 或 Android SDK，請選取 testmode。

    鎖定模式

    拒絕行動和網路用戶端的所有讀寫要求。 通過驗證的應用程式伺服器仍可存取資料庫。

  3. 選擇資料庫位置。

    視資料庫位置而定，新資料庫的網址會採用下列其中一種形式：

    • DATABASE_NAME.firebaseio.com (適用於 us-central1 中的資料庫)

    • DATABASE_NAME.REGION.firebasedatabase.app (適用於所有其他位置的資料庫)

  4. 按一下「完成」。

啟用 Realtime Database 時，系統也會在 Cloud API 管理工具中啟用 API。

建立及初始化 firebase::App

您必須先建立並初始化 firebase::App，才能存取 Realtime Database。

加入 firebase::App 的標頭檔案：

#include "firebase/app.h"

Android

建立 firebase::App，並傳遞 JNI 環境和 Java 活動的 jobject 參照做為引數：

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，控管資料庫的存取權。

後續步驟

已知問題

  • 在電腦平台 (Windows、Mac、Linux) 上，Firebase C++ SDK 會使用 REST 存取資料庫。因此，您必須在桌面上使用 Query::OrderByChild() 宣告所用的索引，否則接聽程式會失敗。
  • 電腦版 Realtime Database 工作流程不支援離線或持續性。