文章目录
- 一、前言
- 二、应用与应用程序包
- 三、应用的多Module设计机制
- 四、 Module类型
- 五、Stage模型应用程序包结构
- 六、拓展阅读
一、前言
在应用模型章节,可以看到主推的Stage模型中,多个应用组件共享同一个ArkTS引擎实例;应用组件之间可以方便的共享对象和状态,同时减少复杂应用运行对内存的占用。
二、应用与应用程序包
用户应用程序泛指运行在设备的操作系统之上,为用户提供特定服务的程序,简称“应用”。一个应用所对应的软件包文件,称为“应用程序包”。
当前系统提供了应用程序包开发、安装、查询、更新、卸载的管理机制,便于开发者开发和管理应用。同时,系统还屏蔽了不同的芯片平台的差异(包括x86/ARM,32位/64位等),应用程序包在不同的芯片平台都能够安装运行,这使得开发者可以聚焦于应用的功能实现。
三、应用的多Module设计机制
-
支持模块化开发: 一个应用通常会包含多种功能,将不同的功能特性按模块来划分和管理是一种良好的设计方式。在开发过程中,可以将每个功能模块作为一个独立的Module进行开发,Module中可以包含源代码、资源文件、第三方库、配置文件等,每一个Module可以独立编译,实现特定的功能。这种模块化、松耦合的应用管理方式有助于应用的开发、维护与扩展。
-
支持多设备适配: 一个应用往往需要适配多种设备类型,在采用多Module设计的应用中,每个Module都会标注所支持的设备类型。有些Module支持全部类型的设备,有些Module只支持某一种或几种类型的设备(比如平板),那么在应用市场分发应用包时,也能够根据设备类型做精准的筛选和匹配,从而将不同的包合理的组合和部署到对应的设备上。
四、 Module类型
Module按照使用场景可以分为两种类型:
Ability
类型的Module: 用于实现应用的功能和特性。每一个Ability
类型的Module编译后,会生成一个以.hap
为后缀的文件,称其为HAP(Harmony Ability Package
)包。HAP包可以独立安装和运行,是应用安装的基本单位,一个应用中可以包含一个或多个HAP包,具体包含如下两种类型。
entry
类型的Module:应用的主模块,包含应用的入口界面、入口图标和主功能特性,编译后生成entry类型的HAP。每一个应用分发到同一类型设备上的应用程序包,只能包含唯一一个entry类型的HAP,也可以不包含。feature
类型的Module:应用的动态特性模块,编译后生成feature类型的HAP。一个应用中可以包含一个或多个feature类型的HAP,也可以不包含。
Library
类型的Module: 用于实现代码和资源的共享。同一个Library类型的Module可以被其他的Module多次引用,合理地使用该类型的Module,能够降低开发和维护成本。Library类型的Module分为Static
和Shared
两种类型,编译后会生成共享包。
Static Library
:静态共享库。编译后会生成一个以.har
为后缀的文件,即静态共享包HAR(Harmony Archive
)。Shared Library
:动态共享库。编译后会生成一个以.hsp
为后缀的文件,即动态共享包HSP(Harmony Shared Package
)。
说明⚠️:实际上,Shared Library
编译后除了会生成一个.hsp
文件,还会生成一个.har
文件。这个.har
文件中包含了HSP对外导出的接口,应用中的其他模块需要通过.har
文件来引用HSP的功能。为了表述方便,我们通常认为Shared Library编译后生成HSP。
HAR与HSP两种共享包的主要区别体现在:
五、Stage模型应用程序包结构
开发态包结构如下:
工程结构主要包含的文件类型及用途如下:
不同类型的Module编译后会生成对应的HAP、HAR、HSP等文件,开发态视图与编译态视图的对照关系如下:
从开发态到编译态,Module中的文件会发生如下变更:
- ets目录:ArkTS源码编译生成
.abc
文件。 - resources目录:AppScope目录下的资源文件会合入到Module下面资源目录中,如果两个目录下存在重名文件,编译打包后只会保留AppScope目录下的资源文件。
- module配置文件:AppScope目录下的
app.json5
文件字段会合入到Module下面的module.json5
文件之中,编译后生成HAP或HSP最终的module.json
文件。
说明⚠️:在编译HAP和HSP时,会把他们所依赖的HAR直接编译到HAP和HSP中。
每个应用中至少包含一个.hap
文件,可能包含若干个.hsp
文件、也可能不含,一个应用中的所有.hap
与.hsp
文件合在一起称为Bundle
,其对应的bundleName
是应用的唯一标识(详见app.json5
配置文件中的bundleName
标签)。
当应用发布上架到应用市场时,需要将Bundle打包为一个.app
后缀的文件用于上架,这个.app
文件称为App Pack(Application Package),与此同时,DevEco Studio工具自动会生成一个pack.info
文件。pack.info
文件描述了App Pack中每个HAP和HSP的属性,包含APP中的bundleName
和versionCode
信息、以及Module中的name
、type
和abilities
等信息。
说明⚠️:
- App Pack是发布上架到应用市场的基本单元,但是不能在设备上直接安装和运行。
- 在应用签名、云端分发、端侧安装时,都是以
HAP/HSP
为单位进行签名、分发和安装的。
HAP、HAR、HSP三者的功能和使用场景总结对比如下:
六、拓展阅读
- API 14 应用模型
- 《HarmonyOS NEXT开发进阶(八):Stage模型开发概述》
- 《HarmonyOS NEXT开发进阶(五):装饰器讲解》
- 《HarmonyOS NEXT开发进阶(二):装饰器》