示例工程【免费下载链接】quickstart-androidFirebase Quickstart Samples for Android项目地址https://gitcode.com/gh_mirrors/qu/quickstart-android点击查看免费下载Firebase Remote Config 让你无需发布新版本就能在服务端动态修改 App 的用户可见文案与行为开关。本文以 quickstart-android 仓库中的config模块即 Remote Config quickstart 示例为骨架完整讲解其从接入、设置 in-app 默认值、拉取并激活参数到监听云端变更的全流程并结合 MainActivity.java 与 MainActivity.kt 的源码逐段拆解让你读完即可在自己的 Android 工程中落地同样的能力。示例项目概览config模块是 Firebase Quickstart Samples for Android 仓库项目主页中专门演示 Remote Config 的子工程。它只做一件小而聚焦的事用云端参数覆盖 App 内的默认文案。展示文案welcome_message欢迎语展示开关welcome_message_caps是否全大写加载占位文案loading_phrase拉取期间显示的提示项目采用 Java / Kotlin 双语实现由 EntryChoiceActivity.kt 作为入口让使用者自由选择运行 Java 或 Kotlin 版本的MainActivity。模块构建配置位于 config/app/build.gradle.kts通过 Firebase BoMfirebase-bom:34.18.0引入firebase-config并同时引入firebase-analytics——官方推荐同时集成 Analytics 以获得更优的 Remote Config 体验非强制。// config/app/build.gradle.kts 中的核心依赖 implementation(platform(com.google.firebase:firebase-bom:34.18.0)) implementation(com.google.firebase:firebase-config) implementation(com.google.firebase:firebase-analytics)快速开始五步跑通 Remote ConfigREADME 给出了一个非常直接的起步流程下面结合仓库实际代码说明每一步落点为 Android 工程添加 Firebase创建 Firebase 项目并下载google-services.json在app/build.gradle.kts中应用 Google Services 插件。为 quickstart 示例创建 Remote Config 工程在 Firebase 控制台按示例所用 key 定义参数即welcome_message、welcome_message_caps、loading_phrase。在 Android 设备或模拟器上运行示例使用仓库根目录的gradlew即可例如./gradlew :app:assembleDebug。在 Firebase 控制台修改参数值改welcome_message、welcome_message_caps中的任意一个或全部。点击 App 中的 Fetch Remote Config 按钮布局中对应 activity_main.xml 的fetchButton观察界面文案随之变化。最佳实践一用 XML 设置 in-app 默认值README 强调了一个核心最佳实践先设置 in-app 默认值再从控制台覆盖需要变更的参数。这样任何未来可能想覆盖的默认值都能直接走 Remote Config而无需把所有值都事先配置到控制台。示例采用 XML 文件方式定义默认值即 remote_config_defaults.xmldefaultsMap entry keyloading_phrase/key valueFetching config…/value /entry entry keywelcome_message_caps/key valuefalse/value /entry entry keywelcome_message/key valueWelcome to my awesome app!/value /entry /defaultsMap代码中通过FirebaseRemoteConfig的setDefaultsAsync(R.xml.remote_config_defaults)将其加载。Java 与 Kotlin 版本完全等价// Java加载 XML 默认值 mFirebaseRemoteConfig.setDefaultsAsync(R.xml.remote_config_defaults);// Kotlin加载 XML 默认值 remoteConfig.setDefaultsAsync(R.xml.remote_config_defaults)除了 XMLREADME 明确指出还可以用FirebaseRemoteConfig类提供的其他setDefault系列方法内联设置默认值两种方式可混合使用灵活适配不同工程风格。最佳实践二拉取与激活的时机控制Remote Config 的取值链路包含两个关键动作fetch从服务端拉取与activate激活使拉取到的值对 App 生效。README 用一段精确的规则说明了触发拉取的时机当 App 调用fetch时除非达到最小拉取间隔否则继续使用本地存储的参数值。最小拉取间隔由以下三者共同决定优先级从高到低传给fetch(long minFetchInterval)的参数Remote Config settings 中设置的最小拉取间隔系统默认的最小拉取间隔即 12 小时。fetchAndActivate拉取即激活fetchAndActivate会立即激活拉取到的值。它的返回值语义是如果调用前后 App 可用的最终 key/value 集合发生变化则返回 true否则返回 false。示例 App 中点击Fetch Remote Config按钮即触发fetchAndActivate// JavafetchAndActivate 带回调 mFirebaseRemoteConfig.fetchAndActivate() .addOnCompleteListener(this, new OnCompleteListenerBoolean() { Override public void onComplete(NonNull TaskBoolean task) { if (task.isSuccessful()) { boolean updated task.getResult(); Log.d(TAG, Config params updated: updated); Toast.makeText(MainActivity.this, Fetch and activate succeeded, Toast.LENGTH_SHORT).show(); } else { Toast.makeText(MainActivity.this, Fetch failed, Toast.LENGTH_SHORT).show(); } displayWelcomeMessage(); } });// KotlinfetchAndActivate 带回调 remoteConfig.fetchAndActivate() .addOnCompleteListener(this) { task - if (task.isSuccessful) { val updated task.result Log.d(TAG, Config params updated: $updated) Toast.makeText(this, Fetch and activate succeeded, Toast.LENGTH_SHORT).show() } else { Toast.makeText(this, Fetch failed, Toast.LENGTH_SHORT).show() } displayWelcomeMessage() }fetch activate分步控制生效时机若希望自己控制激活时机例如先拉取、暂不生效待用户进入特定页面再应用则使用fetch——拉取的值只做本地存储、不会立即激活之后调用activate方法才真正生效。README 明确给出了这一分离语义适合需要预拉取 延迟生效的场景。示例源码中还演示了配合ConfigUpdateListener的实时更新监听当云端welcome_message变更时自动activate并刷新界面详见 MainActivity.javaremoteConfig.addOnConfigUpdateListener(object : ConfigUpdateListener { override fun onUpdate(configUpdate: ConfigUpdate) { Log.d(TAG, Updated keys: configUpdate.updatedKeys) if (configUpdate.updatedKeys.contains(WELCOME_MESSAGE_KEY)) { remoteConfig.activate().addOnCompleteListener { displayWelcomeMessage() } } } override fun onError(error: FirebaseRemoteConfigException) { Log.w(TAG, Config update error with code: error.code, error) } })开发者模式与最小拉取间隔README 特别提醒可以创建 Remote Config Setting 以加快开发期间的拉取频率但发布前必须移除该设置。原因是正常情况下 Remote Config 服务端拉取被限制为每小时几次开启开发者模式后可大幅提升每小时请求数上限便于在开发期反复测试不同参数值。示例中通过 Builder 将最小拉取间隔设为 3600 秒1 小时同时起到开发调试与限流双重作用// Java设置最小拉取间隔秒 FirebaseRemoteConfigSettings configSettings new FirebaseRemoteConfigSettings.Builder() .setMinimumFetchIntervalInSeconds(3600) .build(); mFirebaseRemoteConfig.setConfigSettingsAsync(configSettings);// Kotlin设置最小拉取间隔秒 val configSettings remoteConfigSettings { minimumFetchIntervalInSeconds 3600 } remoteConfig.setConfigSettingsAsync(configSettings)这里同样遵循上述优先级规则若以fetch(long minFetchInterval)显式传入更小间隔则以传入值为准否则取 settings 中配置的值均未配置时回落到默认的 12 小时。读取参数并驱动 UI拉取并激活之后用类型化 API 读取参数值即可驱动界面。示例的displayWelcomeMessage()完整展示了getString/getBooleanKotlin 中对应asString()/asBoolean()的用法并用welcome_message_caps布尔值控制 TextView 是否全大写// Java读取并应用参数 String welcomeMessage mFirebaseRemoteConfig.getString(WELCOME_MESSAGE_KEY); if (mFirebaseRemoteConfig.getBoolean(WELCOME_MESSAGE_CAPS_KEY)) { mWelcomeTextView.setAllCaps(true); } else { mWelcomeTextView.setAllCaps(false); } mWelcomeTextView.setText(welcomeMessage);// Kotlin读取并应用参数 val welcomeMessage remoteConfig[WELCOME_MESSAGE_KEY].asString() binding.welcomeTextView.isAllCaps remoteConfig[WELCOME_MESSAGE_CAPS_KEY].asBoolean() binding.welcomeTextView.text welcomeMessagefetchWelcome()中还会先用loading_phrase占位文案填充界面避免拉取期间的空白闪烁。三个 key 在源码中统一定义为常量WELCOME_MESSAGE_KEY、WELCOME_MESSAGE_CAPS_KEY、LOADING_PHRASE_CONFIG_KEY与 XML 默认值及控制台参数名一一对应保证了控制台 key ↔ 代码 key ↔ XML key三处命名的一致性——这也是使用 Remote Config 时避免参数漂移的关键纪律。自动化验证仪器测试如何覆盖拉取流程仓库中的 MainActivityTest.java 用 Espresso 对核心交互做了端到端验证点击fetch remote welcome按钮fetch_remote_welcome_message随后断言成功 Toast以Fetch Succeeded开头出现在非主装饰视图的 Root 中从而证明点击拉取 → 回调成功 → 用户可见反馈这条链路是真实可测的。在 config/app/build.gradle.kts 中check任务还依赖了assembleDebugAndroidTest保证 CI 环境下仪器测试 APK 会被一并构建。小结围绕 quickstart-android 的config模块本文完整还原了 Remote Config 的落地链路XML 定义 in-app 默认值 → 控制台按需覆盖 → 按钮触发fetchAndActivate或fetchactivate分步控制→ 类型化 API 读取并刷新 UI → 监听器实现热更新。其中最小拉取间隔的三级优先级调用参数 settings 12 小时默认值与开发者模式发布前必须移除两条规则是实际生产中最容易踩坑、也最值得记住的细节。想继续深入可直接研读 MainActivity.java 与 remote_config_defaults.xml 源码或参考本仓库其他模块如 config 目录完整结构对照学习。赞分享示例工程【免费下载链接】quickstart-androidFirebase Quickstart Samples for Android项目地址https://gitcode.com/gh_mirrors/qu/quickstart-android点击查看免费下载相关推荐Android Sunflower A/B测试终极指南Firebase Remote Config快速配置教程Android Sunflower A/B测试终极指南Firebase Remote Config快速配置教程 Android Sunflower是一个展示A移动开发示例工程终极指南如何使用Android-PickerView打造高效选择器并通过Firebase Remote Config实现A/B测试终极指南如何使用Android PickerView打造高效选择器并通过Firebase Remote Config实现A/B测试 Android Picke移动开发UI组件Android-PickerView 与Firebase In-App Messaging向用户推送选择器更新Android PickerView 与Firebase In App Messaging向用户推送选择器更新 引言选择器更新的痛点与解决方案 在移动应用开移动开发UI组件创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Firebase Remote Config Android 快速上手：从 in-app 默认值到云端参数热更新（quickstart-android 实战解析）
示例工程【免费下载链接】quickstart-androidFirebase Quickstart Samples for Android项目地址https://gitcode.com/gh_mirrors/qu/quickstart-android点击查看免费下载Firebase Remote Config 让你无需发布新版本就能在服务端动态修改 App 的用户可见文案与行为开关。本文以 quickstart-android 仓库中的config模块即 Remote Config quickstart 示例为骨架完整讲解其从接入、设置 in-app 默认值、拉取并激活参数到监听云端变更的全流程并结合 MainActivity.java 与 MainActivity.kt 的源码逐段拆解让你读完即可在自己的 Android 工程中落地同样的能力。示例项目概览config模块是 Firebase Quickstart Samples for Android 仓库项目主页中专门演示 Remote Config 的子工程。它只做一件小而聚焦的事用云端参数覆盖 App 内的默认文案。展示文案welcome_message欢迎语展示开关welcome_message_caps是否全大写加载占位文案loading_phrase拉取期间显示的提示项目采用 Java / Kotlin 双语实现由 EntryChoiceActivity.kt 作为入口让使用者自由选择运行 Java 或 Kotlin 版本的MainActivity。模块构建配置位于 config/app/build.gradle.kts通过 Firebase BoMfirebase-bom:34.18.0引入firebase-config并同时引入firebase-analytics——官方推荐同时集成 Analytics 以获得更优的 Remote Config 体验非强制。// config/app/build.gradle.kts 中的核心依赖 implementation(platform(com.google.firebase:firebase-bom:34.18.0)) implementation(com.google.firebase:firebase-config) implementation(com.google.firebase:firebase-analytics)快速开始五步跑通 Remote ConfigREADME 给出了一个非常直接的起步流程下面结合仓库实际代码说明每一步落点为 Android 工程添加 Firebase创建 Firebase 项目并下载google-services.json在app/build.gradle.kts中应用 Google Services 插件。为 quickstart 示例创建 Remote Config 工程在 Firebase 控制台按示例所用 key 定义参数即welcome_message、welcome_message_caps、loading_phrase。在 Android 设备或模拟器上运行示例使用仓库根目录的gradlew即可例如./gradlew :app:assembleDebug。在 Firebase 控制台修改参数值改welcome_message、welcome_message_caps中的任意一个或全部。点击 App 中的 Fetch Remote Config 按钮布局中对应 activity_main.xml 的fetchButton观察界面文案随之变化。最佳实践一用 XML 设置 in-app 默认值README 强调了一个核心最佳实践先设置 in-app 默认值再从控制台覆盖需要变更的参数。这样任何未来可能想覆盖的默认值都能直接走 Remote Config而无需把所有值都事先配置到控制台。示例采用 XML 文件方式定义默认值即 remote_config_defaults.xmldefaultsMap entry keyloading_phrase/key valueFetching config…/value /entry entry keywelcome_message_caps/key valuefalse/value /entry entry keywelcome_message/key valueWelcome to my awesome app!/value /entry /defaultsMap代码中通过FirebaseRemoteConfig的setDefaultsAsync(R.xml.remote_config_defaults)将其加载。Java 与 Kotlin 版本完全等价// Java加载 XML 默认值 mFirebaseRemoteConfig.setDefaultsAsync(R.xml.remote_config_defaults);// Kotlin加载 XML 默认值 remoteConfig.setDefaultsAsync(R.xml.remote_config_defaults)除了 XMLREADME 明确指出还可以用FirebaseRemoteConfig类提供的其他setDefault系列方法内联设置默认值两种方式可混合使用灵活适配不同工程风格。最佳实践二拉取与激活的时机控制Remote Config 的取值链路包含两个关键动作fetch从服务端拉取与activate激活使拉取到的值对 App 生效。README 用一段精确的规则说明了触发拉取的时机当 App 调用fetch时除非达到最小拉取间隔否则继续使用本地存储的参数值。最小拉取间隔由以下三者共同决定优先级从高到低传给fetch(long minFetchInterval)的参数Remote Config settings 中设置的最小拉取间隔系统默认的最小拉取间隔即 12 小时。fetchAndActivate拉取即激活fetchAndActivate会立即激活拉取到的值。它的返回值语义是如果调用前后 App 可用的最终 key/value 集合发生变化则返回 true否则返回 false。示例 App 中点击Fetch Remote Config按钮即触发fetchAndActivate// JavafetchAndActivate 带回调 mFirebaseRemoteConfig.fetchAndActivate() .addOnCompleteListener(this, new OnCompleteListenerBoolean() { Override public void onComplete(NonNull TaskBoolean task) { if (task.isSuccessful()) { boolean updated task.getResult(); Log.d(TAG, Config params updated: updated); Toast.makeText(MainActivity.this, Fetch and activate succeeded, Toast.LENGTH_SHORT).show(); } else { Toast.makeText(MainActivity.this, Fetch failed, Toast.LENGTH_SHORT).show(); } displayWelcomeMessage(); } });// KotlinfetchAndActivate 带回调 remoteConfig.fetchAndActivate() .addOnCompleteListener(this) { task - if (task.isSuccessful) { val updated task.result Log.d(TAG, Config params updated: $updated) Toast.makeText(this, Fetch and activate succeeded, Toast.LENGTH_SHORT).show() } else { Toast.makeText(this, Fetch failed, Toast.LENGTH_SHORT).show() } displayWelcomeMessage() }fetch activate分步控制生效时机若希望自己控制激活时机例如先拉取、暂不生效待用户进入特定页面再应用则使用fetch——拉取的值只做本地存储、不会立即激活之后调用activate方法才真正生效。README 明确给出了这一分离语义适合需要预拉取 延迟生效的场景。示例源码中还演示了配合ConfigUpdateListener的实时更新监听当云端welcome_message变更时自动activate并刷新界面详见 MainActivity.javaremoteConfig.addOnConfigUpdateListener(object : ConfigUpdateListener { override fun onUpdate(configUpdate: ConfigUpdate) { Log.d(TAG, Updated keys: configUpdate.updatedKeys) if (configUpdate.updatedKeys.contains(WELCOME_MESSAGE_KEY)) { remoteConfig.activate().addOnCompleteListener { displayWelcomeMessage() } } } override fun onError(error: FirebaseRemoteConfigException) { Log.w(TAG, Config update error with code: error.code, error) } })开发者模式与最小拉取间隔README 特别提醒可以创建 Remote Config Setting 以加快开发期间的拉取频率但发布前必须移除该设置。原因是正常情况下 Remote Config 服务端拉取被限制为每小时几次开启开发者模式后可大幅提升每小时请求数上限便于在开发期反复测试不同参数值。示例中通过 Builder 将最小拉取间隔设为 3600 秒1 小时同时起到开发调试与限流双重作用// Java设置最小拉取间隔秒 FirebaseRemoteConfigSettings configSettings new FirebaseRemoteConfigSettings.Builder() .setMinimumFetchIntervalInSeconds(3600) .build(); mFirebaseRemoteConfig.setConfigSettingsAsync(configSettings);// Kotlin设置最小拉取间隔秒 val configSettings remoteConfigSettings { minimumFetchIntervalInSeconds 3600 } remoteConfig.setConfigSettingsAsync(configSettings)这里同样遵循上述优先级规则若以fetch(long minFetchInterval)显式传入更小间隔则以传入值为准否则取 settings 中配置的值均未配置时回落到默认的 12 小时。读取参数并驱动 UI拉取并激活之后用类型化 API 读取参数值即可驱动界面。示例的displayWelcomeMessage()完整展示了getString/getBooleanKotlin 中对应asString()/asBoolean()的用法并用welcome_message_caps布尔值控制 TextView 是否全大写// Java读取并应用参数 String welcomeMessage mFirebaseRemoteConfig.getString(WELCOME_MESSAGE_KEY); if (mFirebaseRemoteConfig.getBoolean(WELCOME_MESSAGE_CAPS_KEY)) { mWelcomeTextView.setAllCaps(true); } else { mWelcomeTextView.setAllCaps(false); } mWelcomeTextView.setText(welcomeMessage);// Kotlin读取并应用参数 val welcomeMessage remoteConfig[WELCOME_MESSAGE_KEY].asString() binding.welcomeTextView.isAllCaps remoteConfig[WELCOME_MESSAGE_CAPS_KEY].asBoolean() binding.welcomeTextView.text welcomeMessagefetchWelcome()中还会先用loading_phrase占位文案填充界面避免拉取期间的空白闪烁。三个 key 在源码中统一定义为常量WELCOME_MESSAGE_KEY、WELCOME_MESSAGE_CAPS_KEY、LOADING_PHRASE_CONFIG_KEY与 XML 默认值及控制台参数名一一对应保证了控制台 key ↔ 代码 key ↔ XML key三处命名的一致性——这也是使用 Remote Config 时避免参数漂移的关键纪律。自动化验证仪器测试如何覆盖拉取流程仓库中的 MainActivityTest.java 用 Espresso 对核心交互做了端到端验证点击fetch remote welcome按钮fetch_remote_welcome_message随后断言成功 Toast以Fetch Succeeded开头出现在非主装饰视图的 Root 中从而证明点击拉取 → 回调成功 → 用户可见反馈这条链路是真实可测的。在 config/app/build.gradle.kts 中check任务还依赖了assembleDebugAndroidTest保证 CI 环境下仪器测试 APK 会被一并构建。小结围绕 quickstart-android 的config模块本文完整还原了 Remote Config 的落地链路XML 定义 in-app 默认值 → 控制台按需覆盖 → 按钮触发fetchAndActivate或fetchactivate分步控制→ 类型化 API 读取并刷新 UI → 监听器实现热更新。其中最小拉取间隔的三级优先级调用参数 settings 12 小时默认值与开发者模式发布前必须移除两条规则是实际生产中最容易踩坑、也最值得记住的细节。想继续深入可直接研读 MainActivity.java 与 remote_config_defaults.xml 源码或参考本仓库其他模块如 config 目录完整结构对照学习。赞分享示例工程【免费下载链接】quickstart-androidFirebase Quickstart Samples for Android项目地址https://gitcode.com/gh_mirrors/qu/quickstart-android点击查看免费下载相关推荐Android Sunflower A/B测试终极指南Firebase Remote Config快速配置教程Android Sunflower A/B测试终极指南Firebase Remote Config快速配置教程 Android Sunflower是一个展示A移动开发示例工程终极指南如何使用Android-PickerView打造高效选择器并通过Firebase Remote Config实现A/B测试终极指南如何使用Android PickerView打造高效选择器并通过Firebase Remote Config实现A/B测试 Android Picke移动开发UI组件Android-PickerView 与Firebase In-App Messaging向用户推送选择器更新Android PickerView 与Firebase In App Messaging向用户推送选择器更新 引言选择器更新的痛点与解决方案 在移动应用开移动开发UI组件创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考