# HarmonyOSHub

**Repository Path**: codenestFlow/HarmonyOSHub

## Basic Information

- **Project Name**: HarmonyOSHub
- **Description**: 基于 HarmonyOS NEXT (ArkTS + ArkUI) 构建的鸿蒙校园生态应用集群，覆盖校园生活全场景，持续更新中。
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-22
- **Last Updated**: 2026-08-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# 🌱 HarmonyOS Hub

### 一站式鸿蒙校园生态应用集群 · 持续更新中

<p>
  <img src="https://img.shields.io/badge/HarmonyOS-NEXT%206.1.0%2B-0A59F7?style=for-the-badge&logo=harmonyos&logoColor=white" alt="HarmonyOS">
  <img src="https://img.shields.io/badge/ArkTS-5.0.0-FF6B35?style=for-the-badge&logo=typescript&logoColor=white" alt="ArkTS">
  <img src="https://img.shields.io/badge/ArkUI-声明式-1A73E8?style=for-the-badge&logo=flutter&logoColor=white" alt="ArkUI">
  <img src="https://img.shields.io/badge/License-Apache--2.0-37474F?style=for-the-badge&logo=apache&logoColor=white" alt="License">
</p>

<p>
  <img src="https://img.shields.io/badge/状态-持续更新中-FF6B6B?style=flat-square&labelColor=1A1A2E" alt="Status">
  <img src="https://img.shields.io/badge/已上线应用-3-00C9A7?style=flat-square" alt="Apps">
  <img src="https://img.shields.io/badge/更新于-2026--08--22-7B68EE?style=flat-square" alt="Update">
  <img src="https://img.shields.io/badge/作者-奇兰%2FcodenestFlow-FFA94D?style=flat-square" alt="Author">
</p>

<p><sub>原生 HarmonyOS 应用 · 覆盖校园生活全场景 · 应用持续不断地加入本仓库</sub></p>

---

</div>

## ✨ 项目特点

> **HarmonyOS Hub 是一个会持续生长的应用集群，而非一次性发布的成品。**

- 🔄 **持续更新**：每个新应用都以独立 commit 推送到本仓库，关注即可第一时间获取。
- 🧩 **即开即用**：每个子目录都是完整的 DevEco Studio 工程，独立编译、运行，互不依赖。
- 🎨 **统一设计**：共享主题引擎，视觉一致、风格统一。
- 📚 **实战参考**：覆盖校园多场景，适合 HarmonyOS 开发者学习 ArkTS + ArkUI 最佳实践。

---

## 📦 已收录应用

| 编号 | 目录 | 名称 | 领域 | 简介 |
|:---:|:---|:---|:---|:---|
| `01` | `01-dorm-groupbuy` | 宿舍拼单 | 生活服务 | 面向宿舍场景的团购拼单，多 Tab 架构示例 |
| `02` | `02-campus-nav` | 校园导航 | 资源预约 | 校园地图与地点导航，覆盖教学楼、食堂、宿舍等 |
| `03` | `03-campus-notice` | 校园通知 | 信息管理 | 校园公告与通知聚合，支持分类与置顶 |

> 🚧 **更多应用陆续上线中**，每次新增都会以独立提交推送，详见下方「更新日志」。

---

## 🗓️ 更新日志

| 日期 | 内容 |
|:---:|:---|
| 2026-08-22 | 新增 `02-campus-nav`、`03-campus-notice`，仓库现含 3 个应用 |
| 2026-08-22 | 首次提交 `01-dorm-groupbuy`，仓库建立 |

---

## 🛠️ 技术栈

| 维度 | 技术选型 |
|:---:|:---|
| **操作系统** | HarmonyOS NEXT 6.1.0(23) 及以上 |
| **开发语言** | ArkTS（TypeScript 超集，鸿蒙原生语言） |
| **UI 框架** | ArkUI 声明式开发范式（modelVersion 5.0.0） |
| **开发工具** | DevEco Studio |
| **构建系统** | Hvigor |
| **包管理** | oh-package（OpenHarmony 包管理器） |
| **架构模式** | 统一主题引擎 + 模块化页面 + 组件化开发 |
| **许可证** | Apache-2.0 |

---

## 🗂️ 应用领域（随更新逐步扩充）

| 板块 | 覆盖场景 | 已上线 |
|:---:|:---|:---:|
| **生活服务** | 拼单、打印、缴费、快递、餐饮、共享出行 | `01` |
| **资源预约** | 导航、会议室、自习室、运动场、实验室 | `02` |
| **信息管理** | 通知、歌单、积分商城、问卷、科研项目、AI 工具 | `03` |
| **学习工具** | 考试复习、错题管理、单词背诵、阅读笔记、资料共享 | 🚧 |
| **社交互动** | 社区、兴趣匹配、摄影分享、表白墙、树洞 | 🚧 |
| **班级管理** | 通讯录、班费、任务分配、签到、投票 | 🚧 |

---

## 📁 目录结构

每个应用均为独立的 DevEco Studio 工程，遵循统一的工程规范：

```
HarmonyOS_hub/
├── 01-dorm-groupbuy/             # 应用 01（已上线）
├── 02-campus-nav/                # 应用 02（已上线）
├── 03-campus-notice/             # 应用 03（已上线）
├── 04-.../                       # 应用 04（后续持续上传）
├── ...                           # 更多应用陆续加入
├── README.md
└── .gitignore
```

单应用工程结构（以 `01-dorm-groupbuy` 为例）：

```
<app>/
├── AppScope/                     # 应用级配置（app.json5、resources）
├── entry/                        # 主入口模块
│   └── src/main/
│       ├── ets/                  # ArkTS 源码
│       │   ├── common/           # 公共模块（主题、常量）
│       │   ├── components/       # 自定义组件
│       │   ├── model/            # 数据模型
│       │   ├── pages/            # 页面
│       │   └── viewmodel/        # 视图模型
│       ├── resources/            # 模块级资源（字符串、颜色、媒体）
│       └── module.json5          # 模块配置
├── build-profile.json5           # 构建配置
├── oh-package.json5              # 包配置
└── hvigorfile.ts                 # Hvigor 构建脚本
```

---

## 🚀 快速开始

### 环境要求

| 工具 | 版本要求 |
|:---:|:---|
| DevEco Studio | 6.1.0 及以上 |
| HarmonyOS SDK | 6.1.0(23) 及以上 |
| HarmonyOS NEXT 设备 / 模拟器 | 6.1.0 及以上 |

### 运行步骤

1. **克隆仓库**

   ```bash
   git clone https://gitee.com/codenestFlow/HarmonyOSHub.git
   ```

2. **打开工程**：在 DevEco Studio 中选择 `File → Open`，打开任意一个应用子目录。

3. **同步依赖**：工程打开后 DevEco Studio 会自动执行 `ohpm install`，也可手动执行：

   ```bash
   ohpm install
   ```

4. **编译运行**：点击 **Run** 或按 `Ctrl + R` / `Cmd + R`，选择目标设备 / 模拟器即可。

> 每个应用都是独立工程，可单独打开、编译和运行，互不依赖。

---

## 🏗️ 架构亮点

<details>
<summary><b>统一主题引擎</b></summary>

通过 `Theme.ets` 统一管理颜色、字号、圆角等设计令牌，保证所有应用视觉一致。

</details>

<details>
<summary><b>声明式 UI 开发</b></summary>

全面采用 ArkUI 声明式范式，借助 `@Component`、`@State`、`@Builder` 等装饰器实现响应式 UI。

</details>

<details>
<summary><b>模块化页面设计</b></summary>

`pages/` + `components/` + `model/` + `viewmodel/` 分层架构，职责清晰、易于扩展。

</details>

<details>
<summary><b>原生性能体验</b></summary>

基于 HarmonyOS NEXT 纯血架构，无 AOSP 兼容层，充分发挥 ArkTS 与方舟运行时性能优势。

</details>

---

## 🗺️ 路线图

- [x] 应用 01：宿舍拼单 上线
- [x] 应用 02：校园导航 上线
- [x] 应用 03：校园通知 上线
- [ ] **持续上传新应用**（按编号累积，覆盖更多场景）
- [ ] 接入真实后端 API，实现完整业务闭环
- [ ] 引入分布式能力（跨设备协同、服务流转）
- [ ] 集成 AI 大模型能力（端侧推理、智能助手）
- [ ] 补充单元测试与 UI 自动化测试
- [ ] 适配折叠屏、平板等多形态设备
- [ ] 发布至华为应用市场（AppGallery）

---

## 🤝 贡献

欢迎提交 Issue 与 Pull Request。请确保提交前代码可正常编译运行。

---

## 📄 许可证

基于 [Apache License 2.0](./LICENSE) 开源，可自由使用、修改与分发。

---

<div align="center">

**HarmonyOS Hub** · 持续生长，让鸿蒙原生生态更丰富 🌱

<p>
  <sub>Author: 奇兰（@codenestFlow）· Built with ArkTS on HarmonyOS NEXT</sub><br>
  <sub>© 2026 HarmonyOS Hub. All rights reserved.</sub>
</p>

</div>