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

開始使用 Firebase 遠端設定

您可以使用 Firebase 遠端設定來定義應用程式中的參數，然後進行更新設定，讓您可以修改模型的外觀與行為不必發布應用程式更新。本指南將逐步引導您踏出第一步，並提供一些程式碼範例。

步驟 1：在應用程式中加入 Firebase 和遠端設定 SDK

安裝並初始化 Flutter 專用的 Firebase SDK (如有) 。
如果是遠端設定，則必須啟用 Google Analytics 應用程式執行個體的條件式指定功能使用者屬性和目標對象請確認您在專案中啟用 Google Analytics。
在 Flutter 專案的根目錄中執行下列指令指令安裝遠端設定外掛程式：
```
flutter pub add firebase_remote_config
```
此外，在設定遠端設定的過程中，你必須新增 Firebase SDK 如何使用 Google Analytics 傳送至您的應用程式
```
flutter pub add firebase_analytics
```
重新建構您的專案：
```
flutter run
```
如果您在 macOS 上使用遠端設定，請啟用鑰匙圈共用。

步驟 2：取得遠端設定單例模式物件

取得遠端設定物件執行個體，然後設定允許經常重新整理的最小擷取間隔：

final remoteConfig = FirebaseRemoteConfig.instance;
await remoteConfig.setConfigSettings(RemoteConfigSettings(
    fetchTimeout: const Duration(minutes: 1),
    minimumFetchInterval: const Duration(hours: 1),
));

單例模式物件是用來儲存應用程式內的預設參數值更新過的參數值，並且控制系統擷取到可用的更新

在開發期間，建議您設定相對較低的擷取次數下限間隔。詳情請參閱節流。

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

您可以在遠端設定中設定應用程式內預設參數值物件，因此應用程式在連線至遠端設定後端。這樣一來，在沒有預設值的情況下，系統就會提供預設值您在後端中設定的連線

await remoteConfig.setDefaults(const {
    "example_param_1": 42,
    "example_param_2": 3.14159,
    "example_param_3": true,
    "example_param_4": "Hello, world!",
});

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

您現在可以從遠端設定物件取得參數值。如果您為擷取這些值，然後予以啟用這些價值適用於您的應用程式。否則，您可以取得參數值。setDefaults()

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

getBool()
getDouble()
getInt()
getString()

步驟 5：在遠端設定後端設定參數值

使用 Firebase 控制台或遠端設定後端 API 您可以建立新的伺服器端預設值，用來覆寫應用程式內的值將採用您所需的條件式邏輯或使用者指定目標為依據這個區段，接著說明在 Firebase 控制台中建立這些值的步驟。

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

步驟 6：擷取並啟用值

如要從遠端設定後端擷取參數值，請呼叫 fetch() 方法。系統會擷取您在後端設定的任何值。並儲存在遠端設定物件中
如要讓應用程式使用擷取的參數值，請呼叫 activate() 方法。

如要透過單一呼叫擷取及啟用值，可以使用 fetchAndActivate() 要求，從遠端設定後端並提供給應用程式：
```
await remoteConfig.fetchAndActivate();
```

這些更新過的參數值會影響行為和外觀建議您每次都啟用擷取到的值，流暢的使用者體驗，例如使用者下次開啟應用程式。請參閱遠端設定載入策略。。

步驟 7：即時監聽更新

擷取參數值後，您就能使用即時遠端設定來監聽，以便從遠端設定後端進行更新。即時遠端設定信號，如果有可用的更新，系統就會自動擷取在您發布新的遠端設定版本後進行的變更。

請注意，即時遠端設定不適用於網頁。

在應用程式中，使用 onConfigUpdated 開始監聽更新和自動擷取任何新的參數值。

 remoteConfig.onConfigUpdated.listen((event) async {
   await remoteConfig.activate();

   // Use the new config values here.
 });

下次您發布新版遠端設定時，啟動應用程式，並監聽變更會啟用新設定。

調節

如果應用程式在短時間內擷取的次數過多，擷取呼叫將會受限和 FirebaseRemoteConfig 的「lastFetchStatus」值將設為 RemoteConfigFetchStatus.throttle

遠端設定的預設擷取間隔下限為 12 小時，這代表在 12 小時內，系統不會多次從後端擷取設定則無論實際發出多少擷取呼叫。

在應用程式開發期間，如果您沒有使用即時遠端設定 (我們建議)，建議您盡可能頻繁地擷取及啟用設定 (每小時多次) 方便您在開發及測試應用程式。如要因應多達 10 名開發人員的專案快速疊代作業，可以透過 setConfigSettings() 暫時設定較短的擷取間隔下限。

final remoteConfig = FirebaseRemoteConfig.instance;
await remoteConfig.setConfigSettings(RemoteConfigSettings(
    fetchTimeout: const Duration(minutes: 1),
    minimumFetchInterval: const Duration(minutes: 5),
));

後續步驟

如果您尚未探索遠端設定，請先探索用途，以及重要概念和進階策略說明文件，包括：