鸿蒙（HarmonyOS）开发
面向有一定移动开发经验、想系统掌握鸿蒙应用开发的笔记。鸿蒙开发的主线是 ArkTS 语言（声明式状态管理）→ ArkUI 声明式 UI → Stage 应用模型与系统能力 → 工程与上架。示例基于 HarmonyOS NEXT（ArkTS、API 12 及以上）语境编写，具体以 DevEco Studio 随附 SDK 为准，需在 DevEco Studio 中验证。本子目录隶属于客户端开发。
先建立四个认知
- HarmonyOS 与 OpenHarmony 的关系：OpenHarmony 是开源底座（鸿蒙操作系统的公共代码库）；HarmonyOS 是华为基于它构建的商用发行版；HarmonyOS NEXT 是自 5.0 起全线不兼容 Android 的版本（俗称「纯血鸿蒙」），应用只能以 ArkTS/ArkUI 与系统 API 开发，不能直接运行 APK；
- 三件事构成主要学习曲线：ArkTS 语言（TS 严格化的 UI 声明语言）、ArkUI 框架（声明式组件模型 + 状态驱动）、Stage 模型（应用与组件生命周期 + 进程/任务管理）；
- 生态事实：鸿蒙应用以华为应用市场（AGC AppGallery）为主要分发渠道，签名、Profile、上架审核全链路绕不开 AppGallery Connect；
- 与既有技能树的关系：学过 Flutter/SwiftUI 的「声明式 UI + 状态管理」心智可以直接迁移到 ArkUI；ArkTS 与 TypeScript 语法接近，但限制严格得多，不是「换个壳」。
子类目页面
- ArkTS 语言与状态管理 — 静态类型约束与 TS 差异、UI 状态装饰器体系（V1/V2）、组件通信与持久化
- ArkUI 声明式 UI — 自定义组件与生命周期、声明式布局、列表滚动、路由导航、样式与动效
- 应用模型与系统能力 — Stage 模型、module 配置、UIAbility 生命周期、Want 拉起与权限
- 工程与发布 — DevEco Studio 工程结构、HAP/HAR/HSP 包类型、签名与 AGC 上架、性能调试
规划清单
| 主题 | 说明 | 状态 |
|---|---|---|
| ArkTS 语言与状态 | 语言子集约束、装饰器、状态管理 V1/V2 | ✅ 已收录（arkts.md） |
| ArkUI 声明式 UI | 组件、布局、生命周期、路由、动效 | ✅ 已收录（arkui.md） |
| Stage 应用模型 | UIAbility、Want、ExtensionAbility、权限 | ✅ 已收录（stage-model.md） |
| 工程与发布 | DevEco、包类型、签名、AGC、性能工具 | ✅ 已收录（engineering.md） |
| 系统能力专题 | 网络、数据管理、后台任务、多媒体等能力逐个深入 | 待规划（分布式协同、元服务与原子化服务、卡片开发将后续补齐） |
写作规范
- 与客户端开发保持一致：每篇含「核心概念 → 代码示例 → 常见坑 → 检查清单」；
- 代码示例必须标注版本语境，凡未实机验证均注明「需在 DevEco Studio 中验证」；
- 命名、能力边界以 DevEco Studio 随附 SDK 的 API 为准，不写死未经确认的版本号。
写作规范请参阅写作指南。