SuperAPI AI 工具集

kotlin-multiplatform

编程与开发

查看项目

更新于 10-17 16:16

技能介绍

用途

该技能面向 Amethyst 项目的 Kotlin Multiplatform(KMP)架构,核心用途是辅助平台抽象决策:判断一段代码应当跨平台共享,还是保留为平台特定实现;以及代码应放置在哪个源集。它适用于以下场景:决定是否创建 expect/actual 还是保持 Android-only;判断 ViewModel 逻辑能否共享;确定 crypto、JSON、网络实现应归属何处;处理依赖 Android Context 的代码能否抽象;识别代码是否放错模块;为 iOS/web/wasm 目标做准备;检测错误的代码放置。

主要能力

技能提供一套“抽象决策树”,以“这段代码是否会被 2 个以上平台复用”为起点,依次判断:是否为纯 Kotlin(无平台 API)→ 放入 commonMain;是否按平台变化或按 JVM 与非 JVM 变化 → 分别使用 expect/actual 或 jvmAndroid;是否复杂或与 UI 相关 → 保留平台特定。最后以“抽象维护成本是否低于重复成本”作为收尾判断。

技能还给出代码库中的真实示例:crypto 使用 expect/actual(各平台安全 API 不同);JSON 解析放入 jvmAndroid(Jackson 仅限 JVM,可用于 Android + Desktop,不适用于 iOS/web);导航保留平台特定(Activity 与 Window 的 UI 范式根本不同)。

技能将源集视为依赖图而非文件夹,并解释 jvmAndroid 模式:它不是平台,而是共享 JVM 层,用于在 Android 与 Desktop 之间共享 JVM 库(如 Jackson、OkHttp、url-detector)。使用 jvmAndroid 的条件是 JVM 特定库、Android 与 Desktop 实现相同、库无法在 iOS/web 运行;不应用于纯 Kotlin 代码、平台特定 API 或应全平台工作的代码。

技能还列出“始终抽象 / 经常抽象 / 有时抽象 / 很少抽象 / 从不抽象”的代码类型指南,并给出 expect/actual 的机制与模式分类(object 单例、class 可实例化、function 工具函数),以及 Android、JVM(Desktop)、iOS 当前主要目标的成熟模式,和 web/wasm 未来目标的约束与迁移建议(如 kotlinx.serialization 替代 Jackson、ktor 替代 OkHttp、kotlinx.datetime 替代自定义日期处理)。

使用方式

技能以决策树和快速参考表的形式引导判断,并包含脚本:scripts/validate-kmp-structure.sh 用于检测错误放置、验证源集;scripts/suggest-kmp-dependency.sh 用于建议 KMP 库替代方案(ktor、kotlinx.serialization 等)。技能还说明何时调用 gradle-expert 技能(依赖冲突、源集构建错误、版本目录问题、重复类错误、性能/构建时间问题),以及需要标记的问题(commonMain 中出现平台代码、业务逻辑重复、重复造轮子)。

适用场景

适用于 Amethyst 项目的 KMP 架构决策,包括新增功能时判断共享与平台特定边界、准备 iOS/web/wasm 目标、审查代码放置、识别抽象泄漏与过度抽象。

限制

技能内容针对 Amethyst 项目,包含该项目特有的 jvmAndroid 模式与源集结构,不一定直接适用于其他 KMP 项目。web/wasm 目标尚未实现,相关建议属于未来规划。具体依赖版本、构建配置细节需结合项目实际文件。