logo
积分中心
Kotlin Multiplatform 2.2.21 + Compose Multiplatform 1.9.2 适配 HarmonyOS:共享代码之外,还要解决哪些工程问题?
头像 程序山河 2026-11-10 16:40:15    发布
0 浏览 0 收藏

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 MultiplatformUI 框架版本
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 是否跨平台则根据产品体验和团队维护成本决定。

对于需要长期维护多端应用的团队,这种分层策略往往比单纯追求代码复用率更有实际意义。


©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS
地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255