開始使用 Firebase 遠端設定


您可以使用 Firebase Remote Config 在應用程式中定義參數,並在雲端更新參數值,藉此修改應用程式的外觀和行為,而不必發布應用程式更新。

Remote Config 程式庫可用於儲存應用程式內的預設參數值、從 Remote Config 後端擷取更新的參數值,以及控制擷取的值何時可供應用程式使用。如需更多資訊,請參閱「遠端設定載入策略」。

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

如要使用 Remote Config,您必須先完成下列步驟:

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

    如果您的 C++ 專案已使用 Firebase,則表示已為 Firebase 註冊及設定。

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

請注意,將 Firebase 新增至 C++ 專案時,必須同時在 Firebase 主控台和您開啟的 C++ 專案中執行任務 (例如,從主控台下載 Firebase 設定檔,然後將其移至 C++ 專案)。

步驟 2:在應用程式中加入 Remote Config

Android

將 Firebase 新增至應用程式後:

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

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

  2. 初始化 Remote Config 程式庫,如下所示:

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

iOS+

將 Firebase 新增至應用程式後:

  1. 建立 Firebase 應用程式:

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

  2. 初始化 Remote Config 程式庫,如下所示:

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

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

您可以在 Remote Config 物件中設定應用程式內的預設參數值,讓應用程式在連線至 Remote Config 後端之前正常運作,並在後端未設定任何預設值時使用預設值。

  1. 使用 ConfigKeyValue* 物件或 ConfigKeyValueVariant* 物件 (具有陣列大小),定義一組參數名稱和預設參數值。

    如果您已設定 Remote Config 後端參數值,可以下載包含這些鍵/值組合的檔案,並使用該檔案建構 map 物件。詳情請參閱「下載 Remote Config 範本預設值」。

  2. 使用 SetDefaults() 將這些值新增至 Remote Config 物件。

步驟 4:取得要在應用程式中使用的參數值

您現在可以從 Remote Config 物件取得參數值。如果您在 Remote Config 後端設定值、擷取值,然後啟用這些值,這些值就會提供給應用程式。否則,您會取得使用 SetDefaults() 設定的應用程式內參數值。

如要取得這些值,請呼叫下列對應至應用程式預期資料類型的函式,並提供參數鍵做為引數:

步驟 5:設定參數值

  1. Firebase 主控台中開啟專案。
  2. 從選單中選取 Remote Config,即可查看 Remote Config 資訊主頁。
  3. 定義參數時,請使用與應用程式中定義的參數相同的名稱。您可以為每個參數設定預設值 (最終會覆寫應用程式內的預設值) 和條件值。詳情請參閱 Remote Config 參數和條件

步驟 6:擷取並啟用值

  1. 如要從 Remote Config 後端擷取參數值,請呼叫 Fetch() 方法。系統會擷取您在後端設定的所有值,並將這些值快取到 Remote Config 物件中。
  2. 如要讓應用程式使用擷取的參數值,請呼叫 ActivateFetched()

步驟 7:即時監聽更新

擷取參數值後,您可以使用即時 Remote Config 來監聽 Remote Config 後端的更新。當有可用的更新時,即時 Remote Config 會向已連結的裝置發出信號,並在您發布新 Remote Config 版本後自動擷取變更。

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);
      }
    });

下次發布新版 Remote Config 時,正在執行應用程式並監聽變更的裝置會呼叫設定更新事件監聽器。

後續步驟

如果您尚未探索,請參閱 Remote Config 用途,並查看一些重要概念和進階策略說明文件,包括: