02.4 HarmonyOS 原生路线
所属:全栈开发面试题库 / 学习路径 / 02 App 端开发
本页目录
一、路线定位与生态判断
HarmonyOS 是三条原生线里最新、资料最少、也最容易被低估的一条。它的技术模型和前两端有本质差异:
- HarmonyOS NEXT 不再兼容 AOSP,不能靠 Android 存量代码平移,必须按 Stage 模型重新组织应用。
- ArkTS 不是「随便写 TS」,它在 TypeScript 之上加了静态约束:禁止
any、禁止运行期改变对象结构、要求显式类型。这些限制换来的是方舟运行时的性能与可静态分析性。 - 分布式能力与元服务/卡片是它真正的差异化入口:跨设备流转、免安装卡片、一次开发多端部署,这些在前两端没有等价物。
适合谁:已在政企、车机、IoT、国产终端生态,或被明确要求适配鸿蒙的开发者;想覆盖国产设备分发的团队;已有 Android/iOS 经验、想补第三端的人。不建议作为零基础第一门语言——生态资料与调试经验都不如前两端成熟,遇到问题可求助的样本少。
前置要求:TypeScript 或 JavaScript 基础(ArkTS 直接建立在 TS 之上)、了解声明式 UI 概念、有一台能跑 DevEco Studio 的机器(Windows 或 macOS 均可)。有过 Android 或 iOS 经验会显著降低理解 Stage 模型与生命周期的成本。
二、阶段划分
| 阶段 | 主题 | 关键内容 | 产出 | 参考学时(全职) |
|---|---|---|---|---|
| H0 | 环境 | DevEco Studio、SDK、模拟器与真机、hdc、HiLog、签名配置 | 真机跑通空工程 | 1 周 |
| H1 | ArkTS | 类型系统、类与接口、泛型、装饰器、模块化、禁止项 | 纯逻辑模块 + 单测 | 3 周 |
| H2 | ArkUI 基础 | 组件、布局、样式、资源引用、页面生命周期 | 多页面应用 | 4 周 |
| H3 | 状态管理 | @State/@Prop/@Link/@Provide/@Consume;V2 的 @ObservedV2/@Trace |
跨组件状态联动 | 4 周 |
| H4 | Stage 模型 | UIAbility、Want、ExtensionAbility、窗口与路由、应用上下文 | 含多入口的应用 | 4 周 |
| H5 | 数据与网络 | RelationalStore、Preferences、文件、分布式数据对象、NetworkKit | 含缓存与同步的 App | 4 周 |
| H6 | 系统能力 | 通知、推送、权限、后台任务、卡片、元服务、跨设备流转 | 带卡片与分布式能力 | 5 周 |
| H7 | 工程与上架 | HAR/HSP/HAP、ohpm、hvigor、签名、AGC 上架、DevEco Profiler | 可上架版本 | 4 周 |
合计约 29 周。鸿蒙的「多设备适配」阶段弹性很大,做车机或平板要额外投入。
三、知识点地图
| 模块 | 知识点 | 掌握程度 |
|---|---|---|
| 语言 | ArkTS 与 TS 的差异、静态约束、装饰器语义 | 能讲清原理 |
| 语言 | 模块化、import/export、类型声明、空安全 | 会用 |
| UI | 声明式语法、组件链式调用、布局容器、栅格与断点 | 能讲清原理 |
| UI | 资源目录与限定词(语言、深浅色、屏幕形态)、多设备适配 | 能讲清原理 |
| UI | 自定义组件、@Builder、@Styles、@Extend、动画 |
会用 |
| 状态 | V1 装饰器体系与层级传递、V2 观察机制与性能差异 | 能讲清原理 |
| 状态 | 状态与 UI 刷新时机、避免过度刷新 | 能讲清原理 |
| 应用模型 | Stage 模型、UIAbility 生命周期、Want 与显式/隐式启动 | 能讲清原理 |
| 应用模型 | ExtensionAbility(服务、数据、卡片)、进程模型 | 会用 |
| 路由 | Navigation/NavPathStack、页面栈、跨设备路由 |
会用 |
| 数据 | RelationalStore(RDB)、Preferences、文件与沙箱 | 能讲清原理 |
| 数据 | 分布式数据对象、跨设备同步与冲突 | 会用 |
| 网络 | NetworkKit、HTTP/HTTPS、证书校验、上传下载 | 能讲清原理 |
| 权限 | 权限申请、授权模式、最小化原则、隐私声明 | 能讲清原理 |
| 系统能力 | 通知、推送(PushKit)、后台任务、卡片刷新 | 会用 |
| 分布式 | 设备发现、流转、跨端迁移、协同 | 了解 |
| 工程 | HAR/HSP/HAP 的区别、ohpm 依赖、hvigor 构建 | 能讲清原理 |
| 质量 | 单元测试、UI 测试、DevEco Testing、Profiler | 会用 |
| 发布 | 签名与 Profile、AGC 上架、审核要点 | 能讲清原理 |
四、技术栈与常用框架
鸿蒙生态以官方能力为主,第三方库相对少,选型空间不大,重点是把官方 Kit 用对。
| 领域 | 首选 | 备选 | 选型说明 | 文档入口 |
|---|---|---|---|---|
| 语言 | ArkTS | TS(受限) | 必须用 ArkTS 写 UI 与业务 | HarmonyOS 文档 |
| UI | ArkUI | — | 唯一声明式 UI 框架 | 同上 |
| 状态 | 状态管理 V2 | V1 | 新项目用 V2,观察粒度更细 | 同上 |
| 路由 | Navigation | router(早期) | Navigation 支持栈管理与多设备 | 同上 |
| 数据库 | RelationalStore | Preferences、文件 | 结构化数据用 RDB,配置用 Preferences | 同上 |
| 网络 | NetworkKit(http) | 三方 HTTP 库 | 官方 http 模块够用,注意证书与超时 | 同上 |
| 序列化 | JSON 内置 | 三方 | 复杂模型建议显式转换 | 同上 |
| 图片 | Image 组件 + 官方图片能力 | 三方图片库 | 大图与长图注意采样与内存 | 同上 |
| 依赖管理 | ohpm | 本地 HAR | 官方包管理 | ohpm |
| 构建 | hvigor | — | 与 DevEco Studio 绑定 | 同上 |
| 推送 | PushKit | 厂商通道 | 需在 AGC 配置 | 同上 |
| 支付 | IAPKit | 三方支付 | 虚拟商品必须走 IAP | 同上 |
| 地图 | MapKit | 三方地图 | 国内可用 Petal Maps 能力 | 同上 |
| 账号 | AccountKit | 自建 | 华为账号一键登录 | 同上 |
| 测试 | 官方测试框架 + DevEco Testing | — | 真机兼容性测试很重要 | 同上 |
| 上架 | AppGallery Connect | — | 签名、审核、灰度发布 | AGC |
五、配套技术与系统 Kit
| 能力 | 对应 Kit / 方案 | 要掌握的部分 |
|---|---|---|
| 推送 | PushKit | 通知权限、令牌获取、服务端下发、到达率 |
| 账号 | AccountKit | 华为账号登录、静默授权、解绑 |
| 支付 | IAPKit | 商品配置、下单、校验、订阅 |
| 地图 | MapKit | 地图渲染、标记、路径规划、定位权限 |
| 扫码 | ScanKit | 码制识别、相机权限 |
| 相机 | CameraKit | 预览、拍照、录像、后台释放 |
| 媒体 | MediaKit / AVSession | 播放、后台播放、媒体控制中心 |
| 通知 | NotificationKit | 通道、分组、角标、点击跳转 |
| 卡片 | FormKit | 卡片布局、定时刷新、交互事件 |
| 元服务 | 元服务框架 | 免安装、卡片入口、服务闭环 |
| 分布式 | 分布式软总线 / 数据对象 | 设备发现、流转、跨端迁移 |
| 安全 | 系统安全能力 | 密钥库、加密、签名校验、隐私声明 |
六、架构模式与设计选型
鸿蒙没有像 Android 那样沉淀多年的官方架构模板,实践中常用三种组织方式:
| 模式 | 结构 | 适用 | 注意 |
|---|---|---|---|
| 页面直连 | 页面直接调网络与数据库 | 原型、单页工具 | 不可用于多人项目 |
| 分层(推荐) | 页面 → ViewModel/状态容器 → Service → Repository → 数据源 | 绝大多数应用 | 状态容器用 V2 装饰器,避免页面互相持有 |
| 模块化 HAR/HSP | 按业务域拆 HAR,公共能力下沉 | 多团队、多设备 | 注意 HAR 与 HSP 的打包与共享差异 |
三条纪律:
- 状态只在状态容器里改,页面通过装饰器观察,不要跨页面直接改对方状态。
- 能力调用统一收口:Kit 调用放在 Service 层,便于替换与在无权限时降级。
- 多设备适配从第一天做:用断点与栅格,不要等上平板才发现布局写死。
七、设计软件与工具链
| 用途 | 工具 | 说明 |
|---|---|---|
| 开发 IDE | DevEco Studio | 官方 IDE,含预览器、Profiler、签名工具 |
| 设计规范 | HarmonyOS Design | 组件、色彩、排版、多设备布局规范 |
| 设计稿 | Figma、MasterGo、即时设计 | 交付标注与资源 |
| 资源管理 | 资源目录 + 限定词 | 按语言、深浅色、屏幕形态组织 |
| 图标 | 系统图标库 + 自有 SVG | 注意多设备尺寸与安全区 |
| 调试 | HiLog、DevEco Profiler、hdc | 日志、性能、设备命令 |
| 测试 | DevEco Testing、真机云测 | 兼容性与稳定性 |
| 上架 | AppGallery Connect | 签名、审核、分阶段发布 |
| 命令行 | hdc、ohpm、hvigorw | CI 中构建与安装 |
八、官方文档与学习资源
鸿蒙资料更新快,只认官方文档,社区文章常落后一个版本:
- HarmonyOS 开发者文档总入口
- 工具下载(DevEco Studio 等)
- ArkTS 语言基础与约束(文档站「ArkTS」章节)
- ArkUI 组件与布局(文档站「ArkUI」章节)
- 状态管理 V1/V2(文档站「状态管理」章节)
- Stage 模型与 UIAbility(文档站「应用模型」章节)
- 数据管理(RelationalStore、Preferences、分布式数据)
- 网络与安全(NetworkKit、证书、权限)
- 卡片与元服务(FormKit、元服务开发)
- 性能与测试(DevEco Profiler、DevEco Testing)
- 上架与审核(AppGallery Connect 文档)
- OpenHarmony 社区(开源底座与设备开发)
九、出口验收
- [ ] 能用 ArkTS 写出符合静态约束的模块,不使用
any逃避类型。 - [ ] 能说清 V1 与 V2 状态管理的差异,并解释为什么 V2 刷新更精确。
- [ ] 能讲清 UIAbility 生命周期与 Want 启动流程,能实现显式与隐式跳转。
- [ ] 能用 Navigation 构建多级页面栈,并在平板/折叠屏上正确适配。
- [ ] 能用 RelationalStore 完成建表、查询、迁移与事务。
- [ ] 能接入推送、通知与卡片,并说明各自的限制与刷新机制。
- [ ] 能解释 HAR、HSP、HAP 的区别与使用场景。
- [ ] 能完成签名、打包与 AGC 上架流程。
- [ ] 能回答 07.1.3 HarmonyOS 与 07.7 鸿蒙深入 中的主要题目。
十、常见坑
| 现象 | 真实原因 | 纠正动作 |
|---|---|---|
| 编译报 ArkTS 约束错误 | 用了 any、动态属性、结构化类型赋值 |
显式声明类型,用类与接口建模 |
| 状态改了但 UI 不刷新 | 修改的是未被观察的字段,或层级过深 | 用 V2 的 @Trace 标记字段,减少嵌套 |
| 真机装不上 | 签名 Profile 与设备 UDID 不匹配 | 在 AGC 重新申请调试 Profile |
| 平板布局错乱 | 布局写死尺寸,未用断点与栅格 | 用响应式布局与资源限定词 |
| 卡片不刷新 | 刷新方式与频率不符合限制 | 用定时刷新或事件刷新,注意系统配额 |
| 分布式能力调不通 | 设备未登录同一账号或未开协同 | 检查账号、网络与权限声明 |