開始使用 Firebase 遠端設定

您可以使用 Firebase 遠端設定在應用程式中定義參數，並在雲端更新參數的值，這樣就能在不發布應用程式更新的情況下修改應用程式的外觀與行為。

遠端設定程式庫可用來儲存應用程式內的預設參數值、從遠端設定後端擷取更新後的參數值，並控管應用程式擷取擷取值的時間。詳情請參閱遠端設定載入策略。

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

使用遠端設定之前，您需要先完成以下步驟：

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

  如果 C++ 專案已使用 Firebase，表示專案已經註冊並為 Firebase 進行設定。

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

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

步驟 2：在應用程式中新增遠端設定

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

您可以在遠端設定物件中設定應用程式內預設參數值，讓應用程式在連線至遠端設定後端前可正常運作，如此在後端未設定任何預設值時，即可使用預設值。

1. 請使用 std::map<const char*, const char*> 物件或 std::map<const char*, firebase::Variant> 物件定義一組參數名稱和預設參數值。

   • 瞭解 firebase::Variant。

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

2. 使用 SetDefaults() 將這些值新增至遠端設定物件。

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

您現在可以透過遠端設定物件取得參數值。如果您在遠端設定後端設定這些值、擷取值後再啟用，應用程式就能使用這些值。否則，則會使用 SetDefaults() 設定應用程式內參數值。

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

• GetBoolean()
• GetData()
• GetDouble()
• GetLong()
• GetString()

步驟 5：設定參數值

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

步驟 6：擷取並啟用值

1. 如要從遠端設定後端擷取參數值，請呼叫 Fetch() 方法。系統會擷取您在後端設定的任何值，並儲存在遠端設定物件中。
2. 若要向應用程式提供擷取的參數值，請呼叫 ActivateFetched()

步驟 7：聽取即時動態

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

Android 和 Apple 平台的 Firebase C++ SDK 11.0.0 以上版本支援即時更新。

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

下次您發布新版本的遠端設定時，執行應用程式並監聽變更的裝置會呼叫設定更新事件監聽器。

後續步驟

如果您尚未瞭解遠端設定的用途，請先查看一些重要概念和進階策略說明文件，包括：

• 管理遠端設定範本版本
• 設定載入策略