HarmonyOS NEXT启程：零基础构建纯血鸿蒙应用

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

丰富的实战案例基于和API设，免费提供案例源码，带你快速掌握开发方法与核心技巧

轻松上手鸿蒙系统，掌握纯血鸿蒙开发的核心技能。

基于HarmonyOS NEXT API 11进行系统讲解的技术图书。

通过系统的讲解和丰富的实例，引导读者逐步掌握HarmonyOS NEXT的开发精髓。

囊括基础知识，以及HarmonyOS元服务、工具技巧、ArkTS多线程和多设备适配等进阶技能。

第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

笔者从事移动开发工作多年，从最初在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应用发布的整体流程。

致谢

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

作者