HarmonyKit
一个开箱即用的 HarmonyOS 快速开发框架
介绍
HarmonyKit 是一个基于 HarmonyOS NEXT / ArkTS / ArkUI 的快速开发框架，内置常用基础能力（网络、分页、数据库、本地存储、状态管理、导航等），内部集成 IBest 生态三方库，并配套示例页面，帮助你按拉仓库、运行、填业务的路径快速启动项目。
适用场景
- 需要一套可落地的 HarmonyOS 工程基础能力与目录规范。
- 希望直接在示例页面上替换为真实业务，而不是从零搭架构。
- 对导航、状态、数据层有明确规范诉求的团队或个人。
核心能力
- 基础能力：网络封装、分页、数据库、本地存储、状态管理。
- 三层架构：Core（框架核心）、Foundation（业务基础）、Feature（业务功能）。
- 可运行示例：导航、数据库、存储与适配示例可直接参考。
- 设计系统：统一颜色、间距、字体与通用组件。
三层架构
┌─────────────────────────────────────────────────────────────┐
│ feature/ (业务功能层) │
│ auth / demo / main / user │
├─────────────────────────────────────────────────────────────┤
│ foundation/ (业务基础设施层) │
│ biz_model / biz_navigation / biz_state │
│ database / datastore / network / repository │
├─────────────────────────────────────────────────────────────┤
│ core/ (框架核心层) │
│ base / designsystem / ibestui / model / navigation │
│ result / state / ui / util │
└─────────────────────────────────────────────────────────────┘- Core（框架核心）：基类、设计系统、导航框架、通用模型、UI 组件、工具类等。与业务无关，可直接复用到其他项目。内置 IBest-UI-V2 组件库能力。
- Foundation（业务基础）：业务模型、业务路由、业务状态、数据源（网络/数据库/存储）、仓库层。是 Core 与 Feature 之间的桥梁。
- Feature（业务功能）：以业务模块组织页面，默认包含 auth / user / demo 等示例模块。
- Navigation（导航）：分为 core/navigation（框架能力）和 foundation/biz_navigation（业务路由）两层。
示例项目
如果你想查看完整的业务示例，可以参考 青商城（HarmonyOS）。它基于本框架开发，覆盖更完整的业务流程与页面实现。