Catch up on everthing we announced at this year's Firebase Summit. Learn more

開始使用 Firebase 遠程配置

您可以使用 Firebase 遠程配置在您的應用中定義參數並在雲中更新它們的值,從而允許您在不分發應用更新的情況下修改應用的外觀和行為。本指南將引導您上手的步驟,並提供了一些示例代碼,所有這些都可以從克隆或下載火力/快速啟動-JS GitHub的倉庫。

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

  1. 安裝火力地堡SDK的Web。

  2. 創建單例遠程配置對象:

    網頁版 9

    import { getRemoteConfig } from "firebase/remote-config";
    
    const remoteConfig = getRemoteConfig();

    網頁版 8

    const remoteConfig = firebase.remoteConfig();

    此對像用於存儲應用內默認參數值、從遠程配置後端獲取更新的參數值以及控制獲取的值何時可用於您的應用。

  3. 設置最小獲取間隔:

    網頁版 9

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

    網頁版 8

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

    在開發過程中,建議設置一個相對較低的最小獲取間隔。見節流以獲取更多信息。

設置應用內默認參數值

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

網頁版 9

remoteConfig.defaultConfig = {
  "welcome_message": "Welcome"
};

網頁版 8

remoteConfig.defaultConfig = {
  "welcome_message": "Welcome"
};

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

現在您可以從遠程配置對象獲取參數值。如果您稍後在後端設置值,獲取它們,然後激活它們,則這些值可用於您的應用程序。要獲得這些值,調用getValue()方法,提供參數鍵作為參數。

網頁版 9

import { getValue } from "firebase/remote-config";

const val = getValue(remoteConfig, "welcome_messsage");

網頁版 8

const val = remoteConfig.getValue("welcome_messsage");

設置參數值

使用火力地堡控制台或遠程配置後端的API ,你可以根據你的需要的條件邏輯或用戶針對覆蓋在應用程序的價值創造新的服務器端的默認值。本部分將引導您完成 Firebase 控制台步驟以創建這些值。

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

獲取並激活值

  1. 為了從遠程配置後端取的參數值,調用fetchConfig()方法。您在後端設置的任何值都將被提取並緩存在遠程配置對像中。
  2. 為了獲取參數值提供給您的應用程序,調用activate()方法。

對於您想獲取和一個呼叫激活值的情況下,使用fetchAndActivate()如本例所示:

網頁版 9

import { fetchAndActivate } from "firebase/remote-config";

fetchAndActivate(remoteConfig)
  .then(() => {
    // ...
  })
  .catch((err) => {
    // ...
  });

網頁版 8

remoteConfig.fetchAndActivate()
  .then(() => {
    // ...
  })
  .catch((err) => {
    // ...
  });

由於這些更新的參數值會影響應用程序的行為和外觀,因此您應該在確保為用戶提供流暢體驗的時間激活獲取的值,例如用戶下次打開您的應用程序時。見遠程配置加載策略的更多信息和示例。

節流

如果應用程序在短時間內獲取過多次數,則獲取調用可能會受到限制。在這種情況下,SDK將引發FETCH_THROTTLE錯誤。建議您捕獲此錯誤並以指數退避模式重試,等待後續獲取請求之間的更長間隔。

在應用程序開發期間,您可能希望非常頻繁地(每小時多次)刷新緩存,以便在開發和測試應用程序時快速迭代。為了適應與眾多開發商的一個項目快速迭代,你可以臨時添加的屬性具有低取最小間隔( Settings.minimumFetchIntervalMillis在您的應用程序)。

遠程配置的默認和推薦生產提取間隔為 12 小時,這意味著在 12 小時窗口內不會從後端多次提取配置,無論實際進行了多少次提取調用。具體來說,最小獲取間隔按以下順序確定:

  1. 在參數Settings.minimumFetchIntervalMillis
  2. 默認值為 12 小時。

下一步

如果你還沒有準備好,探索遠程配置使用情況,並看看一些關鍵概念和先進的戰略文件,其中包括: