在 Android 上使用 Firebase 远程配置

您可以使用 Firebase 远程配置来定义应用中的参数并在云端更新它们的值。这样,您无需更新应用即可修改应用的外观和行为。本指南介绍了如何在您的应用中使用远程配置,步骤如下:

  1. 将 Firebase 添加至您的应用。
  2. 获取远程配置单例对象。
  3. 设置应用内默认参数值。
  4. 获取要在应用中使用的参数值。
  5. 在远程配置服务中设置参数值(若需要)。
  6. 从远程配置服务提取和激活值(若需要)。

将 Firebase 添加至您的应用

安装 Firebase SDK,在此步骤中务必要将远程配置依赖项添加至您的应用级 build.gradle 文件:

compile 'com.google.firebase:firebase-config:15.0.0'

获取远程配置单例对象

使用 FirebaseRemoteConfig.getInstance() 方法获取单例远程配置对象,如远程配置快速入门示例应用中所示。

此单例对象用于存储应用内默认参数值,从服务中提取更新后的参数值,以及控制提取的值何时可用于您的应用。如需了解更多信息,请参阅 Firebase Remote Config API 概览

设置应用内默认参数值

您可以在远程配置对象中设置应用内默认参数值,使得您的应用在从远程配置服务提取值之前可以按预期工作:

  1. 使用 Map 对象或存储在您应用的 res/xml 文件夹中的 XML 资源文件定义一组参数名称和默认参数值。远程配置快速入门示例应用使用 XML 文件定义默认参数名和参数值。
  2. 远程配置快速入门示例应用中所示,使用 setDefaults() 将这些值添加至远程配置对象。

获取要在应用中使用的参数值

现在,您可以从远程配置对象中获取参数值。如果您在远程配置服务中设置值、提取并激活它们,这些值便可供您的应用使用。否则,您需要使用 setDefaults() 来获取配置的应用内参数值。要获取这些值,请调用下列与应用所需数据类型对应的方法,并以参数形式提供参数键:

在服务中设置参数值(若需要)

  1. Firebase 控制台中,打开您的项目。
  2. 从菜单中选择远程配置以查看远程配置信息中心。
  3. 使用您在应用中定义的参数名称定义参数。对于每个参数,您可以设置一个默认值(最终将覆盖应用内的相应默认值),也可以设置条件值。如需了解详情,请参阅远程配置参数和条件

从服务提取和激活值(若需要)

  1. 要从远程配置服务提取参数值,请调用 Fetch() 方法。系统将提取您在远程配置服务中设置的所有值,并缓存在远程配置对象中。
  2. 要让提取的参数值可供您的应用使用,请调用 ActivateFetched() 方法。

由于这些更新后的参数值会影响应用的行为和外观,因此您应该注意选择激活已提取的值的时机,例如在用户下次打开您的应用时激活,以确保为用户提供流畅的体验。

后续步骤

有关远程配置快速入门示例应用的详情,请参阅 Firebase 远程配置 Android 示例应用演示

如需详细了解如何在应用中使用远程配置,请参阅“远程配置常见问题解答”中有关提取和激活参数值开发者模式和节流以及提取时机的内容。

发送以下问题的反馈:

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