# KMP-CMP

**Repository Path**: wb_1456/kmp-cmp

## Basic Information

- **Project Name**: KMP-CMP
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-18
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KMP&CMP for OpenHarmony

致力于将 [Kotlin Multiplatform](https://github.com/JetBrains/kotlin) 和 [Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform) 的开发体验带入鸿蒙生态 (OpenHarmony)。

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

KMP&CMP for OpenHarmony 由社区开发者和核心贡献者共同开发和维护。

---

## Contents

- [要求](#要求)
- [快速开始](#快速开始)
- [文档](#文档)
- [Release Notes](#release-notes)
- [如何贡献](#如何贡献)
- [License](#license)

## 要求

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

- [**HarmonyOS**](https://developer.huawei.com/consumer/cn/) 模拟器或真机	 
- [**华为开发者账号**](https://developer.huawei.com/consumer/cn/) — 运行和调试应用时需要进行签名	 
- [**DevEco Studio**](https://developer.huawei.com/consumer/cn/deveco-studio/) — 鸿蒙工程管理、签名与推包
- [**Android Studio**](https://developer.android.com/studio?hl=zh-cn) (>=2024.2.1，Gradle JDK 切换为 JDK17) — Kotlin/KMP 工程开发

## 快速开始

请参考 [快速开始](zh-cn/入门/快速开始.md) 完成环境搭建和第一个鸿蒙应用的运行。

主要步骤：

1. 安装 **Android Studio**，配置 Gradle JDK 为 JDK17
2. 在 Android Studio 中安装 **Kotlin** 和 **Kotlin Multiplatform** 插件
3. 安装 [KMP工具链插件](zh-cn/入门/工具链介绍.md#install-plugin)（目前采用离线安装方式）
4. 等待 Gradle Sync 完成后，启动鸿蒙工程并运行到模拟器或真机

## 文档

完整的中文文档请查阅 [目录](./zh-cn/目录.md)，涵盖以下内容：

| 分类 | 内容 |
| --- | --- |
| [入门](./zh-cn/目录.md#入门) | 快速开始、入门指南、OHOS 工具链手册、框架介绍、架构介绍、版本说明 |
| [UI 开发](./zh-cn/目录.md#ui-开发) | 核心概念、布局、导航、资源管理、ViewModel、CMP 组件库、渲染引擎 |
| [深入开发](./zh-cn/目录.md#深入开发) | 功能开发、三方库、平台集成与互操作（FFI / CAPI）、编译构建、调试与性能 |
| [资源](./zh-cn/目录.md#资源) | FAQ、示例工程下载 |

KMP 与 CMP 官方文档：

- [Kotlin Multiplatform 官方文档](https://kotlinlang.org/docs/multiplatform/)
- [Compose Multiplatform 官方文档](https://kotlinlang.org/docs/multiplatform/compose-multiplatform.html)

## Release Notes

每个版本的更新内容请查阅 [Release Notes](./zh-cn/release-notes/)：

- [KMP v2.2.21-0.3.0 & CMP v1.9.2-0.3.0（beta1）](./zh-cn/release-notes/KMP-v2.2.21-0.3.0&CMP-v1.9.2-0.3.0.md)

## 如何贡献

欢迎参与 KMP&CMP for OpenHarmony 的文档建设与代码贡献。

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

## License

KMP&CMP for OpenHarmony 基于上游开源许可证发布，详见 [LICENSE](./LICENSE) 文件。