Check out what’s new from Firebase at Google I/O 2022. Learn more

開始使用 Firebase 遠程配置

您可以使用 Firebase 遠程配置在應用中定義參數並在雲中更新它們的值,從而允許您修改應用的外觀和行為,而無需分發應用更新。

遠程配置庫用於存儲應用內默認參數值,從遠程配置後端獲取更新的參數值,並控制獲取的值何時可用於您的應用。要了解更多信息,請參閱遠程配置加載策略

將 Firebase 添加到您的應用

在使用Remote Config之前,您需要:

  • 註冊您的 C++ 項目並將其配置為使用 Firebase。

    如果您的 C++ 項目已經使用 Firebase,那麼它已經為 Firebase 註冊和配置。

  • Firebase C++ SDK添加到您的 C++ 項目。

請注意,將 Firebase 添加到您的 C++ 項目涉及Firebase 控制台和打開的 C++ 項目中的任務(例如,您從控制台下載 Firebase 配置文件,然後將它們移動到您的 C++ 項目中)。

將遠程配置添加到您的應用程序

安卓

將 Firebase 添加到您的應用後:

  1. 創建一個Firebase App,傳入JNI環境和Activity:

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

設置應用內默認參數值

您可以在遠程配置對像中設置應用內默認參數值,以便您的應用在連接到遠程配置後端之前按預期運行,並且如果後端沒有設置默認值,則可以使用默認值。

  1. 使用std::map<const char*, const char*>對像或std::map<const char*, firebase::Variant>對象定義一組參數名稱和默認參數值。

    如果您已經配置了 Remote Config 後端參數值,您可以下載一個包含這些鍵/值對的文件並使用它來構造您的map對象。有關詳細信息,請參閱下載遠程配置模板默認值

  2. 使用SetDefaults()將這些值添加到遠程配置對象。

獲取要在您的應用中使用的參數值

現在您可以從遠程配置對像中獲取參數值。如果您在遠程配置後端設置值,獲取它們,然後激活它們,那麼這些值對您的應用程序可用。否則,您將獲得使用SetDefaults()配置的應用內參數值。

要獲取這些值,請調用下面列出的映射到應用所需數據類型的方法,並提供參數鍵作為參數:

在 Firebase 控制台中連接您的應用

Firebase 控制台中,將您的應用添加到您的 Firebase 項目。

設置參數值

  1. Firebase 控制台中,打開您的項目。
  2. 從菜單中選擇遠程配置以查看遠程配置儀表板。
  3. 定義與您在應用程序中定義的參數同名的參數。對於每個參數,您可以設置默認值(最終將覆蓋應用內默認值)和條件值。要了解更多信息,請參閱遠程配置參數和條件

獲取和激活值

  1. 要從遠程配置後端獲取參數值,請調用Fetch()方法。您在後端設置的任何值都會被獲取並緩存在遠程配置對像中。
  2. 要使獲取的參數值可用於您的應用程序,請調用ActivateFetched()

下一步

If you haven't already, explore the Remote Config use cases , and take a look at some of the key concepts and advanced strategies documentation, including: