Catch up on everthing we announced at this year's Firebase Summit. Learn more

Firebase Remote Config 使用入门

您可以使用 Firebase Remote Config 来定义应用中的参数并在云端更新它们的值。这样,您无需更新应用即可修改应用的外观和行为。

Remote Config 库用于存储应用内默认参数值,从 Remote Config 后端中提取更新后的参数值,以及控制提取的值何时可供应用使用。如需了解详情,请参阅 Remote Config 加载策略

将 Firebase 添加至您的应用

您需要先完成以下步骤,然后才能使用 Remote Config

  • 注册 C++ 项目并将其配置为使用 Firebase。

    如果您的 C++ 项目已在使用 Firebase,那么您就已注册该 C++ 项目并已将其配置为使用 Firebase。

  • Firebase C++ SDK 添加到您的 C++ 项目。

请注意,将 Firebase 添加到 C++ 项目需要在 Firebase 控制台中和打开的 C++ 项目中执行若干任务(例如,从控制台下载 Firebase 配置文件,然后将配置文件移动到 C++ 项目中)。

将 Remote Config 添加至您的应用

Android

将 Firebase 添加到您的应用后:

  1. 创建一个 Firebase 应用,并将 JNI 环境和 Activity 作为参数传入:

    app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);

  2. 初始化 Remote Config 库,代码如下:

    ::firebase::remote_config::Initialize(app);

iOS+

将 Firebase 添加到您的应用后:

  1. 创建一个 Firebase 应用:

    app = ::firebase::App::Create(::firebase::AppOptions());

  2. 初始化 Remote Config 库,代码如下:

    ::firebase::remote_config::Initialize(app);

设置应用内默认参数值

您可以在 Remote Config 对象中设置应用内默认参数值,以便应用在连接到 Remote Config 后端之前能够按预期运行,并且在后端中尚未设置任何值时可以使用默认值。

  1. 使用 std::map<const char*, const char*> 对象或 std::map<const char*, firebase::Variant> 对象定义一组参数名称和默认参数值。
  2. 使用 SetDefaults() 将这些值添加到 Remote Config 对象。

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

现在,您可以从 Remote Config 对象中获取参数值。如果您已在 Remote Config 后端中设置值,然后提取并激活它们,这些值便可供您的应用使用。否则,您将获得使用 SetDefaults() 配置的应用内参数值。

如需获取这些值,请调用下列与应用所需数据类型对应的方法,并传入参数键作为调用的实参:

在 Firebase 控制台中关联您的应用

Firebase 控制台中,将您的应用添加到 Firebase 项目中。

设置参数值

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

提取并激活值

  1. 如需从 Remote Config 后端提取参数值,请调用 Fetch() 方法。系统将提取您在后端中设置的所有值,并缓存在 Remote Config 对象中。
  2. 如需将提取的参数值提供给您的应用,请调用 ActivateFetched()

后续步骤

浏览 Remote Config 使用场景并查看一些关键的概念和高级策略文档(如果您尚未这样做),包括: