云端配置拉取
晓葆 SDK 支持从云端动态下发配置,运营人员可在控制台实时修改功能开关、 主题、导航菜单等,无需客户端发版即可生效。
云端配置详细文档正在完善中。以下为功能概览,完整参数说明即将更新。
云端配置概述
SDK 初始化时自动拉取最新云端配置,并将版本号缓存到本地。 后续启动时若版本号未变,直接使用缓存;若有更新,自动下载并应用。
配置类型
| 配置类型 | 说明 | 控制台路径 |
|---|---|---|
| 应用基础信息 | App 名称、Logo、客服链接 | 配置管理 → 基础信息 |
| 功能开关 | 各功能模块的启用/禁用 | 配置管理 → 功能开关 |
| UI 配置 | 主题色、导航菜单、Banner | 配置管理 → UI 配置 |
| 业务参数 | 预约提前分钟数、搜索半径等 | 配置管理 → 业务参数 |
拉取时机
- SDK 初始化:必定触发一次拉取
- App 从后台切到前台:若距上次拉取超过 30 分钟,自动触发
- 主动调用:调用
XiaobaoSDK.refreshConfig()强制刷新
监听配置更新
// Android
XiaobaoSDK.addConfigListener { config ->
// config 为最新配置快照,在主线程回调
Log.d("SDK", "configVersion: ${config.version}")
}
// iOS
XiaobaoSDK.addConfigListener { config in
print("configVersion: \(config.version)")
}离线模式
首次安装时,SDK 内置一份出厂默认配置确保离线可用。 网络恢复后自动拉取最新配置并覆盖本地缓存。 本地缓存有效期为 7 天,超期后即使离线仍使用缓存,直到网络可用时刷新。