Remote Config

此技能提供在 Android 或 iOS 上入门 Remote Config 的完整指南。Remote Config 允许你通过维护云端配置模板来更改应用的行为和外观，而无需发布应用更新。

前提条件

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

故障排查执行

处理 npx 403 Forbidden 错误

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

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

处理项目上下文问题

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

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

SDK 设置

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

• Android：[android_setup.md](references/android_setup.md)
• iOS：[ios_setup.md](references/ios_setup.md)

最佳实践与模板管理

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

获取策略

为优化应用性能和用户体验，请遵循这些推荐模式（参见 加载策略）：

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

通过 CLI 管理模板

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

通过 CLI 管理模板

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

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

``bash 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 服务：

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

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

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

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

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

该 SDK 提供多项功能，使你的应用能够动态响应用户细分。

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