云端配置拉取

晓葆 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 天,超期后即使离线仍使用缓存,直到网络可用时刷新。