Vai alla console

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

现在,示例将创建一个 fetchAndActivateWithCompletionHandler: 请求,以从远程配置后端提取值并使其对应用可用:

Swift

Objective-C

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

Swift

Objective-C

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

限制

如果应用在短时间内提取次数太多,提取调用可能会受到限制。在这种情况下,后端会返回 FIRRemoteConfigFetchStatusThrottled。我们建议您捕获此错误,并在指数退避模式下重试,同时在后续提取请求之间等待更长时间间隔。

在应用开发期间,您不妨非常频繁地(每小时多次)刷新缓存,这样可以在开发和测试应用的同时快速迭代。为了让最多 10 名开发者对项目进行快速迭代,您可以暂时在应用中添加具有较短的最小提取间隔 (MinimumFetchInterval) 的 FIRRemoteConfigSettings 属性。

远程配置的默认最小提取间隔为 12 小时,这意味着在 12 小时的时间段内最多从后端提取一次配置,无论实际进行了多少次提取调用都是如此。具体而言,按以下顺序确定最小提取间隔:

  1. fetch(long) 中的参数
  2. 以下属性中的参数:FIRRemoteConfigSettings.MinimumFetchInterval
  3. 默认值 12 小时