開始使用 Firebase 遠程配置


您可以使用 Firebase 遠程配置在應用中定義參數並在雲中更新它們的值，從而允許您修改應用的外觀和行為，而無需分發應用更新。本指南將引導您完成入門步驟並提供一些示例代碼。

1. 將 Firebase 和 Remote Config SDK 添加到您的應用中

  1. 如果您尚未安裝並初始化 Flutter 的 Firebase SDK 。

  2. 對於遠程配置，需要使用 Google Analytics將應用實例有條件地定位到用戶屬性和受眾。確保在項目中啟用 Google Analytics 。

  3. 在 Flutter 項目的根目錄中，運行以下命令來安裝 Remote Config 插件：

    flutter pub add firebase_remote_config

    此外，作為設置遠程配置的一部分，您需要將 Firebase SDK for Google Analytics 添加到您的應用中：

    flutter pub add firebase_analytics

  4. 重建你的項目：

    flutter run

2.獲取Remote Config單例對象

獲取遠程配置對象實例並設置最小獲取間隔以允許頻繁刷新：

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

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

在開發過程中，建議設置一個相對較低的最小獲取間隔。有關詳細信息，請參閱節流。

3.設置應用內默認參數值

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

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.在Remote Config後端設置參數值

使用 Firebase 控制台或Remote Config 後端 API ，您可以創建新的服務器端默認值，根據您所需的條件邏輯或用戶定位覆蓋應用內值。本部分介紹了創建這些值的 Firebase 控制台步驟。

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

6. 獲取和激活值

  1. 要從遠程配置後端獲取參數值，請調用fetch()方法。您在後端設置的任何值都會被提取並存儲在遠程配置對像中。

  2. 要使獲取的參數值可用於您的應用程序，請調用activate()方法。

    對於您想在一次調用中獲取和激活值的情況，您可以使用fetchAndActivate()請求從遠程配置後端獲取值並將它們提供給應用程序：

    await remoteConfig.fetchAndActivate();

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

節流

如果應用在短時間內獲取太多次，獲取調用將被限制，並且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),
));

下一步

如果您還沒有，請探索遠程配置用例，並查看一些關鍵概念和高級策略文檔，包括：