Firebase iOS 远程配置教程
原文：Firebase Remote Config Tutorial for iOS
作者：Todd Kerpelman
译者：kmyhy
在你发布应用程序的时候，app 各个方面都已经完美了吗？你永远不需要碰其它代码，因为无论什么东西你一次就能做对？
哈，我做不到。
作为一名成功的 app 开发者，通常需要对 app 进行频繁的更改。有时，这些更改是增加功能或者 bug 的修复。但是，有时，最有关键的修改只是一行代码而已，比如调整一下文字或者在一个塔式防御游戏中削弱一个强大的单元。
虽然这些修改很简单，但是发布它却要花一两天的时间。如果你只需要做一些调整，但不需要经历这整个过程就太好了。
Firebase 远程配置提供了这种能力。在这篇基于 Firebase 的 iOS 远程配置教程中，你将使用 Planet Tour app 来学习如何修改文本、颜色和其他行为，而无需发布新版本！掌握了它以后，你将学到更强大的功能，面向不同用户交付不同内容。
前提条件：这篇基于 Firebase 的 iOS 远程配置教程假设您安装了 cocoaPods 并对它有一定的了解。如果不是这样，请查看我们的 CocoaPods 教程。
开始
在本教程的顶部或底部有下载链接，请首先下载。解压并运行开始项目。你可以滑动以查看不同的行星，点击每一个行星来获得一些（大部分是准确的）详情信息。
你刚刚下载的 app 是 Planet Tour APP 公司制作的，它一直都很正常，直到有一天，来自市场营销的格雷格决定，行星之旅变成绿色的配色方案，以庆祝地球日。
如果你打开 AppConstants.swift，你会发现这很容易搞定。有一个 appPrimaryColor变量，修改它会同时改变到许多文本标签的颜色。将改变推给用户需要发布一个新版本，将它提交给应用商店，通过审批，然后等用户在地球日之前下载它。一旦地球日结束，你必须重新做整个过程，恢复之前的样子。
如果能从云端修改这些值，那就好了。
安装远程配置库
要将 AppConstants 中的硬编码值修改为远程配置，需要在 Firebase 控制台中新建一个项目，将它和 Planet Tour app 关联，然后安装 Firebase 远程配置库。
步骤如下：
- 打开网址 firebase.google.com/console
- 点击 Create New Project.
将项目名称命名为 Planet Tour，选中你所在的区域，然后点击 Create Project。
点击 Add Firebase to your iOS app:
设置项目的 bundle ID 为 com.razeware.Planet-Tour —— 保持 App Store ID 字段留空，然后点击 Register App:
点击 Download 下载一个 GoogleServices-info.plist 文件:
浏览器会下载一个 GoogleServices-info.plist 文件。将它拖进你的 Xcode 项目中。确保选择 Copy Items if Needed。
不停点击向导中的 Continue 按钮。别怕，接下来你将会看到这些指引。
- 在 Xcode 中关闭 Planet Tour。
- 打开终端窗口，进入项目目录，输入 pod init ，创建一个 Podfile 文件。
编辑 Podfile 文件为：
# Uncomment the next line to define a global platform for your project platform :ios, '9.0' target 'Planet Tour' do # Comment the next line if you're not using Swift and don't want to use dynamic frameworks use_frameworks! # Pods for Planet Tour pod 'Firebase/Core' pod 'Firebase/RemoteConfig' end执行 pod install, 用 Xcode 打开 Planet Tour.xcworkspace。
打开 AppDelegate.swift.在 import UIKit 之后添加:
import Firebase
然后，在 application(_:didFinishLaunchingWithOptions:) 的 return 语句之前添加:
FirebaseApp.configure()
这个方法检查刚才安装的两个库，并使用你添加在 GoogleServices-info 中的常量来初始化。远程配置库现在知道要去 internet 上查找新值的正确位置。
Build & run，app 和之前一样，但你从控制台中会看到一些之前没有的调试信息。
恭喜你！你已经安装好了远程配置！现在你可以在接下来的教程中使用它了！
远程配置是如何工作的
非常简单，远程配置通过类似于在云端的 [String：Any] 字典来工作。当你的应用程序启动时，它会从云中抓取任何可能需要的新值，然后将它们应用到你可能指定为默认值的任何旧值之上。
使用远程配置的一般流程是：
- 为你有可能在将来改变的任何值提供远程配置的默认值。
- 从云端抓取新值。它们会以一种“缓存的持有模式”保存在您的设备上。
- “激活”抓取到的值。这时，会将获取的值应用到原有默认值之上。
- 查询远程配置。如果云端有值，远程配置会根据指定的 key 给你云端的值，否则会返回默认值。
有一点要注意，获取到的这些新值通常是你提供的默认值的子集。你可以将应用程序中几乎任何硬编码的字符串、数字或布尔值，打包在一起到远程配置。这让你能够在以后灵活地修改应用程序的许多地方，同时保持网络调用小而美。
理论课完了，来点实际的！
使用远程配置
首先，打开 Planet Tour 项目的 Utilities 文件夹，用右键新建文件。选择 Swift 文件，文件名就叫做 RCValues.swift，将它创建在 Xcode 推荐的默认目录下。
在文件中加入：
import Firebase
class RCValues {
static let sharedInstance = RCValues()
private init() {
loadDefaultValues()
}
func loadDefaultValues() {
let appDefaults: [String: Any?] = [
"appPrimaryColor" : "#FBB03B"
]
RemoteConfig.remoteConfig().setDefaults(appDefaults as? [String: NSObject])
}
}这里，使用了单例模式。在 loadDefaultValues() 中，传递给远程配置一对键值对，充当默认值。这里只提供了一个值，但别急，后面会添加更多值。
然后，请求远程配置从云端返回新值。在 loadDefaultValues() 方法下面添加方法：
func fetchCloudValues() {
// 1
// WARNING: Don't actually do this in production!
let fetchDuration: TimeInterval = 0
RemoteConfig.remoteConfig().fetch(withExpirationDuration: fetchDuration) { status, error in
if let error = error {
print("Uh-oh. Got an error fetching remote values \(error)")
return
}
// 2
RemoteConfig.remoteConfig().activateFetched()
print("Retrieved values from the cloud!")
}
}这里做了些什么？
默认情况下，远程配置将缓存从云中检索的任何值大约12小时。在一个生产应用中，这可能很好。但是，当你在进行开发或在线使用这篇 Firebase 远程配置教程时，这可能会让测试新值变得非常麻烦。所以，你要指定 fetchDuration 为 0，表示永远不使用缓存数据。
在 completion 闭包中，立即激活抓取到的值 —— 即告诉远程配置将新值替换掉旧值。
在 init() 方法中调用新方法：
fetchCloudValues()
一些问题
您在开始添加的代码会有一些问题。远程配置库对客户端流量有控制，确保你无法频繁地 ping 服务。将 fetchDuration 设为 0 会和这个控制发生冲突，你的库将停止抓取值。
可以打开开发者模式以解决这个问题。在 fetchCloudValues() 下面添加方法：
func activateDebugMode() {
if let debugSettings = RemoteConfigSettings(developerModeEnabled: true) {
RemoteConfig.remoteConfig().configSettings = debugSettings
}
}将开发者模式设置为 true，告诉远程配置忽略客户端流量控制。对于开发过程，或者在 10 人以下的测试团队来说，这是没问题的。但是，如果你把这款应用发布到公众面前，你会有数百万的粉丝，你很快就会引起服务器端的节流阀，远程配置会停止工作。这就是你首先要有一个客户端节流阀的原因。
在将 app 推到生产之前，确保禁用开发者模式，并将 fetchDuration 设置为更合理的时间，比如43200，即 12小时。
最后，在 fetchDuration 变量的声明语句之后添加：
activateDebugMode()
这将开启 debug 模式，避免发生服务端节流控制问题。
运行你的代码
打开 AppDelegate.swift,在application(_:didFinishLaunchingWithOptions:) 的 FirebaseApp.configure() 之下添加:
let _ = RCValues.sharedInstance
Build & run，你会看到控制台中输出：
Retrieved values from the cloud!
使用远程配置值
现在你下载了这些值，来将它们输出到控制台。打开 RCValues.swift。在 fetchCloudValues() 的 “Retrieved values from the cloud” 一行后面添加:
print("Our app's primary color is \(RemoteConfig.remoteConfig().configValue(forKey: "appPrimaryColor"))")
这句代码将打印 appPrimaryColor 的值。
Build & run。你会开到：
Our app's primary color is
这很好，但你想要一个字符串值。
远程配置将检索到的值当成 RemoteConfigValue 对象，你可以将其看作是包含底层数据的容器，后者在内部表示为 utf8 编码的字符串。你几乎不会直接使用这个对象。相反，你将调用 numberValue 或 boolValue 之类的辅助方法来检索你想要的实际值。
将刚才那句替换成：
let appPrimaryColorString = RemoteConfig.remoteConfig()
.configValue(forKey: "appPrimaryColor")
.stringValue ?? "undefined"
print("Our app's primary color is \(appPrimaryColorString)")Build & run。这次你会看到：
Our app's primary color is #FBB03B
这会更方便一点。远程配置提供了你之前指定的默认值。
在云端修改值
现在你能够从远程配置拿到正确的值了，尝试在云端提供新值吧。
打开 Firebase 控制台，点击顶部左边的 Remote Config (在 Grow 之下)。点击 Add your first parameter。在表单中，将 key 设为 appPrimaryColor ，而值则设置为市场部 Greg 最爱的新绿色 #36C278。
点击 Add Parameter, 然后点击 Publish Changes (两次) 去刷新修改。
Build & run 。
你在控制台中会看到：
Our app’s primary color is #36C278
成功了！你已经修改了云端的值！
修改 App 的外观
现在，来将新值和 app 关联起来。
首先，加一个枚举来保存 key 值。使用常量字符串作为 key 是一种灾难，或者你起码得花一下午的时间来寻找一个神秘的 bug，因为你输错了一个 key。通过使用enum，Xcode可以在编译时捕捉错误，而不是运行时。
打开 RCValues.swift 在类定义之上加入：
enum ValueKey: String {
case appPrimaryColor
}然后，修改 loadDefaultValues() 方法，使用枚举代替常量字符串：
let appDefaults: [String: Any?] = [
ValueKey.appPrimaryColor.rawValue : "#FBB03B"
]在 RCValue 中添加一个工具方法，它将一个 ValueKey 作为参数，然后根据这个字符串从远程配置返回一个 UIColor。
func color(forKey key: ValueKey) -> UIColor {
let colorAsHexString = RemoteConfig.remoteConfig()[key.rawValue].stringValue ?? "#FFFFFF"
let convertedColor = UIColor(colorAsHexString)
return convertedColor
}最后，将 app 中原来使用 AppConstants 常量的地方替换成 RCValues 的工具方法。
有 3 个地方需要改：
打开 ContainerViewController.swift 修改 updateBanner() 方法中的:
bannerView.backgroundColor = AppConstants.appPrimaryColor为：
bannerView.backgroundColor = RCValues.sharedInstance.color(forKey: .appPrimaryColor)打开 GetNewsletterViewController.swift 将 updateSubmitButton() 方法中的:
submitButton.backgroundColor = AppConstants.appPrimaryColor修改为：
submitButton.backgroundColor = RCValues.sharedInstance.color(forKey: .appPrimaryColor)打开 PlanetDetailViewController.swift 将 updateLabelColors() 方法中的:
nextLabel.textColor = AppConstants.appPrimaryColor修改为：
nextLabel.textColor = RCValues.sharedInstance.color(forKey: .appPrimaryColor)
为了完美，打开 AppConstants.swift and delete the following:
static let appPrimaryColor = UIColor(rgba: "#FBB03B")
再见了，硬编码…
Build& run。你会发现整个 app 变成绿色的了：
当这些新值被应用时，你不能做过多控制。当第一次运行 app 时，可能会看到主菜单是默认的橙色，但是当新值从云中加载后，你就会看到行星详情中显示的新绿色。
这可能会让用户感到困惑。在这个例子里，你只是修改了一些标签的颜色，但是如果你的 app 改变了能够影响到它的行为的文本或值怎么办呢？如果用户正在使用的过程中，他们会感到困惑。
有很多方法可以解决这个问题，但是最简单的方法是创建一个加载页面。在本教程中，它已经创建好了一部分。
添加加载页面
首先，让加载屏幕成为 app 的 inital View controller。打开 Main.storyboard。右键，从导航控制器拖一条线到 Waiting View Controller —— 它是一个黑背景的视图控制器，你也可以通过 outline 视图来操作，这样可能更容易。从弹出菜单中选择 root view controller：当你的应用加载时，这将使你的加载屏幕成为初始屏幕。
现在，为远程配置加载完成后时添加跳转到主菜单的逻辑。
打开 RCValues.swift, 在 sharedInstance 属性后添加:
var loadingDoneCallback: (() -> Void)?
var fetchComplete = false
接着，将 fetchCloudValues() 改成：
func fetchCloudValues() {
// WARNING: Don't actually do this in production!
let fetchDuration: TimeInterval = 0
activateDebugMode()
RemoteConfig.remoteConfig().fetch(withExpirationDuration: fetchDuration) { [weak self] status, error in
if let error = error {
print ("Uh-oh. Got an error fetching remote values \(error)")
return
}
RemoteConfig.remoteConfig().activateFetched()
print ("Retrieved values from the cloud!")
let appPrimaryColorString = RemoteConfig.remoteConfig()
.configValue(forKey: "appPrimaryColor")
.stringValue ?? "undefined"
print("Our app's primary color is \(appPrimaryColorString)")
self?.fetchComplete = true
self?.loadingDoneCallback?()
}
}这里，当请求完成后，将 fetchComplete 设置为 true。最后调用回调函数，通知监听者远程配置值加载完成。这可以用于通知加载屏幕解散自己。
打开 WaitingViewController.swift 添加方法：
func startAppForReal() {
performSegue(withIdentifier: "loadingDoneSegue", sender: self)
}将 viewDidLoad() 修改为:
override func viewDidLoad() {
super.viewDidLoad()
if RCValues.sharedInstance.fetchComplete {
startAppForReal()
}
RCValues.sharedInstance.loadingDoneCallback = startAppForReal
}当所有值加载完后，由 RCValue 调用 startAppForReal()。同时还增加了一个判断，防止 RCValue 网络调用有时会在等待屏加载之前完成。这应该不会发生，但这种预防措施无伤大雅。
Todd 编码原则：在代码注释中添加一句“这一点不应该发生”，这将使事情在将来的某个时候真的会发生。
Build & run。你会看到屏幕上出现一个短暂的等待,这取决于你的网速,再跳到其它界面。如果你改变 app 的主颜色值并重新启动应用程序,新颜色将在你的应用程序中正确显示。记得点击在 Firebase 控制台中点击 Publish Changes。
修改 App 的其它部分
你曾经将一个 AppConstants 常量修改成 RCValue，现在来修改其它常量！打开 RCValues.swift 将 ValueKey 修改为：
enum ValueKey: String {
case bigLabelColor
case appPrimaryColor
case navBarBackground
case navTintColor
case detailTitleColor
case detailInfoColor
case subscribeBannerText
case subscribeBannerButton
case subscribeVCText
case subscribeVCButton
case shouldWeIncludePluto
case experimentGroup
case planetImageScaleFactor
}然后，修改 loadDefaultValues():
func loadDefaultValues() {
let appDefaults: [String: Any?] = [
ValueKey.bigLabelColor.rawValue: "#FFFFFF66",
ValueKey.appPrimaryColor.rawValue: "#FBB03B",
ValueKey.navBarBackground.rawValue: "#535E66",
ValueKey.navTintColor.rawValue: "#FBB03B",
ValueKey.detailTitleColor.rawValue: "#FFFFFF",
ValueKey.detailInfoColor.rawValue: "#CCCCCC",
ValueKey.subscribeBannerText.rawValue: "Like Planet Tour?",
ValueKey.subscribeBannerButton.rawValue: "Get our newsletter!",
ValueKey.subscribeVCText.rawValue: "Want more astronomy facts? Sign up for our newsletter!",
ValueKey.subscribeVCButton.rawValue: "Subscribe",
ValueKey.shouldWeIncludePluto.rawValue: false,
ValueKey.experimentGroup.rawValue: "default",
ValueKey.planetImageScaleFactor.rawValue: 0.33
]
RemoteConfig.remoteConfig().setDefaults(appDefaults as? [String: NSObject])
}添加 3 个工具方法，以检索颜色之外的值：
func bool(forKey key: ValueKey) -> Bool {
return RemoteConfig.remoteConfig()[key.rawValue].boolValue
}
func string(forKey key: ValueKey) -> String {
return RemoteConfig.remoteConfig()[key.rawValue].stringValue ?? ""
}
func double(forKey key: ValueKey) -> Double {
if let numberValue = RemoteConfig.remoteConfig()[key.rawValue].numberValue {
return numberValue.doubleValue
} else {
return 0.0
}
}然后，将 app 中使用到 AppConstants 的每一部分都替换成对应的 RCValues 调用。。
整个 app 需要有 9 处修改：
打开 ContainerViewController.swift 修改 updateNavigationColors() 方法为:
func updateNavigationColors() { navigationController?.navigationBar.tintColor = RCValues.sharedInstance.color(forKey: .navTintColor) }修改 updateBanner() 方法:
func updateBanner() { bannerView.backgroundColor = RCValues.sharedInstance.color(forKey: .appPrimaryColor) bannerLabel.text = RCValues.sharedInstance.string(forKey: .subscribeBannerText) getNewsletterButton.setTitle(RCValues.sharedInstance.string(forKey: .subscribeBannerButton), for: .normal) }修改 GetNewsletterViewController.swift 的 updateText()方法:
func updateText() { instructionLabel.text = RCValues.sharedInstance.string(forKey: .subscribeVCText) submitButton.setTitle(RCValues.sharedInstance.string(forKey: .subscribeVCButton), for: .normal) }将 PlanetDetailViewController.swift 的 updateLabelColors() 方法的这句：
nextLabel.textColor = AppConstants.detailInfoColor修改为：
nextLabel.textColor = RCValues.sharedInstance.color(forKey: .detailInfoColor)将
planetNameLabel.textColor = AppConstants.detailTitleColor修改为
planetNameLabel.textColor = RCValues.sharedInstance.color(forKey: .detailTitleColor)将 PlanetsCollectionViewController.swift 中 customizeNavigationBar() 方法的这句:
navBar.barTintColor = AppConstants.navBarBackground修改为：
navBar.barTintColor = RCValues.sharedInstance.color(forKey: .navBarBackground)将 collectionView(_:cellForItemAt:) 的这句:
cell.nameLabel.textColor = AppConstants.bigLabelColor修改为：
cell.nameLabel.textColor = RCValues.sharedInstance.color(forKey: .bigLabelColor)
将 SolarSystem.swift 的 init() 的这句:
if AppConstants.shouldWeIncludePluto {修改为：
if RCValues.sharedInstance.bool(forKey: .shouldWeIncludePluto) {将 calculatePlanetScales()的这句:
scaleFactors[i] = pow(ratio, AppConstants.planetImageScaleFactor)修改为：
scaleFactors[i] = pow(ratio, RCValues.sharedInstance.double(forKey: .planetImageScaleFactor))
嘘，要改的地方太多了，但整个 app 都修改好了。如果你想确认一下，可以搜索 AppConstants —— 你只能搜到一个结果了，那就是结构体自己的定义：
如果想真正确认，删除 AppConstants 文件。app 仍然能通过编译，不会出现报错。
现在你的 app 已经完全封装成远程配置的了，除了将颜色修改为 Greg 非常喜欢的绿色之外，你可以做更多的改变。
修改其它方面
打开 Firebase 控制台。进入 Remote Config，点击 Add Parameter。设置 key 为 navBarBackground ，value 设置为 #35AEB1 ，然后点击 Add Parameter。同样，设置 navTintColor 为 #FFFFFF。点击 Publish Changes，将改变推到 app。
做完之后的控制台是这个样子：
发布修改，Build & run.
你的 app 是这样的：
请自己玩一下！修改其它值，随便改下文字。看看什么比较时髦……或者花哨……你可以想出什么样的颜色组合。
当你玩够以后，回到本教程，因为你还有一个严重问题需要处理。
把冥王星带回来
在丹麦，情况紧急！虽然世界上大多数人都认为冥王星不是行星,但北欧保护冥王星协会，一个由狂热的冥王星迷组成的组织，顽固地坚持冥王星作为一颗行星存在，并应当将它放到 Planet Tour App 中。在你阅读本文的同时，哥本哈根的街道上排满了抗议的人群！怎么办？
重新发布一个 App，则会激怒另一群人……
好吧，使用远程配置，这好像不是太难！你可以将 shouldWeIncludePluto 设为 true。等一下，这会改变所有用户的设置，而不仅仅是北欧！怎样才能基于不同的地区下发不同的设置？
答案是 Conditions!
远程配置比起简单的云端字典来说更加智能，那就是根据不同的人群发布不同的设置。你可以利用这个特性允许北欧用户重新接回它们的冥王星。
首先，打开 Firebase 控制台，在 Remote Config 面板中，点击 Add Parameter 添加一个新参数。
key 输入 shouldWeIncludePluto。
点击 value 栏旁边的 Add value for condition 下拉框。选择 Define New Condition。
如果你对 “Experiment with this parameter” 选项感到迷惑，你可以看一下我们的 A/B 测试教程，它刚好延展了这部分内容。
在对话框中，给新条件命名为 Pluto Fans。
在下拉框中，选择 Device Region / Country。
在国家列表中，选择 Denmark, Sweden, Norway, Iceland, 和 Finland。
点击 Create Condition。
然后，在 Value for Pluto Fans 栏，输入值 true。在 Default value 栏输入 false。
最后，点击 Add Parameter，再点击 Publish Changes。
运行程序，假设你没有在这些北半球国家，你仍然不能在行星列表中看见冥王星。如果你想体验一下北欧用户，我建议你买一张到哥本哈根的机票，买一部丹麦版的 iPhone,然后打开 App，顺便来一块熏鲑鱼单片三明治。
有一个更经济的做法（同时飞行时差反应也更少）是，打开设备后模拟器上的设置程序。选择 General > Language & Region > Region > Denmark (或其它北欧国家)：
这比飞到哥本哈根要便宜得多了，但同时也少了许多乐趣。
运行程序，这次你可以看见冥王星和别的行星列在一起。呼，避免了一起国际纠纷！
还有另一种不需要修改模拟器设置的方法，在 Xcode 中在 Run 按钮上 Option + 单击。在对话框中，单击 Options 面板，然后在 Application Region 菜单中选择一个合适的国家。
接下来去哪里
你可以用底部的 Download Material 连接下载最终项目。但是请注意，你仍然需要在 Firabase 控制台中创建项目，并将你的 GoogleServices-info.plist 文件拖到项目中。
有很多特性还没有来得及展示。通过将值下发给随机的用户组，你可以用远程配置来进行 A/B 测试，或者逐步将新功能推广到其他地区。你还可以将不同的数据集下发给通过 Firebase Analytics 识别出的某个用户组，实现某种定制化效果。如果你想进一步了解，请阅读这里以及下一篇教程。
通过远程配置能让你实现许多功能。如果你在开发游戏，如果玩家觉得难度过低或过高，用它来调整游戏玩法是一种好办法。还可以用它来实现“每日提醒”之类的功能。甚至可以用它来实验不同的按钮和标签文本，看看哪种能够让用户体验最好。在你的 App 中试试吧，看看你能改变些什么？
如果你有任何关于 Firebase 远程配置的问题或建议（或者有更好的 Planet Tour 配色方案），请在论坛中留言！
Download Materials