一、基本概念解析
新版文档中的知识点,介绍更全面,逻辑更清晰,提供了各类基本概念解析,帮助开发者更快学习、掌握系统能力。以下是新版文档部分概念展示。
1、HAP是什么?
开发者通过DevEco Studio把应用程序编译为一个或者多个.hap后缀的文件,即HAP(Harmony Ability Package)。HAP是HarmonyOS应用安装的基本单位,包含了编译后的代码、资源、三方库及配置文件。HAP可分为Entry和Feature两种类型。
1)Entry类型的HAP:是应用的主模块,在module.json5中的type属性配置为entry类型。在同一个应用中,同一设备类型只支持一个Entry类型的HAP,通常用于实现应用的入口界面、入口图标、主特性功能等。
2)Feature类型的HAP:是应用的动态特性模块,在module.json5中的type属性配置为feature类型。一个应用程序包可以包含一个或多个Feature类型的HAP,也可以不包含;Feature类型的HAP通常用于实现应用的特性功能,可以配置成按需下载安装,也可以配置成随Entry类型的HAP一起下载安装(请参见module对象内部结构中的“deliveryWithInstall”)。
2、Module是什么?
在DevEco Studio工程目录中,一个HAP对应一个Module。
Module是指DevEco Studio工程中的功能单元。一个DevEco Studio工程可以包含多个Module,同时Module分为“Ability”、“Library”两种类型。此处的HAP对应“Ability”类型的Module;下文即将介绍的HAR(Harmony Ability Resources)包对应“Library”类型的Module。
3、Bundle是什么?
每个HarmonyOS应用可以包含多个.hap文件,这些.hap文件合在一起称为一个Bundle,每个应用都有一个BundleName。在每台设备上,已安装应用的BundleName是唯一的。需要特别说明的是:在应用上架到应用市场时,需要把应用包含的所有.hap文件(即Bundle)打包为一个.app后缀的文件用于上架,这个.app文件称为App Pack(Application Package),其中同时包含了描述App Pack属性的pack.info文件;但是,在云端分发和端侧安装时,都是以HAP为单位进行分发和安装的。
4、Ability组件概述
Ability组件是一种包含用户界面的应用组件,用于与用户交互。Ability组件是系统调度的基本单元,为应用提供绘制界面的窗口;一个Ability组件中可以通过多个页面来实现一个模块功能。
建议将不同模块功能拆解为不同的Ability组件单独实现,即将一个独立的功能模块放到一个Ability组件中,以多页面的形式呈现。每一个Ability组件实例,都对应于一个任务,可以在最近任务列表中呈现。
在开发态,一个Module可以包含一个或多个Ability组件,如下图所示。
二、原理机制解读
必要的原理、机制解读,让开发者“知其然,知其所以然”。
为让大家更好的理解系统工作原理,我们使用举例、图文结合等方式来详细解读原理机制。接下来,我们以Ability组件启动模式—specified为例进行介绍。
specified(指定实例模式),在Ability实例创建之前,允许开发者为该实例创建一个唯一的字符串Key,创建的Ability实例绑定Key之后,后续每次调用startAbility()方法时,都会询问应用使用哪个Key对应的Ability实例来响应startAbility请求。运行时由Ability内部业务决定是否创建多实例,如果匹配有该Ability实例的Key,则直接拉起与之绑定的Ability实例,否则创建一个新的Ability实例。
例如用户在应用中重复打开同一个文档时,启动的均是最近任务列表中的同一个任务。以及在应用中重复新建文档时,启动的均是最近任务列表中新的任务。这种情况下可以将Ability配置为specified(指定实例模式)。
三、场景化开发指导
本次还补充/完善了20+个开发场景指导,只为让文档更贴近实际开发活动,助力开发者高效开发。以下为部分场景展示。
1、如何实现Ability组件与UI数据同步
本次按场景提供了具体的开发指导,主要包括:
使用EventHub进行数据通信:EventHub提供了Ability组件/ExtensionAbility组件级别的事件机制,以Ability组件/ExtensionAbility组件为中心提供了订阅、取消订阅和触发事件的数据通信能力。
使用globalThis进行数据同步:globalThis是ArkTS引擎实例内部的一个全局对象,引擎实例下的Ability/Page都可以使用,因此可以使用globalThis全局对象进行数据同步。
2、跨Ability组件跳转
详细的场景化开发指导,主要包括:
启动应用内的Ability:当一个应用内包含多个Ability时,存在应用内启动Ability的场景。
启动应用内的Ability并获取返回结果:在一个EntryAbility启动另外一个FuncAbility时,希望在被启动的FuncAbility完成相关业务后,能将结果返回给调用方。例如在应用中将入口功能和帐号登录功能分别设计为两个独立的Ability,在帐号登录Ability中完成登录操作后,需要将登录的结果返回给入口Ability。
启动其他应用的Ability:启动其他应用的Ability,通常用户只需要完成一个通用的操作(例如需要选择一个文档应用来查看某个文档的内容信息),推荐使用隐式Want启动。系统会根据调用方的want参数来识别和启动匹配到的应用Ability。
启动其他应用的Ability并获取返回结果:当使用隐式Want启动其他应用的Ability并希望获取返回结果时,调用方需要使用startAbility-ForResult()方法启动目标Ability。
启动Ability的指定页面:一个Ability可以对应多个页面,在不同的场景下启动该Ability时需要展示不同的页面,例如从一个Ability的页面中启动另外一个Ability时,希望启动该Ability的指定页面。本文主要讲解目标Ability首次启动和目标Ability非首次启动两种启动指定页面的场景,以及在讲解启动指定页面之前会讲解到在调用方如何指定启动页面。