firebase-remote-config-basics

远程配置

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

先决条件

配置远程配置需要 Firebase 项目和 Firebase 应用，应用可以是 Android 或 iOS。若要通过命令行管理远程配置模板和条件，请使用 Firebase CLI。有关项目初始化的参考信息，请参阅 firebase-basics 技能。

执行故障排除

处理 npx 403 Forbidden 错误

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

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

处理项目上下文问题

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

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

SDK 设置

若要了解如何在应用代码中设置远程配置，请选择您的平台：

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

最佳实践和模板管理

请遵循以下指南并使用相应的 CLI 工具，确保高效、安全地使用远程配置。

获取策略

为优化应用性能和用户体验，请遵循以下建议模式（参见 加载策略）：

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

通过 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 文件进行版本控制、获取和部署。