Skip to content
GearUI Kit

GearUI Kit

基于 Kuikly 的 Kotlin Multiplatform UI 组件库。在 commonMain 里把一个页面写一遍;Android 与 iOS 上以原生渲染,Web 上以 DOM 渲染。

Maven CentralLicenseGitHub

一览 ​

kotlin
commonMain.dependencies {
    implementation("com.gearui:gearui-kit:1.0.0-beta6")
}
  • 71 个组件,分 6 类——每一个在 sample 里都有演示页
  • 有牙齿的设计 token——颜色、圆角、阴影、间距、描边、图标尺寸都是具名标度;CI 拒绝组件代码里的硬编码字面量
  • 运行时内置——App 根节点一次调用接好主题、i18n、浮层宿主与稳定化的安全区管线
  • i18n 内置——按 BCP 47 语言标签解析语言包,按域拆分不撞 Android DEX 上限,下游库接同一条管线
  • Android · iOS · Web · 鸿蒙——同一份 commonMain;鸿蒙通过并行构建配置可构建,设备端尚未验证

与主流方案的对比 ​

没人听说过 GearUI Kit,但右边几列你至少用过一个。要说清这套栈强在哪,最诚实的办法就是把它放到你熟悉的东西旁边。每一行都是真实差异:✅ 标的是这套栈明显领先的地方,最后一行是它明显落后的地方。完整对比里有推理过程、每一层各自解决的痛点、调试工具链,以及每个数字的出处。

GearUI Kit + KuiklyUI + KMP普通 KMP(Compose MP)FlutterReact Native
渲染✅ 全部是真实原生视图Android 原生;iOS 画布自带引擎,全平台画布真实原生视图
原生控件:输入法、自动填充、辅助功能、文本选择✅ 系统自带iOS 上重实现全部重实现;原生视图要「嵌」进去系统自带
跟随系统设计升级(iOS 26)✅ 系统发布当天即得iOS 上等重画等框架重画系统发布当天即得
性能✅ 首屏 122ms vs 原生 125ms · SDK 300KB / 1.2MB ¹Skiko引擎,MB 级JS 引擎 + bundle
平台调试工具✅ 每个视图可见、可归因;Android 上就是原生天花板Android 可见,iOS 黑盒黑盒 FlutterView,只能 DevTools可见,但要对两条栈
语言Kotlin,与 Android 团队和 JVM 后端共享KotlinDartJS / TS
默认视觉✅ HeroUI Native 打底 + iOS 26 平台控件,四端一致,71 个组件Material 3Material;Cupertino 是二等公民无
设计一致性✅ Token 由 22 项 CI 检查强制无可主题化,不强制无
HarmonyOS✅ 官方目标平台无社区分支华为维护的分支
生态与成熟度小 · beta6(KuiklyUI 在腾讯产线承载 5 亿 DAU)中大 · 2017 起极大 · 2015 起

¹ 腾讯官方在鸿蒙上的实测,华为 Mate 60,复杂 Feed 流场景——出处。SDK 体积来自 KuiklyUI README。

截图 ​

在 iPhone 17 Pro Max 模拟器(iOS 26.2)上运行 sample 截取。语言与主题都在设置页运行时切换,所有组件自动跟随。

中文组件索引
首页 · 中文
英文组件索引
首页 · English
设置页亮色
设置 · 亮色
设置页暗色
设置 · 暗色

为什么需要它 ​

Compose Multiplatform 给了你一种写 UI 的语言,但没给你一个第一天就像成品的组件库,也没给你一个十个人同时提交后还能保持一致的设计系统。GearUI Kit 是渲染器之上的那一层:组件、token、运行时管线(浮层、安全区、键盘、i18n),以及防止这一切漂移的 CI 护栏。

它在 PrivChat 的共享 UI 层生产使用,多数组件就是在那里打磨成型的。

下一步 ​

GearUI Kit 基于 Apache License 2.0 协议发布。