Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

開始使用 Firebase 遠程配置

您可以使用 Firebase 遠程配置在您的應用中定義參數並在雲中更新它們的值,從而允許您在不分發應用更新的情況下修改應用的外觀和行為。本指南將引導您完成入門步驟並提供一些示例代碼,所有這些代碼均可從firebase/quickstart-ios GitHub 存儲庫克隆或下載。

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

  1. 安裝適用於 iOS的 Firebase SDK

  2. 創建單例遠程配置對象,如以下示例所示:

    迅速

    remoteConfig = RemoteConfig.remoteConfig()
    let settings = RemoteConfigSettings()
    settings.minimumFetchInterval = 0
    remoteConfig.configSettings = settings

    目標-C

    self.remoteConfig = [FIRRemoteConfig remoteConfig];
    FIRRemoteConfigSettings *remoteConfigSettings = [[FIRRemoteConfigSettings alloc] init];
    remoteConfigSettings.minimumFetchInterval = 0;
    self.remoteConfig.configSettings = remoteConfigSettings;

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

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

設置應用內默認參數值

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

  1. 使用NSDictionary像或plist 文件定義一組參數名稱和默認參數值。
  2. 使用setDefaults:將這些值添加到遠程配置對象。以下示例從 plist 文件設置應用內默認值:

迅速

remoteConfig.setDefaults(fromPlist: "RemoteConfigDefaults")

目標-C

[self.remoteConfig setDefaultsFromPlistFileName:@"RemoteConfigDefaults"];

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

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

設置參數值

使用 Firebase 控制台或遠程配置後端 API ,您可以創建新的後端默認值,根據您所需的條件邏輯或用戶定位覆蓋應用內值。本部分將引導您完成 Firebase 控制台步驟以創建這些值。

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

獲取並激活值

要從遠程配置獲取參數值,請調用fetchWithCompletionHandler:fetchWithExpirationDuration:completionHandler:方法。您在後端設置的任何值都將被提取並緩存在遠程配置對像中。

對於您想在一次調用中獲取和激活值的情況,請使用fetchAndActivateWithCompletionHandler:

此示例從遠程配置後端獲取值(不是緩存值)並調用activateWithCompletionHandler:以使它們可用於應用程序:

迅速

remoteConfig.fetch() { (status, error) -> Void in
  if status == .success {
    print("Config fetched!")
    self.remoteConfig.activate() { (changed, error) in
      // ...
    }
  } else {
    print("Config not fetched")
    print("Error: \(error?.localizedDescription ?? "No error available.")")
  }
  self.displayWelcome()
}

目標-C

[self.remoteConfig fetchWithCompletionHandler:^(FIRRemoteConfigFetchStatus status, NSError *error) {
    if (status == FIRRemoteConfigFetchStatusSuccess) {
        NSLog(@"Config fetched!");
      [self.remoteConfig activateWithCompletion:^(BOOL changed, NSError * _Nullable error) {
        // ...
      }];
    } else {
        NSLog(@"Config not fetched");
        NSLog(@"Error %@", error.localizedDescription);
    }
    [self displayWelcome];
}];

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

節流

如果應用程序在短時間內獲取過多次數,獲取調用會受到限制,並且 SDK 會返回FIRRemoteConfigFetchStatusThrottled 。在 SDK 版本 6.3.0 之前,限制是 60 分鐘窗口內 5 個獲取請求(新版本有更多的寬鬆限制)。

在應用程序開發期間,您可能希望非常頻繁地(每小時多次)刷新緩存,以便在開發和測試應用程序時快速迭代。為了適應具有眾多開發人員的項目的快速迭代,您可以在您的應用程序中臨時添加具有較低最小獲取間隔 ( MinimumFetchInterval ) 的FIRRemoteConfigSettings屬性。

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

  1. fetch(long)的參數
  2. FIRRemoteConfigSettings.MinimumFetchInterval的參數
  3. 默認值 12 小時

下一步

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