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

開始使用 Firebase 遠端設定

您可以使用 Firebase Remote Config 在應用程式中定義參數，並在雲端更新參數值，藉此修改應用程式的外觀和行為，而不必發布應用程式更新。本指南將逐步引導您開始使用，並提供一些程式碼範例，您可以從 firebase/quickstart-js GitHub 存放區複製或下載這些程式碼範例。

步驟 1：新增並初始化 Remote Config SDK

如果您還沒有這樣做，安裝 Firebase JS SDK 並初始化 Firebase。
新增 Remote Config JS SDK 並初始化 Remote Config：

Web

import { initializeApp } from "firebase/app";
import { getRemoteConfig } from "firebase/remote-config";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);


// Initialize Remote Config and get a reference to the service
const remoteConfig = getRemoteConfig(app);

Web

import firebase from "firebase/compat/app";
import "firebase/compat/remote-config";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);


// Initialize Remote Config and get a reference to the service
const remoteConfig = firebase.remoteConfig();

這個物件是用來儲存應用程式內的預設參數值，並擷取更新後的值來自 Remote Config 後端的參數值，並在擷取時控管適用於您的應用程式

步驟 2：設定最小擷取間隔

在開發期間，建議您將最小擷取間隔設為較低。請參閱節流，瞭解瞭解詳情

Web

remoteConfig.settings.minimumFetchIntervalMillis = 3600000;rc_set_minimum_fetch_time.js

Web

remoteConfig.settings.minimumFetchIntervalMillis = 3600000;index.js

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

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

Web

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

Web

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

如果已設定 Remote Config 後端參數值，您可以下載產生的 JSON 檔案，其中包含所有預設值請在應用程式套件中加入這個 SDK：

REST

curl --compressed -D headers -H "Authorization: Bearer token" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig:downloadDefaults?format=JSON -o remote_config_defaults.json

Firebase 主控台

在「Parameters」分頁中開啟選單，然後選取 下載預設值。
出現提示時，啟用網頁版 .json，然後點選「下載檔案」。

以下範例說明在應用程式中匯入及設定預設值的兩種不同方式。第一個範例使用 fetch，會對應用程式套件中包含的預設檔案提出 HTTP 要求：


  const rcDefaultsFile = await fetch('remote_config_defaults.json');
  const rcDefaultsJson = await rcDefaultsFile.json();
  remoteConfig.defaultConfig = rcDefaultsJson;

下一個範例使用 require，這個方法會在建構期間將值編譯至應用程式：

  let rcDefaults = require('./remote_config_defaults.json');
  remoteConfig.defaultConfig = rcDefaults;

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

您現在可以從 Remote Config 物件取得參數值。如果您之後在後端設定值、擷取值，然後再啟用這些值，這些值就會提供給應用程式。如要取得這些值，請呼叫 getValue() 方法，並提供參數鍵做為引數。

Web

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

const val = getValue(remoteConfig, "welcome_messsage");rc_get_values.js

Web

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

步驟 5：設定參數值

您可以使用 Firebase 控制台或 Remote Config 後端 API，建立新的伺服器端預設值，根據所需的條件邏輯或使用者指定值覆寫應用程式內的值。本節將逐步說明如何透過 Firebase 資訊主頁建立這些值。

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

步驟 6：擷取並啟用值

如要從 Remote Config 後端擷取參數值，請呼叫 fetchConfig() 方法。系統會擷取您在後端設定的所有值，並將這些值快取到 Remote Config 物件中。
如要讓應用程式使用擷取的參數值，請呼叫 activate()敬上方法。

如果您想在單一呼叫中擷取及啟用值，請使用 fetchAndActivate()，如以下範例所示：

Web

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

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

Web

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

由於這些更新的參數值會影響應用程式的行為和外觀，因此您應在確保使用者享有順暢體驗的時間點啟用擷取的值，例如使用者下次開啟應用程式時。如需更多資訊和範例，請參閱「遠端設定載入策略」。

調節

如果應用程式在短時間內擷取次數過多，擷取呼叫可能會限制數量在這種情況下，SDK 會擲回 FETCH_THROTTLE 錯誤。建議您擷取這個錯誤，以指數輪詢模式重試。在後續的擷取要求之間等待較長的間隔。

在應用程式開發期間，建議您頻繁地重新整理快取 (每小時多次) 方便您在開發及測試應用程式。為了因應有眾多開發人員的專案快速疊代可以暫時新增擷取間隔下限較低的屬性 (Settings.minimumFetchIntervalMillis)。

Remote Config 的預設和建議的正式版擷取間隔 12 小時這代表在 12 小時內，系統不會多次從後端擷取設定則無論實際發出多少擷取呼叫。具體而言，系統會依以下順序決定最小擷取間隔：

Settings.minimumFetchIntervalMillis 中的參數。
預設值是 12 小時。

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

後續步驟

如果尚未體驗，請前往Remote Config 用途，以及重要概念和進階策略說明文件，包括：