直接跳到内容

HarmonyKit Logo

HarmonyKit

一个开箱即用的 HarmonyOS 快速开发框架

GitHub   ·   Gitee

介绍

HarmonyKit 是一个基于 HarmonyOS NEXT / ArkTS / ArkUI 的快速开发框架,内置常用基础能力(网络、分页、数据库、本地存储、状态管理、导航等),并配套示例页面,帮助你按拉仓库、运行、填业务的路径快速启动项目。

适用场景

  • 需要一套可落地的 HarmonyOS 工程基础能力与目录规范。
  • 希望直接在示例页面上替换为真实业务,而不是从零搭架构。
  • 对导航、状态、数据层有明确规范诉求的团队或个人。

核心能力

  • 基础能力:网络封装、分页、数据库、本地存储、状态管理。
  • 模块结构:Core 聚焦基础能力,Feature 聚焦业务场景。
  • 可运行示例:导航、数据库、存储与适配示例可直接参考。
  • 设计系统:统一颜色、间距、字体与通用组件。

模块结构

目录以 core/feature/ 为主,navigation 独立成体系:

  • Core(核心):基类、数据层、数据库、本地存储、模型、网络、结果封装、状态管理、工具类、UI 与设计系统等。
    内置 IBest-UI-V2 组件库能力,便于统一 UI 风格与组件使用。
  • Navigation(导航):路由注册、带参跳转、结果回传、路由拦截等流程示例。
    章节内容较多,因此在文档中单独作为一个菜单分组。
  • Feature(业务):以业务模块组织页面,默认包含 auth / user / demo 等示例模块。

示例项目

如果你想查看完整的业务示例,可以参考 青商城(HarmonyOS)。它基于本框架开发,覆盖更完整的业务流程与页面实现。