開始使用 Firebase 遠端設定


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

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

  1. 安裝並初始化 Flutter 專用的 Firebase SDK (如有) 。

  2. 遠端設定必須啟用 Google Analytics 應用程式執行個體的條件式指定功能 使用者屬性和目標對象請確認 您在專案中啟用 Google Analytics

  3. 在 Flutter 專案的根目錄中執行下列指令 指令安裝遠端設定外掛程式:

    flutter pub add firebase_remote_config
    

    此外,在設定遠端設定的過程中,你必須新增 Firebase SDK 如何使用 Google Analytics 傳送至您的應用程式

    flutter pub add firebase_analytics
    
  4. 重新建構您的專案:

    flutter run
    
  5. 如果您在 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 控制台中建立這些值的步驟。

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

步驟 6:擷取並啟用值

  1. 如要從遠端設定後端擷取參數值,請呼叫 fetch() 方法。系統會擷取您在後端設定的任何值。 並儲存在遠端設定物件中

  2. 如要讓應用程式使用擷取的參數值,請呼叫 activate() 方法。

    如要透過單一呼叫擷取及啟用值, 可以使用 fetchAndActivate() 要求,從 遠端設定後端並提供給應用程式:

    await remoteConfig.fetchAndActivate();
    

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

步驟 7:即時監聽更新

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

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

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

     remoteConfig.onConfigUpdated.listen((event) async {
       await remoteConfig.activate();
    
       // Use the new config values here.
     });
    
  2. 下次您發布新版遠端設定時, 啟動應用程式,並監聽變更會啟用新設定。

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

調節

如果應用程式在短時間內擷取的次數過多,擷取呼叫將會 受限和 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),
));

後續步驟

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