主题配置
晓葆终端 SDK 支持完整的品牌主题定制,包括主色调、字体、圆角风格等, 让嵌入的健康模块与你的 App 风格保持一致。
主题文档正在完善中。当前版本支持以下配置项,详细参数说明即将更新。
主题系统概述
SDK 的 UI 组件从主题系统读取样式参数,支持以下三种配置方式(优先级从高到低):
- 代码初始化时传入 — 全局生效,适合整体品牌色配置
- 云端配置下发 — 运营可在控制台实时调整,无需发版
- SDK 内置默认值 — 晓葆标准蓝绿色调
颜色配置
// Android - Kotlin
XiaobaoSDK.setTheme(
XiaobaoTheme(
primaryColor = "#2DD4BF", // 主色(按钮、高亮)
secondaryColor = "#0EA5E9", // 辅色(链接、次要按钮)
backgroundColor = "#F8FAFC", // 页面背景色
errorColor = "#EF4444" // 错误/警告色
)
)// iOS - Swift
XiaobaoSDK.setTheme(XiaobaoTheme(
primaryColor: UIColor(hex: "#2DD4BF"),
secondaryColor: UIColor(hex: "#0EA5E9"),
backgroundColor: UIColor(hex: "#F8FAFC"),
errorColor: UIColor(hex: "#EF4444")
))字体配置
// 使用系统默认字体(推荐,随系统语言自动适配)
XiaobaoSDK.setTheme(
XiaobaoTheme(
fontFamily = null, // null = 使用系统默认
baseFontSize = 14 // 基础字号(pt/sp),默认 14
)
)组件样式
| 配置项 | 默认值 | 说明 |
|---|---|---|
buttonRadius | 8dp/pt | 按钮圆角 |
cardRadius | 12dp/pt | 卡片圆角 |
iconStyle | outlined | 图标风格:outlined / filled |
应用主题
主题配置可在 SDK 初始化时一并传入,也可在运行时动态更新:
// 运行时更新主题(立即生效,无需重启)
XiaobaoSDK.updateTheme(newTheme)