Firebase 远程配置 iOS 示例应用演示

本指南将逐步介绍如何将远程配置功能集成到您的 iOS 应用。要详细了解适用于 iOS 的 Remote Config API,请参阅 FIRRemoteConfig

要求

请按将 Firebase 添加到您的 iOS 项目中的说明操作,设置您的项目。

安装客户端库

  1. 向您的 Podfile 中添加以下依赖项:

    pod 'Firebase/RemoteConfig'
    

  2. 保存文件并运行以下命令:

    pod install
    

这会为您的应用创建一个 .xcworkspace 文件。在以后开发您的应用时都要使用此文件。

创建用于快速入门示例的远程配置项目

快速入门示例展示了如何使用远程配置功能来定义示例应用的欢迎消息。运行快速入门示例之前,应当先设置远程配置项目。

Firebase 控制台中,点击新建项目,然后按照说明设置 Firebase 远程配置项目,使其参数如下:

参数键 默认值 备注:
welcome_message Welcome to this sample app 可改用其他欢迎消息。
welcome_message_caps false 若设为 true,显示的欢迎消息全部为大写。

配置项目后,运行快速入门示例,查看您在 Firebase 控制台中定义的欢迎消息。您可以在项目中更改这些参数的值,然后在快速入门示例中点按提取远程配置 (Fetch Remote Config) 按钮,了解如何通过远程配置更新应用。

构建并运行快速入门示例

  1. 下载并解压缩快速入门示例代码

  2. 打开终端窗口,然后转到示例项目所在的位置。 运行 pod install,然后打开 .xcworkspace 文件。

  3. 构建并运行快速入门示例。

运作方式

首先,快速入门示例会获取远程配置对象实例,并启用开发者模式,以便可以频繁刷新缓存:

Swift

Objective-C

然后,快速入门示例会通过 plist 文件设置应用内默认值:

Swift

Objective-C

此时,快速入门示例会创建一个 fetchWithExpirationDuration:completionHandler: 请求,以从远程配置服务提取值,然后调用 activateFetched,以便您的应用可以使用这些值:

Swift

Objective-C

至此,欢迎消息已更新,您可以在应用中显示更新后的欢迎消息了:

Swift

Objective-C

您可以使用 stringValuenumberValuedataValueboolValue 中的某个属性,也可使用 configValueForKey: 方法来访问远程配置参数。

缓存和限制

首次成功提取值后,远程配置功能会在本地缓存值。 默认情况下,缓存在 12 小时后失效。不过,您可以将所需的缓存失效时间(以秒为单位)传递给 fetchWithExpirationDuration:completionHandler: 方法,更改特定请求操作的缓存失效时间。如果缓存中的值超过相应的缓存失效时间,远程配置功能会发出从服务刷新配置值的请求。如果您的应用多次使用 fetchWithExpirationDuration:completionHandler: 请求刷新值,请求会遭到阻止,并向您的应用提供缓存的值。

在应用开发期间,您不妨非常频繁地(每小时多次)刷新缓存,这样可以在开发和测试应用的同时快速迭代。为了让最多 10 名开发者对项目进行快速迭代,您可以暂时向应用添加将 isDeveloperModeEnabled 设为 trueFIRRemoteConfigSettings 属性,从而更改 FIRRemoteConfig 对象的缓存设置。

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面