SDK 定制

本页介绍如何通过更改字体、按钮和颜色样式来修改 Yuno iOS SDK 中的样式。要自定义 iOS SDK 的外观,请设置外观字段。此解决方案可让您调整 SDK 的视觉元素,使其与您的应用程序品牌相匹配,从而提高一致性和用户体验。

外观配置

下表列出了可用于自定义 iOS SDK 的所有可用字段:

现场说明
fontFamily指定 SDK 中使用的字体系列。提供应用程序中使用的字体文件名,确保与应用程序的资产相匹配。
accentColor定义多个 SDK 元素中使用的强调色。
buttonBackgroundColor设置主按钮的背景颜色。
buttonTitleColor确定主按钮的文字颜色。
buttonBorderColor指定主按钮的边框颜色。
secondaryButtonBackgroundColor设置辅助按钮的背景颜色。
secondaryButtonTitleColor确定辅助按钮的文字颜色。
secondaryButtonBorderColor指定辅助按钮的边框颜色。
disableButtonBackgroundColor设置禁用按钮的背景颜色。
disableButtonTitleColor确定禁用按钮的文本颜色。
📘

颜色配置

确保所有颜色都指定为 UIColor,以保持兼容性。颜色可以来自 Xcode 的预定义调色板或商家的资产,但必须始终是 UIColor 类型。

使用 Yuno.Appearance() 函数来定义一个变量,其中包含控制外观的所有自定义设置。然后在初始化 SDK 时通知它:

let appearance =Yuno.Appearance(
    fontFamily:"Climate Crisis"、
    accentColor: UIColor.orange、 
    buttonBackgroundColor: UIColor.yellow、 
    buttonTitleColor: UIColor.black、 
    按钮边框颜色:UIColor.black、
    secondaryButtonBackgroundColor: UIColor.yellow、
    secondaryButtonTitleColor: UIColor.black、
    secondaryButtonBorderColor: UIColor.black、
    disableButtonBackgroundColor: UIColor.gray、
    disableButtonTitleColor: UIColor.black
)

Yunoinitialize(
    apiKey: apiKey、
    config:YunoConfig(appearance: appearance)
)

使用示例

下面的示例展示了 iOS SDK 的两种外观定制:

let appearance =Yuno.Appearance(
    fontFamily:"Climate Crisis"、
    accentColor: UIColor.black、 
    buttonBackgroundColor: UIColor.black、 
    按钮标题颜色:UIColor.white
)

Yunoinitialize(
    apiKey: apiKey、
    config:YunoConfig(appearance: appearance)
)
let appearance =Yuno.Appearance(
    fontFamily:"Climate Crisis"、
    accentColor: UIColor.orange、 
    buttonBackgroundColor: UIColor.orange、 
    按钮标题颜色:UIColor.白色
)

Yunoinitialize(
    apiKey: apiKey、
    config:YunoConfig(appearance: appearance)
)

地址自动补全

商家可在iOS SDK中启用或禁用地址自动完成功能。启用时,SDK将根据邮政编码查询自动填充地址字段;禁用时,用户需手动输入全部地址信息。