店 HarmonyOS NEXT启程 零基础构建纯血鸿蒙应用 HarmonyOS NEXT开发教程 ArkTS和Ark

111

HarmonyOS NEXT操作系统被誉为“纯血鸿蒙”，是操作系统领域的重大突破。该系统采用全新的底层架构和API，为*发者带来了全新的机遇和挑战。

《HarmonyOS NEXT启程：零基础构建纯血鸿蒙应用》从初学者的角度出发，通过系统的讲解和丰富的实例，引导读者逐步掌握HarmonyOS NEXT的开发精髓。本书首先介绍HarmonyOS的背景知识，讲解如何配置环境，运行*一个HelloWorld项目程序。然后讲解HarmonyOS开发的核心技能，包括ArkTS和ArkUI，帮助读者完成一个简单的应用。之后着重讲解UIAbility、网络、数据、多媒体等内容，以丰富应用功能。此外，本书提供进阶知识，如HarmonyOS元服务、工具技巧、ArkTS多线程和多设备适配。*后通过开发一个综合性的App，将所讲知识融会贯通。

无论是初入HarmonyOS开发领域的新手，还是已经有一定开发经验的*发者，抑或希望深入了解HarmonyOS内部原理的*级*发者，都将从中获得有价值的参考和指导。

第1章  初识HarmonyOS，开启探索之旅  / 1

1.1  HarmonyOS简介  / 1

1.1.1  HarmonyOS系统  / 2

1.1.2  HarmonyOS系统架构  / 2

1.1.3  HarmonyOS应用  / 4

1.2  一览应用包组成  / 4

1.2.1  应用包组成  / 4

1.2.2  应用包开发调试与发布部署流程  / 5

1.3  开始运行*一行HarmonyOS代码  / 6

1.3.1  环境搭建  / 6

1.3.2  运行HarmonyOS项目  / 7

1.3.3  HarmonyOS项目结构分析  / 12

1.4  本章小结  / 14

第2章  ArkTS语言快速入门  / 15

2.1  什么是ArkTS  / 15

2.1.1  ArkTS简介  / 15

2.1.2  ArkTS与TypeScript、JavaScript的不同  / 16

2.2  基本数据类型  / 16

2.2.1  布尔值  / 16

2.2.2  数字  / 17

2.2.3  字符串  / 18

2.2.4  数组  / 19

2.2.5  枚举  / 19

2.2.6  对象  / 20

2.2.7  空值  / 22

2.2.8  联合类型  / 22

2.2.9  类型别名  / 23

2.2.10  其他类型  / 23

2.3  变量  / 25

2.3.1  声明  / 25

2.3.2  运算符  / 26

2.3.3  Null与Undefined  / 26

2.4  接口  / 27

2.4.1  接口声明  / 27

2.4.2  接口属性  / 28

2.4.3  接口继承  / 29

2.5  函数  / 29

2.5.1  函数声明  / 29

2.5.2  可选参数  / 30

2.5.3  剩余参数  / 30

2.5.4  函数类型  / 31

2.5.5  箭头函数  / 31

2.5.6  闭包  / 31

2.6  类  / 32

2.6.1  类声明  / 32

2.6.2  字段  / 33

2.6.3  字段初始化  / 34

2.6.4  存取器  / 34

2.6.5  继承  / 35

2.6.6  方法重载  / 36

2.6.7  对象字面量  / 36

2.7  泛型类型  / 37

2.8  空安全  / 37

2.8.1  非空断言运算符  / 38

2.8.2  空值合并运算符  / 38

2.8.3  可选链  / 38

2.9  模块  / 39

2.9.1  导出  / 39

2.9.2  导入  / 39

2.10  JSON  / 40

2.11  其他问题  / 41

2.11.1  interface与class的区别  / 41

2.11.2  TypeScript写单例  / 41

2.12  本章小结  / 42

第3章  打造精美界面  / 43

3.1  ArkUI简介  / 43

3.2  ArkUI基本语法  / 43

3.2.1  ArkUI语法结构  / 43

3.2.2  状态变量  / 45

3.2.3  自定义构建函数  / 46

3.2.4  渲染控制  / 47

3.3  自定义组件及页面生命周期  / 49

3.4  布局  / 52

3.4.1  布局概述  / 52

3.4.2  线性布局  / 53

3.4.3  层叠布局  / 56

3.4.4  相对布局  / 57

3.4.5  列表  / 58

3.5  页面路由  / 61

3.5.1  页面跳转  / 61

3.5.2  页面返回  / 63

3.6  本章小结  / 63

第4章  深入探究UIAbility  / 64

4.1  UIAbility概述  / 64

4.1.1  Stage模型概述  / 64

4.1.2  UIAbility声明配置  / 65

4.2  UIAbility生命周期  / 66

4.2.1  Create状态  / 66

4.2.2  WindowStageCreate和WindowStageDestroy状态  / 67

4.2.3  Foreground和Background状态  / 68

4.2.4  Destroy状态  / 69

4.3  UIAbility间交互  / 69

4.3.1  启动应用内的UIAbility  / 69

4.3.2  启动应用内的UIAbility并获取返回结果  / 72

4.3.3  启动其他应用的UIAbility  / 73

4.4  UIAbility启动模式  / 75

4.4.1  singleton启动模式  / 75

4.4.2  multiton启动模式  / 75

4.4.3  specified启动模式  / 76

4.5  使用EventHub进行数据通信  / 78

4.6  本章小结  / 79

第5章  网络技术应用  / 80

5.1  Web组件的用法  / 80

5.1.1  加载网络HTML链接  / 80

5.1.2  加载本地网页  / 81

5.1.3  Web和JavaScript交互  / 82

5.1.4  处理页面导航  / 85

5.1.5  拦截页面内请求  / 87

5.1.6  设置和获取cookie  / 88

5.2  使用HTTP访问网络  / 89

5.2.1  使用http模块  / 89

5.2.2  简单热榜示例  / 92

5.2.3  使用WebSocket  / 97

5.3  可用的网络库：axios  / 99

5.3.1  axios的基本用法  / 99

5.3.2  实战：使用axios重构简单热榜列表  / 100

5.4  本章小结  / 101

第6章  数据持久化技术详解  / 102

6.1  应用沙箱  / 102

6.1.1  应用文件目录  / 102

6.1.2  获取应用文件目录  / 105

6.2  数据持久化  / 107

6.2.1  普通文件存储  / 107

6.2.2  用户*选项  / 109

6.2.3  键值型数据库  / 114

6.2.4  关系数据库  / 119

6.3  本章小结  / 125

第7章  熟练运用手机多媒体  / 126

7.1  多媒体系统架构  / 126

7.2  音频  / 127

7.2.1  音频播放开发概述  / 127

7.2.2  使用AVPlayer播放音频  / 128

7.2.3  使用AudioRenderer播放音频  / 132

7.2.4  使用SoundPool播放音频  / 134

7.2.5  音频录制概述  / 136

7.2.6  使用AVRecorder录制音频  / 136

7.2.7  使用AudioCapturer录制音频  / 138

7.3  视频  / 140

7.3.1  视频播放开发概述  / 140

7.3.2  使用AVPlayer播放视频  / 140

7.3.3  使用Video组件播放视频  / 145

7.3.4  使用AVRecorder录制视频  / 148

7.4  相机  / 151

7.4.1  相机开发概述  / 151

7.4.2  预览  / 154

7.4.3  拍照  / 155

7.5  图片  / 157

7.5.1  图片开发概述  / 157

7.5.2  图片解码  / 158

7.5.3  图片编码  / 158

7.5.4  图像变换  / 159

7.6  媒体文件管理  / 162

7.6.1  媒体文件管理概述  / 162

7.6.2  查询和更新用户相册资源  / 162

7.6.3  查询系统相册资源  / 163

7.7  本章小结  / 164

第8章  HarmonyOS元服务

开发与应用  / 165

8.1  元服务  / 165

8.1.1  创建一个元服务项目  / 166

8.1.2  如何在桌面添加元服务  / 169

8.1.3  元服务基础知识  / 171

8.2  服务卡片  / 173

8.2.1  服务卡片的基础架构  / 173

8.2.2  服务卡片的开发方式  / 174

8.2.3  静态卡片和动态卡片  / 175

8.2.4  如何通过IDE创建一个服务卡片  / 176

8.3  服务卡片的生命周期与应用  / 179

8.3.1  生命周期  / 179

8.3.2  extensionAbilities配置  / 181

8.3.3  卡片相关的配置文件  / 182

8.3.4  手动触发下一次更新时间  / 183

8.3.5  数据操作  / 184

8.3.6  举例  / 185

8.4  服务卡片的交互与应用  / 187

8.4.1  action为router  / 188

8.4.2  action为message  / 192

8.4.3  action为call  / 194

8.5  编写一个待办列表  / 197

8.5.1  目录结构  / 197

8.5.2  首页  / 198

8.5.3  服务卡片  / 200

8.5.4  数据操作类  / 203

8.6  本章小结  / 206

第9章  DevEco Studio调试技巧  / 207

9.1  一些*备的基础知识  / 207

9.1.1  HAP的安装流程  / 207

9.1.2  HDC简介  / 208

9.2  代码断点调试  / 209

9.2.1  添加和管理断点  / 209

9.2.2  启动调试  / 211

9.2.3  ArkUI逻辑调试  / 214

9.2.4  C/C++调试  / 218

9.3  使用ArkUI Inspector调试UI布局信息  / 222

9.4  WebView的调试  / 224

9.5  查看日志  / 225

9.5.1  HiLog  / 227

9.5.2  FaultLog  / 229

9.6  性能监测  / 230

9.7  常用的快捷键  / 233

9.8  本章小结  / 234

第10章  ArkTS多线程开发概览  / 235

10.1  ArkTS线程模型的特点  / 235

10.1.1  ArkTS线程模型的特点和比较  / 235

10.1.2  ArkTS线程设计的优缺点  / 237

10.2  ArkTS多线程开发的注意点  / 238

10.2.1  线程同步方式  / 239

10.2.2  线程数据传输方式  / 240

10.2.3  如何让代码在子线程上运行  / 241

10.2.4  使用@Concurrent和@Sendable时对闭包和ES module的限制  / 241

10.2.5  使用@ohos.taskpool时运行环境的初始化问题  / 244

10.2.6  使用@ohos.taskpool时运行环境的清理问题  / 247

10.2.7  如何跨VM传输function和class  / 248

10.3  异步 API 的使用  / 253

10.3.1  await 和 Promise的使用  / 253

10.3.2  await和Promise的实现  / 257

10.3.3  用同步API还是异步API  / 258

10.4  本章小结  / 261

第11章  自由流转，让应用无处不在  / 262

11.1  什么是自由流转  / 262

11.1.1  跨端迁移  / 262

11.1.2  多端协同  / 262

11.1.3  HarmonyOS 可实现的流转场景  / 263

11.2  服务互通  / 263

11.2.1  设备限制和使用限制  / 263

11.2.2  核心API  / 263

11.3  应用接续  / 266

11.3.1  工作机制与流程  / 266

11.3.2  设备限制与使用限制  / 267

11.3.3  核心API  / 267

11.3.4  应用接续开发流程  / 268

11.3.5  迁移功能可选配置  / 271

11.3.6  应用接续的注意事项  / 272

11.4  媒体播控  / 272

11.4.1  HarmonyOS 媒体播控的基本概念  / 273

11.4.2  工作机制与流程  / 273

11.4.3  设备限制与使用限制  / 274

11.4.4  核心API  / 274

11.4.5  开发步骤及示例代码  / 275

11.5  跨设备拖曳和剪贴板  / 279

11.5.1  运作机制  / 279

11.5.2  设备限制与使用限制  / 280

11.5.3  开发指导  / 281

11.6  本章小结  / 283

第12章  一次开发，多端部署  / 284

12.1  HarmonyOS多设备适配简介  / 284

12.2  开发前的工作  / 284

12.3 “一多”工程配置  / 285

12.3.1  目录结构调整  / 285

12.3.2  模块配置调整  / 288

12.4 “一多”页面布局开发  / 290

12.4.1  自适应布局  / 290

12.4.2  响应式布局  / 296

12.5  多设备功能适配  / 306

12.5.1  系统能力适配  / 306

12.5.2  应用尺寸限制和适配  / 308

12.6  本章小结  / 309

第13章  打造多层级Tab信息流App  / 310

13.1  项目设计  / 310

13.1.1  功能与界面设计  / 310

13.1.2  架构设计  / 310

13.2  一级Tab实现  / 312

13.3  二级Tab实现  / 313

13.4  信息流  / 315

13.4.1  信息流模板实现  / 316

13.4.2  信息流单击事件处理  / 325

13.4.3  信息流内容页实现  / 326

13.5  信息流数据的网络请求和处理  / 328

13.6  本章小结  / 332

第14章  HarmonyOS应用发布  / 333

14.1  HarmonyOS应用发布整体流程  / 333

14.2  准备签名文件  / 334

14.2.1  生成密钥和证书请求文件  / 334

14.2.2  创建AGC项目  / 336

14.2.3  创建HarmonyOS应用  / 337

14.2.4  申请发布证书  / 338

14.2.5  申请发布Profile文件  / 340

14.3  配置构建App  / 341

14.3.1  配置签名信息  / 341

14.3.2  编译构建App  / 343

14.4  上架应用市场  / 343

14.5  本章小结  / 348

KFive启程小组是一个充满探索精神和创新活力的开发小组，小组成员都是热衷于技术探索和实践的年轻*发者。每一位*发者既具备扎实的技术功底，又不拘泥于传统思维，且乐于挑战和尝试新的技术工具和开发模式。纯血鸿蒙开放给*发者之后，小组成员*一时间进行工程实践，将经验沉淀下来汇聚到了这本书中。希望通过这本书，帮助更多的技术爱好者轻松上手鸿蒙系统，掌握纯血鸿蒙开发的核心技能，推动这一新技术在更广泛的领域内实现应用和普及。

1

1

前言

笔者从事移动开发工作多年，从*初在Symbian系统上编写小游戏，到从事Android、iOS开发，再到利用前端技术进行跨平台开发，每一次转变都见证了一个又一个奇迹诞生。自华为2019年发布的HarmonyOS到2023年发布的HarmonyOS 4，均兼容Android系统。到了2024年，HarmonyOS NEXT*次亮相，引起了广泛关注。它不仅因其创新性而备受瞩目，更因其与Android系统的不兼容性而备受期待。这款全新的操作系统不仅承载着华为对未来智能设备生态的愿景，还挑战着*发者的传统思维模式。笔者在适配和开发过程中经历的挑战和学习不*限于技术层面，更多的是如何在新系统中找到创新的机会。

在这样的背景下，笔者决定将自己在探索和掌握这个全新操作系统过程中的心得体会以及遇到问题的解决方法，通过本书分享给广大*发者。

目前，本书是国内*本基于HarmonyOS NEXT API 11进行系统讲解的技术图书。希望各位读者在阅读本书的过程中，能够积极思考、勇于实践，不断探索HarmonyOS的奥秘，将自己的想法和创意转化为实实在在的应用成果。

本书读者对象

无论是初入HarmonyOS开发领域的新手，还是已经有一定开发经验的*发者，抑或希望深入了解HarmonyOS内部原理的*级*发者，都将从中获得有价值的参考和指导。在开始阅读本书之前，如果你从未涉足移动端开发领域，那么建议先了解JavaScript语言。因为本书是使用ArkTS语言进行开发的，ArkTS是基于JavaScript的一门语言。如果对JavaScript有所了解，将会非常有助于学习本书的内容。如果你之前从事过大前端的开发工作，不管是iOS、Android还是前端开发，那么在阅读过程中都会感到很熟悉，因为很多设计模块的开发过程都是相通的。如果你之前已经了解HarmonyOS，那么本书提供的*新API应用的知识会让你对HarmonyOS的认识更进一步。此外，本书还提供了很多进阶内容，相信一些*深*发者看过之后会有新的启发。

本书主要内容

本书的内容设计从易到难，适合不同阶段的读者学习，既适合初学者，也为有经验的*发者提供了丰富的技术参考和实战经验。第1章介绍了HarmonyOS的发展历史，讲解了系统的整体架构以及如何配置环境，如何运行*一个HelloWorld项目程序。第2~4章讲解了HarmonyOS开发的核心技能，包括ArkTS的一些基础知识，如类、变量、接口、函数等，以及如何使用ArkUI进行界面开发、组件的生命周期，帮助读者完成一个简单的应用，之后介绍的UIAbility可帮助读者理解组件之间的交互。第5~7章主要针对网络、数据、多媒体等内容进行了深入讲解，利用数据存储和网络来丰富应用功能。第8~12章提供了一些进阶知识，如HarmonyOS元服务、工具技巧、ArkTS多线程和多设备适配，辅助读者深入理解HarmonyOS开发方法。第13章是实战部分，通过开发一个综合性的App，将所讲知识融会贯通。第14章介绍了HarmonyOS应用发布的整体流程。

致谢

本书在写作过程中得到了多位一线开发人员的支持，尤其感谢董伟平在全书出版过程中做出的努力，感谢袁国正、陈松、樊帅飞、邓燕周、潘铭、杨梅、赵聪等在开发过程中把经验及时沉淀和分享，让本书的广度和深度都得以完善。

 

作  者

1