主题配置

晓葆终端 SDK 支持完整的品牌主题定制,包括主色调、字体、圆角风格等, 让嵌入的健康模块与你的 App 风格保持一致。

主题文档正在完善中。当前版本支持以下配置项,详细参数说明即将更新。

主题系统概述

SDK 的 UI 组件从主题系统读取样式参数,支持以下三种配置方式(优先级从高到低):

  1. 代码初始化时传入 — 全局生效,适合整体品牌色配置
  2. 云端配置下发 — 运营可在控制台实时调整,无需发版
  3. 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
    )
)

组件样式

配置项默认值说明
buttonRadius8dp/pt按钮圆角
cardRadius12dp/pt卡片圆角
iconStyleoutlined图标风格:outlined / filled

应用主题

主题配置可在 SDK 初始化时一并传入,也可在运行时动态更新:

// 运行时更新主题(立即生效,无需重启)
XiaobaoSDK.updateTheme(newTheme)