# harmonyos-tutorial

**Repository Path**: qingge_dada/harmonyos-tutorial

## Basic Information

- **Project Name**: harmonyos-tutorial
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-28
- **Last Updated**: 2026-06-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 鸿蒙 NEXT 原生开发实战教程 | ArkTS + ArkUI + HarmonyOS API 12+

> 从零到一的 HarmonyOS NEXT 开发学习路线，57 章完整覆盖 ArkTS 语言、ArkUI 声明式布局、状态管理、网络请求、数据存储、权限管理、多线程、动画手势、Canvas 自定义绘制、UIAbility 生命周期、调试工具链、单元测试、签名安全、音视频、AI能力、分布式数据、设备协同、应用市场运营、应用监控与数据分析、CI/CD自动化发布、无障碍适配、Service Widget卡片开发、进阶设计模式与架构、网络进阶与离线优先架构、WebView与混合开发、RDB关系型数据库进阶、UI进阶与自定义组件实战、物候App与文化签App完整项目复盘、鸿蒙开发最佳实践方法论。全部实战项目驱动，配套物候 App 与文化签 App 真实案例。

## 为什么学这个教程

鸿蒙生态正在爆发，原生开发人才缺口巨大。本教程不做概念堆砌，每个章节都配完整可运行代码，学完就能上手写项目。

## 适合谁

- 有 TypeScript/JavaScript 基础的前端开发者
- 想转型鸿蒙原生开发的 Android/iOS 开发者
- 对鸿蒙原生开发感兴趣的技术爱好者

## 学习路线

### 第一阶段：环境与基础（已完成）

| 章节 | 内容 | 状态 |
|------|------|------|
| 01 | 开发环境搭建：DevEco Studio 安装与配置 | ✅ |
| 02 | 第一个鸿蒙应用：Hello World 完整流程 | ✅ |
| 03 | ArkTS 语言速成：从 TypeScript 到 ArkTS | ✅ |
| 04 | 项目结构详解：目录、配置、资源管理 | ✅ |

### 第二阶段：UI与交互（已完成）

| 章节 | 内容 | 状态 |
|------|------|------|
| 05 | ArkUI组件详解：Text/Image/Button/TextInput | ✅ |
| 06 | 布局系统详解：Column/Row/Stack/Flex/Grid | ✅ |
| 07 | 状态管理详解：@State/@Prop/@Link/@Provide/@Watch | ✅ |
| 08 | 数据本地存储：Preferences/RDB/KVStore全方案对比 | ✅ |
| 09 | 自定义组件开发：@Builder/@Component/@BuilderParam | ✅ |
| 10 | 列表与滚动组件：Scroll/List/Tabs/Grid/LazyForEach | ✅ |
| 11 | 路由与页面导航：pushUrl/params/页面栈 | ✅ |
| 12 | 动画系统深入：属性动画/转场/粒子 | ✅ |
| 13 | 手势系统：点击/滑动/拖拽/缩放手势 | ✅ |
| 14 | 弹窗与交互组件：AlertDialog/CustomDialog/Toast | ✅ |

### 第三阶段：数据与网络（已完成）

| 章节 | 内容 | 状态 |
|------|------|------|
| 15 | 网络请求实战：HTTP/数据解析/错误处理 | ✅ |
| 16 | 文件管理与沙箱存储：四沙箱/POSIX读写/流式拷贝/rawfile/原子写入/8坑清单 | ✅ |
| 17 | 图片与媒体资源：Image/objectFit/相册/视频 | ✅ |
| 18 | 权限管理：相机/位置/存储/通知/后台定位/上架审核10条Checklist | ✅ |
| 19 | 多线程与并发编程：TaskPool/Worker/线程通信 | ✅ |
| 20 | 性能优化：长列表/内存/启动速度 | ✅ |

### 第四阶段：实战项目

| 章节 | 内容 | 状态 |
|------|------|------|
| 21 | 实战：物候·二十四节气App | ✅ |
| 22 | 实战：文化签·诗词求签App | ✅ |

### 第五阶段：上架与运营

| 章节 | 内容 | 状态 |
|------|------|------|
| 23 | 上架华为应用市场：证书/签名/隐私/审核 | ✅ |
| 24 | 自定义组件库开发与ohpm发布：FlipCard/PhotoOverlay/FortuneTag | ✅ |

### 第六阶段：进阶架构

| 章节 | 内容 | 状态 |
|------|------|------|
| 25 | UIAbility 生命周期与应用状态管理：四阶段钩子/Want通信/启动模式/状态恢复 | ✅ |
| 26 | 自定义绘制与Canvas组件：路径/渐变/坐标变换/逐帧动画/手势绘图 | ✅ |
||| 27 | 调试与DevEco Studio工具链：hilog/断点/ArkUI Inspector/Network Profiler/hdc | ✅ |
||| 28 | 单元测试与自动化测试：@ohos.test/Mock/Stub/异步测试/覆盖率 | ✅ |
| 29 | 多设备适配与响应式布局：断点系统/GridRow栅格/折叠屏/分屏/跨设备同步 | ✅ |

### 第七阶段：高级能力（全部完成）

| 章节 | 内容 | 状态 |
|------|------|------|
| 30 | 应用签名与安全机制：debug/release签名/密钥管理/完整性保护 | ✅ |
| 31 | 通知与后台任务：LocalNotification/ContinuousTask/推送 | ✅ |
| 32 | 音视频播放与录制：AVPlayer/Video/XRecord/编解码 | ✅ |
| 33 | 地图与位置服务：geoLocation/POI/地理围栏/路线规划 | ✅ |
| 34 | 蓝牙与近场通信：BLE扫描/NFC标签/Beam数据传输 | ✅ |
| 35 | AI能力集成：图像识别/文本分类/智能推荐/端侧推理 | ✅ |
| 36 | 国际化与多语言：$t()/RTL布局/日期数字本地化 | ✅ |
| 37 | 深色模式适配：暗色主题/颜色资源分层/壁纸取色 | ✅ |
| 38 | 性能分析与调优：DevEco Profiler/CPU/内存/帧率分析 | ✅ |
| 39 | 应用内购买与支付：IAP接入/商品配置/订阅管理 | ✅ |
| 40 | 分布式数据管理：KV Store/数据同步/冲突解决 | ✅ |
| 41 | 设备协同与跨端流转：Continuation/FA迁移/剪贴板共享 | ✅ |
| 42 | 应用市场运营与增长：ASO优化/版本迭代/数据埋点 | ✅ |
| 43 | 应用上架全流程实战：签名证书/版本管理/审核避坑/灰度发布/数据埋点 | ✅ |
| 44 | 性能优化实战：启动时间/内存管理/帧率优化/网络优化/性能监控工具 | ✅ |
| 45 | 安全与隐私保护实战：权限管理/数据加密/网络安全/隐私合规/生物识别/安全审计 | ✅ |
| 46 | 应用监控与运营数据分析实战：崩溃监控/性能指标/业务埋点/数据可视化/告警机制 | ✅ |
|| 47 | CI/CD自动化发布实战：hvigorw构建/签名管理/Gitee CI/AGC上传/灰度发布/回滚 | ✅ |
||| 48 | 无障碍适配实战：屏幕阅读器/语义层/焦点管理/大字体/色彩对比/触摸目标 | ✅ ||
|| 49 | Service Widget卡片开发实战：模板选型/尺寸体系/FormExtensionAbility/数据持久化/深色模式 | ✅ |
|| 50 | ArkTS进阶设计模式与架构实战：组件通信/状态机/事件总线/Repository模式/组件复用 | ✅ |
| 51 | 网络进阶与离线优先架构：离线优先策略/缓存管理/离线队列/请求去重/断路器模式 | ✅ |
| 52 | WebView与混合开发实战：WebView配置/JS双向通信/本地HTML加载/性能优化/安全策略/物候App混合架构 | ✅ |
| 53 | RDB关系型数据库进阶：复杂查询Join/索引设计优化/FTS5全文搜索/ORM数据访问层/数据库迁移管理/物候App数据层架构 | ✅ |
| 54 | UI进阶与自定义组件实战：@Styles/@Extend样式复用/@AnimatableExtend/复杂布局组合/Canvas自定义绘制进阶/UI性能优化/物候App组件库封装 | ✅ |
| 55 | 物候App完整项目复盘：从原型到上架的全链路实战总结/四层架构/状态管理策略/Canvas绘制/Service Widget/测试与性能优化/上架审核/CI-CD | ✅ |
| 56 | 文化签App完整项目复盘：诗词求签的创意实现与技术选型/轻量架构/3D翻牌动画/分享卡片/包体积控制/上架策略 | ✅ |
| 57 | 鸿蒙开发最佳实践：架构选择/状态管理/数据层选型/性能优化/动画流畅度/包体积控制/上架审核/灰度发布/设计规范/测试策略/开源策略 | ✅ |

> ✅ 已完成 🔨 生成中（每日自动贡献持续推进）

> 教程章节均含物候App/文化签App真实代码与上架踩坑，配套小红书草稿见 marketing/xiaohongshu/。

## 项目结构

```
harmonyos-tutorial/
├── README.md                    # 本文件
├── docs/                        # 教程文档（58篇，覆盖第1-57章+FAQ）
│   ├── 28-unit-testing.md           # 单元测试与自动化测试
│   ├── 27-debugging-toolchain.md    # 调试与DevEco Studio工具链
│   ├── 26-canvas-custom-drawing.md    # 自定义绘制与Canvas组件
│   ├── 01-dev-environment.md    # 开发环境搭建
│   ├── 02-first-app.md          # 第一个应用
│   ├── 03-arkts-basics.md       # ArkTS 语言速成
│   ├── 04-project-structure.md  # 项目结构详解
│   ├── 05-ui-components.md      # ArkUI 组件详解
│   ├── 06-layout-system.md      # 布局系统详解
│   ├── 07-state-management.md   # 状态管理详解
│   ├── 08-data-storage.md       # 数据本地存储
│   ├── 09-custom-components.md  # 自定义组件开发
│   ├── 10-list-and-scroll.md    # 列表与滚动组件
│   ├── 11-router-and-nav.md     # 路由与页面导航
│   ├── 12-animation-guide.md    # 动画系统深入
│   ├── 13-gesture-handling.md   # 手势处理
│   ├── 14-dialog-system.md      # 弹窗与交互组件
│   ├── 15-network-http.md       # 网络请求实战
│   ├── 16-file-management.md    # 文件管理与沙箱存储
│   ├── 17-image-and-media.md    # 图片与媒体资源
│   ├── 18-permissions.md        # 权限管理
│   ├── 19-concurrency-worker.md # 多线程与并发编程
│   ├── 20-performance.md        # 性能优化实战
│   ├── 21-project-wuhou.md      # 实战：物候二十四节气App
│   ├── 22-project-wenhua.md     # 实战：文化签诗词求签App
│   ├── 23-app-store-publishing.md # 上架华为应用市场
│   ├── 24-component-library-ohpm.md # 自定义组件库开发与ohpm发布
│   ├── 25-uiability-lifecycle.md    # UIAbility 生命周期与应用状态管理
│   └── faq.md                   # 常见问题 FAQ
├── examples/                    # 可运行示例代码
│   ├── README.md                # 示例使用说明
│   ├── 01-hello-harmony.ets     # Hello World 页面（第02章）
│   ├── 02-list-and-state.ets    # 列表+状态管理（第07/10章）
│   ├── 03-flip-card-animation.ets # 3D翻牌动画（第12/13章）
│   ├── 04-reusable-components.ets # 可复用组件预览（第09/24章）
│   ├── 05-permission-fallback.ets # 权限拒绝兜底（第18章）
│   ├── 06-network-error-handling.ets # HTTP错误兜底（第15章，超时/重试/404/5xx/parse保护）
│   └── example-7/                   # 计数器+列表选择（@State/ForEach/条件渲染）
│   └── example-8/                   # 计数器+二十四节气列表（组件交互）
│   └── example-9/                   # 二十四节气时钟盘（Canvas路径绘制/坐标变换/渐变）
├── cheatsheet/                  # 速查表
│   ├── arkts-syntax.md          # ArkTS 语法速查
│   ├── layout-cheatsheet.md     # 布局速查
│   ├── animation-cheatsheet.md  # 动画速查
│   └── state-management-cheatsheet.md # 状态管理速查（九种装饰器）
├── marketing/                   # 营销素材
│   └── xiaohongshu/             # 小红书草稿（96篇，覆盖全部47章+实战上架+FAQ）
└── LICENSE
```

## 特色

- 全部基于 HarmonyOS NEXT (API 12+)，不讲过时内容
- 每个章节都有完整可运行代码，不是伪代码
- 从企业实际项目经验出发，讲真实开发中会遇到的坑
- 持续更新，跟踪鸿蒙 SDK 版本迭代

## 快速开始

```bash
# 克隆项目
git clone https://gitee.com/qingge_dada/harmonyos-tutorial.git

# 按章节顺序学习
cd harmonyos-tutorial/docs

# 或直接看可运行示例
cd harmonyos-tutorial/examples
# 将 .ets 文件内容复制到 DevEco Studio 新工程的 pages/Index.ets 即可运行
```

## 作者

**Gin** - 前华为云算法工程师，现专注 AI + 传统文化数字化，鸿蒙原生开发者。运营公司：深圳清宇云图科技有限公司。

## 清宇开源矩阵

[guoxue-1.5b-upgrade](https://gitee.com/qingge_dada/guoxue-1.5b-upgrade) — QingChat 1.5B 国学文化垂类模型

[LLM_2025](https://gitee.com/qingge_dada/LLM_2025) — 大模型技术笔记（Transformer/MoE/LLaMA/Qwen3/多模态）

[modelscope-skill](https://gitee.com/qingge_dada/modelscope-skill) — 古诗词意境分析魔搭Skill（AI PC Agent参赛作品）

[data_generator](https://gitee.com/qingge_dada/data_generator) — 国学非遗数据生成系统

[wenhuaqian-app](https://gitee.com/qingge_dada/wenhuaqian-app) — 文化签·鸿蒙诗词求签App

[wuhou-app](https://gitee.com/qingge_dada/wuhou-app) — 物候·二十四节气东方生活美学杂志

## 许可证

MIT License

---

*最后更新: 2026-06-27*