您可以使用 Firebase 遠程配置在應用中定義參數並在雲中更新它們的值,從而允許您修改應用的外觀和行為,而無需分發應用更新。本指南將引導您完成入門步驟並提供一些示例代碼,所有這些都可以從firebase/quickstart-ios GitHub 存儲庫克隆或下載。
將遠程配置添加到您的應用程序
創建單例遠程配置對象,如下例所示:
迅速
remoteConfig = RemoteConfig.remoteConfig() let settings = RemoteConfigSettings() settings.minimumFetchInterval = 0 remoteConfig.configSettings = settings
Objective-C
self.remoteConfig = [FIRRemoteConfig remoteConfig]; FIRRemoteConfigSettings *remoteConfigSettings = [[FIRRemoteConfigSettings alloc] init]; remoteConfigSettings.minimumFetchInterval = 0; self.remoteConfig.configSettings = remoteConfigSettings;
此對像用於存儲應用內默認參數值、從遠程配置後端獲取更新的參數值以及控制獲取的值何時可用於您的應用。
在開發過程中,建議設置一個相對較低的最小獲取間隔。有關詳細信息,請參閱節流。
設置應用內默認參數值
您可以在 Remote Config 對像中設置應用內默認參數值,以便您的應用在連接到 Remote Config 後端之前按預期運行,並且如果後端沒有設置默認值,則可以使用默認值。
使用
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 控制台
在參數選項卡中,打開 菜單,然後選擇下載默認值。
出現提示時,為 iOS 啟用 .plist ,然後單擊下載文件。
使用
setDefaults:
將這些值添加到遠程配置對象。以下示例從 plist 文件設置應用內默認值:迅速
remoteConfig.setDefaults(fromPlist: "RemoteConfigDefaults")
Objective-C
[self.remoteConfig setDefaultsFromPlistFileName:@"RemoteConfigDefaults"];
獲取要在您的應用中使用的參數值
現在您可以從遠程配置對像中獲取參數值。如果您稍後在遠程配置後端設置值,獲取它們,然後激活它們,那麼這些值對您的應用程序可用。否則,您將獲得使用setDefaults:
配置的應用內參數值。要獲取這些值,請調用configValueForKey:
方法,提供參數鍵作為參數。
設置參數值
使用 Firebase 控制台或Remote Config 後端 API ,您可以創建新的後端默認值,根據您所需的條件邏輯或用戶定位覆蓋應用內值。本部分將引導您完成創建這些值的 Firebase 控制台步驟。
- 在Firebase 控制台中,打開您的項目。
- 從菜單中選擇遠程配置以查看遠程配置儀表板。
- 定義與您在應用程序中定義的參數同名的參數。對於每個參數,您可以設置一個默認值(最終將覆蓋應用內默認值),您還可以設置條件值。要了解更多信息,請參閱遠程配置參數和條件。
獲取和激活值
要從遠程配置中獲取參數值,請調用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() }
Objective-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 個獲取請求(較新版本具有更多許可限制)。
在應用程序開發期間,您可能希望非常頻繁地刷新緩存(每小時多次),以便在開發和測試應用程序時快速迭代。為了適應具有眾多開發人員的項目的快速迭代,您可以在您的應用程序中臨時添加一個具有較低最小獲取間隔 ( MinimumFetchInterval
) 的FIRRemoteConfigSettings
屬性。
遠程配置的默認和推薦生產獲取間隔為 12 小時,這意味著在 12 小時窗口內不會多次從後端獲取配置,無論實際進行了多少次獲取調用。具體來說,最小獲取間隔按以下順序確定:
-
fetch(long)
中的參數 FIRRemoteConfigSettings.MinimumFetchInterval
中的參數- 默認值 12 小時
下一步
如果您還沒有,請探索遠程配置用例,並查看一些關鍵概念和高級策略文檔,包括: