Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

開始使用 Firebase 遠程配置

透過集合功能整理內容 你可以依據偏好儲存及分類內容。


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

第 1 步:將遠程配置添加到您的應用

  1. 安裝適用於 Apple 平台的 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;

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

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

第 2 步:設置應用內默認參數值

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

  1. 使用NSDictionary對像或plist 文件定義一組參數名稱和默認參數值。

    如果您已經配置了 Remote Config 後端參數值,您可以下載包含所有默認值的生成的plist文件並將其保存到您的 Xcode 項目中。

    休息

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

    Firebase 控制台

    1. Parameters選項卡中,打開 Menu ,然後選擇Download default values

    2. 出現提示時,為 iOS 啟用 .plist ,然後單擊下載文件

  2. 使用setDefaults:將這些值添加到遠程配置對象。以下示例從 plist 文件設置應用內默認值:

    迅速

    remoteConfig.setDefaults(fromPlist: "RemoteConfigDefaults")

    目標-C

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

第 3 步:獲取要在您的應用中使用的參數值

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

第 4 步:設置參數值

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

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

第 5 步:獲取並激活值

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

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

此示例從 Remote Config 後端獲取值(不是緩存的值)並調用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) {
        if (error != nil) {
          NSLog(@"Activate error: %@", error.localizedDescription);
        } else {
          dispatch_async(dispatch_get_main_queue(), ^{
            [self displayWelcome];
          });
        }
      }];
    } else {
        NSLog(@"Config not fetched");
        NSLog(@"Error %@", error.localizedDescription);
    }
}];

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

節流

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

在應用程序開發期間,您可能希望非常頻繁地刷新緩存(每小時多次),以便在開發和測試應用程序時快速迭代。 To accommodate rapid iteration on a project with numerous developers, you can temporarily add a FIRRemoteConfigSettings property with a low minimum fetch interval ( MinimumFetchInterval ) in your app.

The default and recommended production fetch interval for Remote Config is 12 hours, which means that configs won't be fetched from the backend more than once in a 12 hour window, regardless of how many fetch calls are actually made. Specifically, the minimum fetch interval is determined in this following order:

  1. The parameter in fetch(long)
  2. The parameter in FIRRemoteConfigSettings.MinimumFetchInterval
  3. The default value of 12 hours

Next steps

If you haven't already, explore the Remote Config use cases , and take a look at some of the key concepts and advanced strategies documentation, including: