用 Firebase Remote Config…

当需要通过云端配置模板在不发版的情况下改变 App 行为与外观时，用 Firebase Remote Config 管理模板、条件、功能开关与加载策略。

适用场景

解决思路

1. 处理 npx 403 Forbidden 错误：若 `npx -y firebase-tools@latest` 因 registry 权限失败，先告知用户无法通过 npx 获取最新 Firebase 工具，然后在用户确认已全局安装（`npm install -g firebase-tools`）的情况下回退使用本地 `firebase` 命令。
2. 处理项目上下文问题：若命令因“no active project is selected”失败，先运行 `npx -y firebase-tools@latest login:list` 检查登录状态；若已登录但无活动项目，向用户询问 Firebase Project ID；之后在所有后续命令中追加 `--project <PROJECT_ID>`。
3. SDK 设置：按平台选择参考文档，Android 见 references/android_setup.md，iOS 见 references/ios_setup.md。
4. 加载策略——下次启动加载新值：启动时立即激活此前已获取的值，并在后台获取新值供下次使用，以最小化用户等待时间。
5. 加载策略——实时更新：使用 SDK 的实时监听器，在服务端配置变化时无需刷新即可即时更新 App。
6. 获取当前模板：运行 `npx -y firebase-tools@latest remoteconfig:get -o remote_config.json`，将远程模板保存为本地 JSON 文件以便审计或修改。
7. 自主编辑与发现：直接修改本地 `remote_config.json`，确定正确的信号（如 device.country 或 percent），并相应更新 "conditions" 数组和 "parameters" 映射。
8. 强制用户审查与验证：在部署前必须停下并请用户验证改动，告知用户“我已在 remote_config.json 中准备好改动，请审查文件准确性，确认后告诉我 ‘deploy’ 以使改动生效”。
9. 部署编排——配置映射：若缺少 firebase.json 文件，创建一个将本地 JSON 映射到 Remote Config 服务，内容为 `{ "remoteconfig": { "template": "remote_config.json" } }`。
10. 部署编排——部署：执行部分部署命令 `npx -y firebase-tools@latest deploy --only remoteconfig`。
11. 验证：部署后通过列出历史版本验证更新，运行 `npx -y firebase-tools@latest remoteconfig:versions:list`。
12. 设置应用内默认值：定义基线值，确保 App 在离线或首次获取前也能正常工作。
13. 获取并激活（Fetch and Activate）：从 Firebase 后端获取值并将其应用到本地 UI/逻辑。
14. 模板管理：使用 Firebase CLI 对配置 JSON 文件进行版本控制、获取和部署。

适用边界 · 注意事项

• 不要用于 Firebase Hosting、Auth、Firestore、Data Connect、Crashlytics 或 App Hosting。
• 需要先具备 Firebase 项目和 Android 或 iOS 的 Firebase App 才能配置 Remote Config。