这是一本以App产品开发全流程为主线、详细解读HarmonyOS NEXT基础知识和核心技术，并融入作者20年App开发经验的一线开发指导手册，书中还提供了一个可复用的大型综合性案例。作者是我国App开发领域的先行者，曾在百度负责多个App的技术架构构建，在2023年转战HarmonyOS NEXT开发，并基于HarmonyOS NEXT成功构建一个大型App，现已上架华为应用商店。本书呈现的就是作者从零学习HarmonyOS NEXT，并开发个人App的完整过程。 本书分为3篇，包括16章： 基础篇(第1～3章)用简洁明了的方式解读了HarmonyOS的基本概念、特性与价值，还介绍了开发环境配置与IDE使用。这部分是必须掌握的基础知识，也是后续开发应用的基础。 高级篇（第4～14章）以开发App为目标，对ArkTS语言、App框架、ArkUI框架、UI布局及交互、数据持久化、基础能力、网络通信、网页浏览、多媒体使用、安全管理、Module化及复用等多个核心技术进行深入解读。这部分不仅包含HarmonyOS NEXT前沿技术，还包括作者20年App开发经验。 项目实践篇（第15章和第16章）聚焦 App在华为应用商店的发布与管理，以一个完整的项目产品化过程为实例，将书中所讲知识融为一体并落地实践。这部分的目的是帮助打造功能完备、架构完整的应用，深刻理解HarmonyOS上的App开发方法。

你可以不用HarmonyOS，但是你不可以不懂HarmonyOS！虽然HarmonyOS的用户量还没有达到Android的级别，但是作为全球第三大操作系统的它的发展前景不可限量，尤其是在国产化的大背景下。即便你不是HarmonyOS相关的开发者，提前了解、学习，就等于赢在了起跑线。 如果你已经是或者即将成为HarmonyOS相关的开发者，那本书必将成为你的工具。仅通过这一本书，就可以让你零基础入门并快速成为HarmonyOS领域的高手。

前　　言为什么要写本书在2023年的华为开发者大会（HDC）上，华为正式推出HarmonyOS NEXT开发者预览版，之后我所在的团队（百度App搜索方向）成立了学习调研小组，作为其中的一员，我开启了HarmonyOS NEXT的学习之旅。经过一段时间的学习和实践，我深切体会到使用HarmonyOS开发App时的显著优势。例如：拥有丰富API，可助开发者快速实现各类功能；支持跨平台，能一次开发、多端部署，适配不同设备；生态环境开放，开发者可交流合作，共享资源；提供从设计、研发到发布的一体化工具链，使企业及个人开发者实现高效率开发。最值得一提的是，HarmonyOS NEXT是完全自研的操作系统。这体现了华为强大的技术实力和自主创新能力。自研的操作系统意味着开发者可以深入了解系统的底层架构，进行更优化的开发，充分发挥系统的性能优势。同时，自研的操作系统能更好地保障国家的信息安全和技术主权，为我国的科技发展注入强大动力，这也是操作系统级软件的发展趋势。2024年我从无到有，设计及实现了一款在HarmonyOS NEXT中运行的App，并在华为应用商店成功将其上架。在这个过程中，我遇到了诸多问题，通过不断地与华为开发者支持团队进行沟通和确认，最终得到有效的方案。因此，我决定写一本书，将我近二十年的App研发经验及在HarmonyOS中的实践分享给大家。读者对象本书以实践为主，重点介绍HarmonyOS NEXT的App研发的基础知识。无论你是独立开发者还是企业中的研发人员，无论你要研发超级App还是普通App，本书都将为你提供有价值的知识和实用的指导。本书特别适合以下人员阅读。新手开发者：刚刚接触鸿蒙开发领域，对HarmonyOS NEXT充满好奇，但缺乏相关知识和实践经验。本书可以作为入门指南，帮助新手开发者了解HarmonyOS NEXT的基本概念、开发环境的搭建、开发工具的使用等基础知识，为进一步实践打下坚实基础。有经验的移动开发者：熟悉Android或iOS开发，想要拓展自己的技术栈，并进入鸿蒙开发领域。本书可以帮助有经验的移动开发者快速掌握HarmonyOS NEXT的特有开发技术，实现从其他开发领域到鸿蒙开发领域的平滑过渡。行业从业者：对行业从业者而言，本书是基于HarmonyOS NEXT的App研发的实用宝典。本书全面涵盖了HarmonyOS NEXT的App研发所需的各项关键内容，从基础的开发环境配置，到App框架及生命周期管理，再到基本API的使用方法，均有细致入微的讲解。此外，本书还聚焦App上架环节，详细介绍了上架过程中所需的配置要点，并且以实际项目为载体，深入剖析可上架App应遵循的完整流程与规范，以助力开发者顺利将自己的App推向市场。本书特色我拥有多年移动研发经验，曾负责过多款重量级App的研发工作，具备在HarmonyOS NEXT中从0到1构建App并成功上架的实战经验。我将这些经验全部融入本书中，以下是本书的主要特色。产研思维：揭秘App从0到1的秘诀，涵盖关键技术、流程和标准。在技术方面，讲解实用开发工具与方法；在流程方面，明晰从构思到上线的具体操作；在标准方面，阐明功能、性能、安全等要求，助力读者打造可上架的App。实践导向：围绕基础App的构建来编排内容，让读者在实践中掌握知识。除了在讲解每项技术时进行实践外，最后还通过单独的一章以一个完整的App作为示例进行讲解。实例支撑：各个内容节点均配有实例，且在HarmonyOS NEXT（API 12）开发环境下成功运行，增强了实操性。模块独立：实例之间相互独立，可直接复用，方便读者灵活运用。内容完整：介绍、实现过程以及最终效果的呈现很完整，便于随时学习。本书内容本书共16章，分为三篇。基础篇（第1～3章）简要介绍HarmonyOS的基本概念、开发环境配置及DevEco Studio使用指南，帮助读者了解基础知识，为学习后续内容做铺垫。高级篇（第4～14章）根据构建一个App的基本需要，围绕ArkTS语言基础、App框架、ArkUI框架、UI布局及交互、数据持久化、基础能力、网络通信、网页浏览、多媒体使用、安全管理、Module化及复用，着重讲解构建App的基础技术及其在HarmonyOS NEXT中的实践。项目实践篇（第15章和第16章）重点介绍如何在华为应用市场中发布及管理App，以一个项目产品化的过程作为实践，将前两篇介绍的知识加以整合运用，打造一个功能完备、架构完整的项目。通过实际的项目构建过程，帮助读者深入理解各个知识点在鸿蒙App开发实践中的作用与具体实现。如果你之前有过HarmonyOS的研发经验，可以直接从高级篇开始阅读。但如果你是初学者或者仅有iOS或Android平台的研发经验，请一定从基础篇开始学习。获取本书配套源码在微信中搜索公众号“创心思考”，关注后回复“NEXT源码”即可获取本书源码下载地址。致谢首先，感谢百度这个平台，百度的良好技术氛围，使我得以较早地接触HarmonyOS NEXT的研发。其次，我要向华为在线工单处理团队、上线服务助手团队以及商务合作团队致以最诚挚的谢意。正是这些团队的专业支持与积极配合，使得本书内容更加丰富翔实、精准可靠，这为本书增添了不可或缺的价值。最后，衷心感谢我的妻子和女儿在我写书期间对我的理解与支持。她们一直站在我身后，给了我继续下去的动力。

刘俊启鸿蒙原生应用开发者、前百度资深研发工程师、百度App架构师、百度OC&Swift编码委员会主席、腾讯研发工程师。国内早期移动App研发人员，2005年入职盛大?数位红，参与Game-V（中国第一个无线游戏娱乐运营平台）的研发（NOKIA S60平台）。之后，作为初创团队成员，负责多款S60平台的App研发。2009年转战iOS平台，推进公司产品技术栈向iOS平台迁移。2010年入职百度，先后负责构建百度搜索App、百度语音SDK、百度语音助手App、百度浏览器App、Watch版百度App等多个产品的技术架构。多次负责掌上百度（百度App）技术架构的实现及升级工作。2023年转战HarmonyOS生态，现已从无到有构建了基于HarmonyOS NEXT的App，并成功在华为应用商店上线，且通过鸿蒙原生应用开发者激励计划的评审。

目　　录Contents前言基　础　篇第1章　概述　21.1　基本概念及关系　21.2　HarmonyOS的系统特性　31.2.1　硬件互助，资源共享　31.2.2　一次开发，多端部署　61.2.3　统一OS，弹性部署　71.3　学习HarmonyOS研发的意义　71.3.1　系统可控角度　81.3.2　生态角度　81.3.3　需求角度　91.3.4　发展趋势角度　101.3.5　收益角度　10第2章　开发环境配置　112.1　开发与上架App的主要步骤　112.2　成为开发者　122.3　安装DevEco Studio　122.3.1　Windows环境下安装　122.3.2　macOS环境下安装　132.4　安装HarmonyOS SDK　142.5　安装模拟器　152.6　验证开发环境　202.6.1　创建第一个鸿蒙App　202.6.2　工程配置　222.6.3　运行工程　232.6.4　常见问题及其解决方法　23第3章　DevEco Studio使用指南　303.1　DevEco Studio基本介绍　303.1.1　菜单区介绍　303.1.2　工具区介绍　313.1.3　工程区介绍　313.1.4　代码编辑区介绍　323.1.5　预览区介绍　323.1.6　通知区介绍　323.2　常用操作说明　323.2.1　文件操作　333.2.2　代码编写　363.2.3　运行调试　403.2.4　预览　43高　级　篇第4章　ArkTS语言基础　484.1　ArkTS 概述　484.1.1 ArkTS、TypeScript、JavaScript的关系　484.1.2　ArkTS 的优点　494.1.3　ArkTS 的学习建议　494.2　基本语法　504.2.1　基本元素　504.2.2　数据类型　524.2.3　运算符　564.2.4　控制语句　564.3　函数　614.3.1　函数声明　614.3.2　函数调用　624.3.3　可选参数　624.3.4　rest参数　624.3.5　返回类型　634.3.6　Lambda函数　634.3.7　闭包　644.3.8　函数重载　654.4　类　654.4.1　字段　664.4.2　方法　684.4.3　继承　704.4.4　构造函数　724.4.5　可见性修饰符　734.4.6　对象字面量　744.5　接口　744.5.1　接口实现　754.5.2　接口继承　754.6　空安全　764.6.1　非空断言运算符　764.6.2　空值合并运算符　774.6.3　可选链　774.7　模块　784.7.1　准备　784.7.2　模块导出　794.7.3　模块导入　80第5章　App框架详解　835.1　基本概念　835.1.1　应用模型　835.1.2　Module　835.1.3　Stage模型的基本概念　855.2　创建示例工程　875.2.1　项目工程组成介绍　885.2.2　AbilityStage简介　905.3　项目配置文件概述　935.3.1　App配置文件　935.3.2　Module配置文件　955.4　UIAbility及WindowStage简介　1005.4.1　UIAbility组件生命周期　1015.4.2　WindowStage及相关事件　1025.4.3　UIAbility的启动模式　1045.5　Context简介　1195.5.1　获取上下文　1195.5.2　Context的典型使用场景　1205.6　App生命周期事件概览　1245.6.1　启动App　1255.6.2　启动新的UIAbility　1265.6.3　退出启动的UIAbility　1275.6.4　退出App　128第6章　ArkUI框架详解　1296.1　简介　1296.1.1　ArkUI框架　1296.1.2　声明式开发范式　1306.1.3　声明式UI语法组成　1316.2　准备　1356.2.1　创建示例工程　1356.2.2　主体UI框架　1366.3　资源管理　 1376.3.1　资源分类　1376.3.2　创建资源目录和资源文件　1396.3.3　使用资源　1426.4　自定义组件　1456.4.1 自定义组件的分类及与页面的关系　1456.4.2　自定义组件的基本结构　1466.4.3 build()函数执行机制及限制规则　1496.4.4　使用自定义组件　1516.5　页面跳转及组件生命周期　1576.5.1　页面路由方式实现页面跳转　1576.5.2　Navigation组件　1676.5.3　生命周期　175第7章　UI布局及交互　1817.1　准备　1817.2　基础数据类型介绍　1817.2.1　像素　1817.2.2　Length类型　1877.3　构建布局　1877.3.1　布局结构　1877.3.2　选择布局组件　1907.3.3　基本布局组成　1917.3.4　布局约束　1937.3.5　布局位置　1987.4　构建交互　2027.4.1　事件响应　2037.4.2　手势处理　2127.5　状态管理　2247.5.1　@State（组件内状态）　2257.5.2 @State和@Prop（父子单向同步）　2267.5.3 @State和@Link（父子双向同步）　2287.5.4 @Provide和@Consume（多级双向同步）　2317.6　渲染控制　2367.6.1　条件渲染语句　2377.6.2　循环渲染语句　239第8章　数据持久化　2438.1　准备　2438.1.1　创建示例工程　2438.1.2　主体UI框架　2438.2　首选项数据存储　2468.2.1　约束原则　2468.2.2　接口说明　2478.2.3　开发实践　2478.3　键值数据库存储　2528.3.1　基本概念和约束原则　2528.3.2　接口说明　2548.3.3　开发实践　2548.4　关系数据库存储　2598.4.1　约束原则　2598.4.2　接口说明　2598.4.3　开发实践　2608.5　文件读写　2668.5.1　基本概念　2668.5.2　接口说明　 2678.5.3　开发实践　267第9章　基础能力　2739.1　准备　2739.1.1　创建示例工程　2739.1.2　主体UI框架　2739.2　剪贴板　2769.2.1　接口说明　2769.2.2　开发示例　2779.2.3　跨设备剪贴板的要求　2799.3　日志　2799.3.1　接口说明　2799.3.2　开发示例　2809.3.3　日志分析　2829.4　定时器　2889.4.1　setTimeout　2889.4.2　setInterval　2899.5　地理位置　2919.5.1　接口说明　2919.5.2　约束与限制　2919.5.3　开发示例　2949.6　公共事件　2999.6.1　接口说明　2999.6.2　使用示例　299第10章　网络通信　30410.1　准备　30410.1.1　创建示例工程　30410.1.2　增加网络权限　30410.1.3　主体UI框架　30610.2　HTTP数据请求　30810.2.1　http模块接口说明　30810.2.2 使用request接口进行数据通信　30810.2.3 使用requestInStream接口进行数据通信　30910.3　WebSocket连接　31110.3.1　webSocket模块接口说明　31210.3.2　webSocket通信示例　31210.4　Socket连接　31510.4.1　接口说明　31510.4.2　使用TCP进行通信　31610.4.3　使用UDP进行通信　31910.5　网络连接管理　32110.5.1　接口说明　32110.5.2 接收指定网络的状态变化通知　32310.5.3 主动获得系统激活的网络类型　325第11章　网页浏览　32711.1　准备　32711.1.1　创建示例工程　32711.1.2　增加网络权限　32711.1.3　主体UI框架　32911.2　使用Web组件加载网页　33111.2.1　加载远端网页　33211.2.2　加载本地网页　33211.2.3 加载HTML格式的文本数据　33311.3　管理网页跳转及浏览记录　导航　33411.3.1　历史记录导航　33511.3.2　网页刷新　33511.3.3　页面跳转　33511.3.4　跨应用跳转　33811.4　应用侧与网页的通信　33911.4.1 应用侧通过Java Script与网页通信　33911.4.2 网页调用应用侧实例方法　34211.4.3 建立应用侧与网页之间的数据通路　34511.5　默认UserAgent定义　349第12章　多媒体使用　35112.1　准备　35112.1.1　创建示例工程　35112.1.2　主体UI框架　35212.2　图像基础操作　35412.2.1　Image组件　35412.2.2　PixelMap　35612.2.3　图像操作示例　35912.3　选取照片及视频　36512.3.1　图库选择器　36512.3.2　相机选择器　36812.4　音频播放　37112.5　视频播放　38212.5.1　Video组件播放视频　38212.5.2　AVPlayer播放视频　386第13章　安全管理　39713.1　准备　39713.1.1　创建示例工程　39713.1.2　主体UI框架　39813.2　用户资产保护　39913.2.1　应用沙盒　39913.2.2　应用权限管控　40013.2.3　安全访问机制　41313.2.4　隐私保护　41813.3　研发资产保护　42013.3.1　代码混淆　42013.3.2　应用加密　427第14章　Module化及复用　42814.1　准备　42814.1.1　创建示例工程　42814.1.2　主体UI框架　42814.2　Feature类型的Module　43114.2.1 约束限制　43114.2.2 Feature类型Module的基本使用　43114.2.3　开发　43414.2.4　调试　43614.3　Static Library类型的Module　 43614.3.1　约束限制　43614.3.2 Static Library类型Module的基本使用　43614.3.3　开发　43914.3.4 调试Static Library类型的Module　 45114.4　Share Library类型的Module　45114.4.1　约束限制　45114.4.2 创建Share Library类型的Module　45114.4.3　开发　45414.4.4 调试Share Library类型的Module　46414.5　App组成及程序包概览　46414.5.1　开发态App结构　46514.5.2　编译态App结构　46514.5.3　发布态包结构　466项目实践篇第15章　App发布与管理　47015.1　真机调试及打包配置　 47015.1.1　准备　47115.1.2　配置真机调试环境　47715.1.3　配置发布打包环境　48315.2　发布HarmonyOS应用　48515.2.1　创建应用　48515.2.2　配置应用信息　48715.2.3　配置版本信息　490第16章　项目实践　50416.1　项目介绍　50416.2　页面关系及实现　50616.2.1　根页面实现　50716.2.2　待办页面实现　50916.2.3　记录页面实现　51316.2.4　设置页面实现　52216.2.5　任务配置页面实现　52616.3　基础能力介绍及实现　53216.3.1　基础数据类型　53216.3.2　基础工具类　53516.3.3　通用管理类　53916.3.4　特定管理类　54116.4　配置及资源　54916.4.1　配置　54916.4.2　资源文件　550