本頁面由 Cloud Translation API 翻譯而成。

開始使用 Firebase 遠端設定

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

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

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

使用前 Remote Config、請完成下列操作：

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

如果您的 C++ 專案已使用 Firebase，表示該專案已註冊，設定 Firebase 專屬的容器
在 C++ 專案中新增 Firebase C++ SDK。

，瞭解如何調查及移除這項存取權。

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

步驟 2：將 Remote Config 新增至應用程式

Android

將 Firebase 新增至應用程式後：

建立 Firebase 應用程式，並傳入 JNI 環境和 Activity：

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

初始化 Remote Config 程式庫，如下所示：
```
::firebase::remote_config::Initialize(app);
```

iOS+

將 Firebase 新增至應用程式後：

建立 Firebase 應用程式：

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

初始化 Remote Config 程式庫，如下所示：
```
::firebase::remote_config::Initialize(app);
```

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

您可以在 Remote Config 中設定應用程式內預設參數值物件，因此應用程式在連線至 Remote Config 後端，這樣一來，在沒有預設值的情況下，就無法使用預設值在後端設定回應

使用 std::map<const char*, const char*> 物件或 std::map<const char*, firebase::Variant> 物件。
- 瞭解 firebase::Variant。
如果已設定 Remote Config 後端參數您可以下載內含這些鍵/值組合的檔案，然後藉此建構 map 物件若需更多資訊，請參閲下載 Remote Config範本預設值。
使用以下程式碼將這些值新增至 Remote Config 物件 SetDefaults()。

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

您現在可以從 Remote Config 物件取得參數值。如果您為 Remote Config 後端中的值、擷取值，然後加以啟用適用於您的應用程式否則，您會收到應用程式內參數值是使用 SetDefaults()。

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

步驟 5：設定參數值

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

步驟 6：擷取並啟用值

如要從 Remote Config 後端擷取參數值，請呼叫 Fetch() 方法。系統將擷取您在後端設定的任何值快取在 Remote Config 物件中。
如要讓應用程式使用擷取的參數值，請呼叫 ActivateFetched()敬上

步驟 7：即時監聽更新

擷取參數值後，您可以使用即時 Remote Config 執行以下操作：監聽來自 Remote Config 後端的更新。即時有可用的更新時，Remote Config 會發出已連線裝置的訊號，發布新的 Remote Config 後自動擷取變更版本。

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

在應用程式中呼叫 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 用途，以及重要概念和進階策略說明文件，包括：