这篇是「鸿蒙心迹」的第 0 篇——放在最前面,用来回答三个问题:这套东西是什么、写给谁看、凭什么值得你花时间读。

一句话概括:这是一套 12 篇的鸿蒙开发实战专栏,覆盖从「多形态适配」到「性能优化」再到「上架复盘」的完整链路。它和市面上大多数鸿蒙教程最大的区别是——文中的每一段 ArkTS 代码,都不是从文档复制粘贴的,而是在一个真实工程里用 hvigor 命令行跑出 BUILD SUCCESSFUL 之后才写进去的。


一、我的「鸿蒙心迹」

我是从去年开始接触鸿蒙开发的,得益于华为完善的文档、教程体系和AI技术的快速发展,我觉得我上手还是蛮快的。「心迹」两个字,我想表达的是「一个开发者在鸿蒙生态里真实走过的路径」。鸿蒙开发的门槛不在语法,而在工程事实:很多坑,官方文档写了但你不会主动去读;很多 API,签名是对的、行为却是反直觉的;很多「看起来能编译」的写法,跑起来才暴露问题。这些只有真正建一个工程、每段代码过一遍编译器、再上真机验证,才能变成自己的肌肉记忆。这套专栏,就是我把这个过程里踩过的坑、验证过的结论,一条条记下来的产物。


二、写给谁看

  • 正在上手鸿蒙的开发者:想少走弯路,直接拿到「验证过能跑」的代码和「反直觉」结论。
  • 做过 Android/iOS、想快速迁移的人:想搞清楚 ArkTS 和 TypeScript/Java 到底差在哪,状态管理、布局、多线程的对应关系。
  • 要上架的团队:需要一份权限、签名、审核的可复用 Checklist。

三、12 篇总目录

篇主题一句话价值
1折叠屏/平板多形态适配断点 + 媒体查询 + 栅格,一套 UI 应对所有屏幕
2三方库/har/hsp 接入与封装本地依赖、多模块工程的正确姿势
3上架审核避坑权限 reason/usedScene、隐私政策是驳回重灾区
4ArkTS 与 TypeScript 的差异禁 any、禁 untyped 对象字面量,实测错误码
5ArkUI 状态管理实战@State/@Link/@Provide 的边界与反直觉坑
6平行视界与大屏分栏应用级 Navigation/SideBarContainer 分栏,600vp 为界
7多设备流转与分布式数据distributedDataObject 的正确用法与权限
8网络请求与数据持久化@kit.NetworkKit 的 http + @kit.ArkData 的 Preferences/RDB
9性能优化:列表/内存/启动LazyForEach + @Reusable,刷新范围最小化
10性能优化:图片解码sampleSize 降采样 + @Builder 传参刷新方向
11多线程 TaskPool@Concurrent 三条硬约束 + taskpool.execute
12全流程复盘与上线 Checklist把 11 篇串成一条「从 0 到上架」的时间线

四、读它的方式

不必从头到尾按顺序读,按你的处境挑入口:

  • 要上架 / 刚立项 → 先读第 12 篇(全流程 + Checklist),再按 Checklist 逐项补第 3、2、1 篇。
  • 卡在语法/状态 → 读第 4、5 篇,这两个是「反直觉坑」最密集的地方。
  • 卡在卡顿/内存 → 读第 9、10、11 篇,性能三连。
  • 做大屏/折叠屏 → 读第 1、6 篇。

每一篇都独立成文,不依赖前文,你可以把它当工具书,遇到问题翻对应那篇。


五、一个必须提前说明的标准

这是这套专栏的「底线」,也请你在读之前知道:

  1. 代码真实构建:文中每段可运行代码,都写进了本地三模块工程 harmony_lib_demo(entry + 本地 har + 本地 hsp),用 hvigor 命令行 assembleHap 跑出 BUILD SUCCESSFUL 才定稿。
  2. 踩坑是实测的:错误码、废弃 API 告警、编译报错,都是从构建日志里真实抓出来的,不是「猜测会报错」。
  3. 边界如实标注:凡是需要真机/双设备/联网才能验证的(性能数值、分布式同步、联网请求),我都明确写「单机只验证编译,未伪造数据」。不把理论值包装成实测值。

六、最后

十二篇写下来,我最深的体会是:鸿蒙生态还年轻,靠谱的实战内容比 API 罗列稀缺得多。 这套专栏如果能帮你在某个深夜少踩一个坑、少一次反复重编译,它也就有了它的价值。
欢迎从第 1 篇开始读,也欢迎把你在鸿蒙里踩过的坑告诉我——也许它们会变成这个系列的续篇。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐