firebase-remote-config-basics

Remote Config

此技能提供了在 Android 或 iOS 上开始使用 Remote Config 的完整指南。Remote Config 允许您通过维护基于云的配置模板，在不发布应用更新的情况下更改应用的行为和外观。

前提条件

配置 Remote Config 需要 Firebase 项目和 Firebase 应用（Android 或 iOS）。要通过命令行管理 Remote Config 模板和条件，请使用 Firebase CLI。有关项目初始化的参考，请参阅 firebase-basics 技能。

执行故障排除

处理 npx 403 禁止错误

如果 npx -y firebase-tools@latest 因注册表权限（403 错误）而失败：

1. 告知用户：“由于注册表错误，我无法通过 npx 获取最新的 Firebase 工具。”
2. 回退方案：如果用户确认已全局安装 Firebase CLI（npm install -g firebase-tools），则尝试直接使用本地 firebase 命令。

处理项目上下文问题

如果命令因“未选择活动项目”而失败：

1. 检查登录状态：运行 npx -y firebase-tools@latest login:list。
2. 提示输入项目 ID：如果已登录但没有活动项目，请询问用户：“请提供您的 Firebase 项目 ID 以继续。”
3. 使用标志：在每个后续命令后附加 --project <PROJECT_ID>。

SDK 设置

要了解如何在应用程序代码中设置 Remote Config，请选择您的平台：

• Android：android_setup.md
• iOS：ios_setup.md

最佳实践和模板管理

遵循以下指南并使用相关的 CLI 工具，以确保高效安全地使用 Remote Config。

获取策略

为了优化应用性能和用户体验，请遵循以下推荐模式（请参阅加载策略）：

• 为下次启动加载新值：最有效的模式是在启动时立即激活之前获取的值，并在后台获取新值供下次使用。这最大限度地减少了用户等待时间。
• 实时更新：使用 SDK 的实时监听器，在服务器端配置更改时立即更新应用，无需刷新。

通过 CLI 管理模板

使用以下命令通过终端管理 Remote Config 模板和版本历史：

通过 CLI 管理模板

使用以下命令通过终端管理 Remote Config 模板和版本历史：

• 获取当前模板：将远程模板保存到本地 JSON 文件，用于审计或修改。

  npx -y firebase-tools@latest remoteconfig:get -o remote_config.json
  

• 自主编辑与发现：直接修改本地的 remote_config.json。确定正确的信号（例如 device.country 或 percent），并相应更新“conditions”数组和“parameters”映射。

• 强制要求：用户审查与验证：在继续部署之前，请停下来让用户验证您的更改。

  • 操作：告知用户：“我已准备好对 remote_config.json 的更改。请检查文件的准确性。确认无误后，请告诉我‘deploy’以使更改生效。”

• 部署编排：要推送更改，您必须确保环境已配置为部署。

  • 配置映射：如果缺少 firebase.json 文件，请创建一个以将本地 JSON 映射到 Remote Config 服务：

    { "remoteconfig": { "template": "remote_config.json" } }
  

  • 部署：执行部分部署命令

    npx -y firebase-tools@latest deploy --only remoteconfig
    

• 验证：部署后，通过列出版本历史来验证更新。

  npx -y firebase-tools@latest remoteconfig:versions:list
  

SDK 提供了许多功能，使您的应用程序能够动态响应用户细分。

• 设置应用内默认值：定义基线值，确保应用在离线或首次获取之前正常运行。
• 获取并激活：从 Firebase 后端检索值并将其应用于本地 UI/逻辑。
• 模板管理：使用 Firebase CLI 对配置 JSON 文件进行版本控制、获取和部署。