程序山河
2026-11-10 16:40:15 发布Kotlin Multiplatform(KMP)和 Compose Multiplatform(CMP)是近年来跨平台开发中值得关注的技术组合。KMP 主要解决多平台之间的代码共享问题,CMP 则进一步提供跨平台 UI 共享能力。两者结合,可以让团队在 Android、iOS 和 HarmonyOS 等平台之间复用更多代码。
但在 HarmonyOS 项目中,KMP 和 CMP 的适配并不只是增加一个编译目标那么简单。开发者还需要处理 Kotlin 编译工具链、平台运行时、UI 渲染以及 Kotlin 与 ArkTS 之间的互操作。
截至 2026 年 11 月,CPF-KMP-CMP 社区适配方案已经发布 1.1.0 版本,对应上游 Kotlin 2.2.21 和 Compose Multiplatform 1.9.2。适配产物采用“上游版本-适配版本”的命名方式,例如 2.2.21-1.1.0 和 1.9.2-1.1.0。需要注意,这些是社区 HarmonyOS 适配版本,不应直接理解为 Kotlin 或 JetBrains 官方发布的 HarmonyOS 原生版本。
KMP 和 CMP 解决的是两个不同层面的问题
在项目选型时,首先要区分 KMP 和 CMP。
KMP 的核心是共享业务代码。比如网络请求、数据模型、数据处理、业务规则和部分状态管理,可以放在公共模块中,让不同平台复用。
CMP 则进一步扩展到 UI 层。开发者可以使用 Compose 的声明式 UI 写法,在多个平台之间共享界面代码。
因此,一个 KMP 项目并不一定要使用 CMP。对于已经拥有成熟原生 UI 的团队,可以先共享数据层和业务层,再让 HarmonyOS 使用 ArkTS 构建界面。
而对于希望进一步统一 UI 的团队,则可以评估 CMP 的 HarmonyOS 适配能力。
一个典型的工程结构可以设计为:
shared
├── commonMain
│ ├── 数据模型
│ ├── 网络请求
│ ├── 业务逻辑
│ └── 状态管理
│
├── androidMain
│
├── iosMain
│
└── harmonyMain
└── HarmonyOS 平台实现
composeApp
└── 跨平台 UI
HarmonyOS Host
└── ArkTS 应用入口与平台能力
这只是推荐的模块组织示意,具体 source set 名称和构建目标需要以所使用的适配插件版本为准。
版本升级时,不能只升级 Kotlin 插件
KMP 和 CMP 的工程依赖比较复杂。HarmonyOS 适配版本还涉及 Kotlin 编译器、Compose 运行时、Skiko、互操作组件以及 ArkTS 侧运行时。
以 CPF-KMP-CMP 1.1.0 为例,配套版本包括 Kotlin 2.2.21、Compose Multiplatform 1.9.2、Skiko 0.9.22.2,以及相应的 ArkTS 互操作组件。不同组件分别通过 Maven 仓、OHPM 和工具插件等渠道提供。
因此,升级时不能只把 Gradle 中的 Kotlin 插件版本改成 2.2.21,还需要同步检查 Compose、Skiko 和 HarmonyOS 适配运行时。
一个常见的错误是:Kotlin 编译通过了,但 Compose 运行时或平台侧依赖没有同步更新,最终出现构建失败或运行时异常。
建议将版本信息统一管理,至少记录:
| 组件 | 版本关注点 |
| Kotlin | 上游版本与 HarmonyOS 适配版本 |
| Compose Multiplatform | UI 框架版本 |
| Skiko | 图形与渲染依赖 |
| ArkTS 互操作组件 | Kotlin 与 ArkTS 通信能力 |
| OHPM 运行时 | HarmonyOS 侧依赖 |
| Gradle 插件 | 与 Kotlin 版本的兼容关系 |
Kotlin 和 ArkTS 之间的互操作,是项目落地的关键
HarmonyOS 应用仍然有大量平台能力需要通过原生侧完成。例如应用生命周期、系统服务、权限、文件访问和设备能力等。
如果业务逻辑放在 KMP 模块中,而系统能力由 ArkTS 实现,那么两者之间就需要建立稳定的通信机制。
CPF-KMP-CMP 适配方案提供了 Kotlin 与 ArkTS 双向互操作能力,使得已有 Kotlin 代码可以与 HarmonyOS 原生工程协同工作。
从工程设计角度看,建议不要让公共业务模块直接依赖大量平台对象,而是通过接口抽象平台能力。
例如,公共模块只定义一个文件服务接口:
interface FileService {
suspend fun readFile(path: String): ByteArray
suspend fun saveFile(
name: String,
content: ByteArray
): String
}不同平台再提供各自的实现。HarmonyOS 侧可以由 ArkTS 完成具体文件操作,再通过互操作层向公共业务模块提供结果。
这里的代码用于展示 KMP 的接口抽象思路,并不是 CPF 适配框架提供的现成文件 API。实际项目需要根据互操作工具链的调用约定完成绑定。
CMP 跨平台 UI 需要关注渲染和原生体验
如果项目决定使用 CMP 共享 UI,还需要重点验证组件渲染、字体、图片、输入和动画等能力。
共享 UI 不等于所有平台的视觉和交互完全一致。尤其是涉及系统键盘、页面返回、窗口尺寸变化和平台原生控件时,仍然需要针对 HarmonyOS 做体验适配。
例如,一个包含搜索框、列表和详情页的应用,可以先共享普通页面结构和业务状态,再针对系统输入法、窗口布局和返回行为进行平台验证。
对于复杂图形、动画或大量列表数据的页面,还需要关注渲染性能和内存占用。不能只用一个简单 Demo 判断 CMP 已经适合整个业务项目。
最稳妥的路径是先共享业务,再逐步共享 UI
对于已经有 Android 或 iOS 应用的团队,直接把全部 UI 迁移到 CMP,风险和改造成本都比较高。
更实际的路线是先用 KMP 共享网络层、数据模型和业务逻辑,让 HarmonyOS 原生界面复用这些公共模块;待工具链、互操作和运行时稳定之后,再挑选适合共享的页面逐步引入 CMP。
这样既能利用 Kotlin 生态已有的代码资产,也能保留 HarmonyOS 原生开发的灵活性。
KMP 和 CMP 的价值不在于追求所有代码都写成一份,而在于找到最合适的共享边界。业务逻辑适合共享就共享,系统能力需要原生实现就保留原生实现,UI 是否跨平台则根据产品体验和团队维护成本决定。
对于需要长期维护多端应用的团队,这种分层策略往往比单纯追求代码复用率更有实际意义。
相关推荐
33
0
28
0
程序人生下半场
0
0
程序山河
我还没有写个人简介......
帖子
提问
粉丝
Taro 4.x 适配 HarmonyOS:从 ArkTS 方案到 C-API 渲染,跨端架构发生了什么变化?
2026-11-10 16:41:49 发布我为什么在黑客松里选了最冷的按量付费赛道
2026-10-21 10:00:44 发布


京公网安备:11010502051901号