開始使用 Firebase 遠端設定


您可以使用 Firebase 遠端設定來定義應用程式中的參數, 更新雲端值,讓您可以修改外觀和 未發布應用程式更新。

遠端設定程式庫是用來儲存應用程式內的預設參數值 從遠端設定後端擷取更新後的參數值 控制系統何時會將擷取到的值提供給應用程式。如要瞭解詳情 請參閱遠端設定載入策略

步驟 1:將 Firebase 新增至應用程式

使用前 遠端設定 請完成下列操作:

  • 註冊 C++ 專案,並將其設為使用 Firebase。

    如果您的 C++ 專案已使用 Firebase,表示該專案已註冊, 設定 Firebase 專屬的容器

  • 在 C++ 專案中新增 Firebase C++ SDK

請注意,將 Firebase 新增至 C++ 專案時,需要執行 Firebase 控制台,然後在開放式 C++ 專案中 (例如下載 控制台中的 Firebase 設定檔,然後將這些檔案移至 C++ 專案)。

步驟 2:在應用程式中加入遠端設定

Android

將 Firebase 新增至應用程式後:

  1. 建立 Firebase 應用程式,並傳入 JNI 環境和 Activity:

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

  2. 初始化遠端設定程式庫,如下所示:

    ::firebase::remote_config::Initialize(app);

iOS+

將 Firebase 新增至應用程式後:

  1. 建立 Firebase 應用程式:

    app = ::firebase::App::Create(::firebase::AppOptions());

  2. 初始化遠端設定程式庫,如下所示:

    ::firebase::remote_config::Initialize(app);

步驟 3:設定應用程式內預設參數值

您可以在遠端設定中設定應用程式內預設參數值 物件,因此應用程式在連線至 遠端設定後端。這樣一來,在沒有預設值的情況下,系統就會提供預設值 在後端設定回應

  1. 使用 std::map<const char*, const char*> 物件或 std::map<const char*, firebase::Variant> 物件。

    如果已設定遠端設定後端參數 您可以下載內含這些鍵/值組合的檔案,然後 以建構 map 物件若需更多資訊,請參閲 下載 遠端設定範本預設值

  2. 使用以下程式碼將這些值新增至遠端設定物件 SetDefaults().

步驟 4:取得要用於應用程式的參數值

您現在可以從遠端設定物件取得參數值。如果您為 來擷取及啟用這些值 適用於您的應用程式否則,您會收到應用程式內參數 值是使用 SetDefaults().

如要取得這些值,請呼叫下列對應至資料類型的方法 ,並提供參數鍵做為引數:

步驟 5:設定參數值

  1. Firebase 控制台開啟專案。
  2. 從選單中選取「遠端設定」,查看「遠端設定」資訊主頁。
  3. 使用與剛才定義的參數相同的名稱定義參數 您可以為每個參數設定預設值 (也就是 最終覆寫應用程式內預設值) 和條件式值。 詳情請參閱: 遠端設定參數和條件

步驟 6:擷取並啟用值

  1. 如要從遠端設定後端擷取參數值,請呼叫 Fetch() 方法。系統將擷取您在後端設定的任何值 快取錯誤。
  2. 如要讓應用程式使用擷取的參數值,請呼叫 ActivateFetched()

步驟 7:即時監聽更新

擷取參數值後,您可以使用即時遠端設定來 來監聽來自遠端設定後端的更新即時 有可用的更新時,遠端設定功能會向已連線的裝置發出信號, 在您發布新的遠端設定後,自動擷取變更 版本。

Firebase C++ SDK 支援即時更新 11.0.0 以上版本 (適用於 Android 和 Apple 平台)。

  1. 在應用程式中呼叫 AddOnConfigUpdateListener,即可開始監聽更新 並自動擷取任何全新或更新的參數值下列 範例會監聽更新,並在呼叫 Activate 時,使用 擷取的值來顯示更新後的歡迎訊息。
remote_config->AddOnConfigUpdateListener(
    [](firebase::remote_config::ConfigUpdate&& config_update,
       firebase::remote_config::RemoteConfigError remote_config_error) {
      if (remote_config_error != firebase::remote_config::kRemoteConfigErrorNone) {
        printf("Error listening for config updates: %d", remote_config_error);
      }
      // Search the `updated_keys` set for the key "welcome_message."
      // `updated_keys` represents the keys that have changed since the last
      // fetch.
      if (std::find(config_update.updated_keys.begin(),
                    config_update.updated_keys.end(),
                    "welcome_message") != config_update.updated_keys.end()) {
        remote_config->Activate().OnCompletion(
            [&](const firebase::Future& completed_future,
               void* user_data) {
              // The key "welcome_message" was found within `updated_keys` and
              // can be activated.
              if (completed_future.error() == 0) {
                DisplayWelcomeMessage();
              } else {
                printf("Error activating config: %d", completed_future.error());
              }
            },
            nullptr);
      }
    });

下次發布新版遠端設定時,裝置 正在運作應用程式及監聽變更,將呼叫設定檔 更新事件監聽器。

後續步驟

如果您尚未探索遠端設定,請先探索 用途,以及 重要概念和進階策略說明文件,包括: