開始使用 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 Manager 中啟用 API。

建立及初始化 firebase::App

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

納入 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 新增至應用程式，以便控管資料庫的存取權。

後續步驟

已知問題

  • 在電腦平台 (Windows、Mac、Linux) 上，Firebase C++ SDK 會使用 REST 存取資料庫。因此，您必須在電腦上使用 Query::OrderByChild() 宣告所用索引，否則事件監聽器將無法運作。
  • Realtime Database 的電腦版工作流程版本不支援離線或持久性。