CPF-KMP-CMP

致力于将 Kotlin Multiplatform 和 Compose Multiplatform 的开发体验带入鸿蒙生态 (OpenHarmony)。

• 声明式 UI。 基于 Compose Multiplatform 的声明式 UI 框架，让鸿蒙应用开发更简洁、更高效。
• 跨平台复用。 一套 Kotlin 代码，同时编译为 Android、iOS 和 HarmonyOS 平台产物，最大化代码复用。
• 原生性能。 通过自研编译工具链和统一渲染引擎，在鸿蒙平台上提供接近原生的运行性能。
• 完整工具链。 提供从工程创建、编码调试、编译构建到签名推包的一站式鸿蒙开发体验。

CPF-KMP-CMP 由社区开发者和核心贡献者共同开发和维护。

Contents

• 要求
• 快速开始
• 文档
• Release Notes
• 如何贡献
• License

要求

CPF-KMP-CMP 的应用可运行在 HarmonyOS（API 17+）的模拟器或真机上。开发环境支持 Windows、macOS(Arm64/x86_64)和Linux。

• HarmonyOS 模拟器或真机
• 华为开发者账号 — 运行和调试应用时需要进行签名
• DevEco Studio — 鸿蒙工程管理、签名与推包
• Android Studio (>=2024.2.1，Gradle JDK 切换为 JDK17) — Kotlin/KMP 工程开发

快速开始

请参考 快速开始 完成环境搭建和第一个鸿蒙应用的运行。

主要步骤：

1. 安装 Android Studio，配置 Gradle JDK 为 JDK17
2. 在 Android Studio 中安装 Kotlin 和 Kotlin Multiplatform 插件
3. 安装 KMP工具链插件（目前采用离线安装方式）
4. 等待 Gradle Sync 完成后，启动鸿蒙工程并运行到模拟器或真机

文档

完整的中文文档请查阅 目录，涵盖以下内容：

KMP 与 CMP 官方文档：

• Kotlin Multiplatform 官方文档
• Compose Multiplatform 官方文档

Release Notes

每个版本的更新内容请查阅 Release Notes：

• KMP v2.2.21-0.4.0 & CMP v1.9.2-0.4.0（beta2）
• KMP v2.2.21-0.3.0 & CMP v1.9.2-0.3.0（beta1）

如何贡献

欢迎参与 CPF-KMP-CMP 的文档建设与代码贡献。

• 阅读 贡献指南 了解开发流程、提交流程与代码规范
• 提交 Issue 反馈问题或提出改进建议
• 提交 Pull Request 参与代码和文档贡献
• 本仓库使用 pre-commit hook 进行死链检查，提交前请通过 git config core.hooksPath .githooks 启用检查，按照指引安装 lychee

License

CPF-KMP-CMP 基于上游开源许可证发布，详见 LICENSE 文件。