開始使用 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

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

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

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

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

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

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

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

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

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

步驟 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 用途，並查看一些重要概念和進階策略說明文件，包括：

• 管理 Remote Config 範本版本
• 設定載入策略