想要更加合理的开发一个企业级别的Harmony应用,那么就不得不提其中的HAP、HAR、HSP了。
前言
对于普通的用户来说,可能一个普通的应用就等于一个安装文件如安卓下的APK。但是对于Harmony应用开发工程师来讲,一个应用包含的内容仅仅不止于此。
用户应用程序泛指运行在设备的操作系统之上,为用户提供特定服务的程序,简称“应用”。一个应用所对应的软件包文件,称为“应用程序包”。
项目架构
目前开发应用,稍微大一点的应用,都会采取模块化开发方式。它将应用中的某些功能看做一个单独的模块*(module)。这样的开发方式有利于团队开发、封装复用、方便维护等优点。如: 外卖、小象超市、国内外酒店等可以视作一个单独的模块(module)*。
在Harmony应用中,可以将模块看成三个种类。分别是
- HAP --- Harmony Ability Package 鸿蒙能力单元包 - 作者自己翻译的
- HAR --- Harmony Archive 静态共享库
- HSP --- Harmony Shared Package 动态共享库
HAP
HAP(Harmony Ability Package)是应用安装和运行的基本单元。HAP包是由代码、资源、第三方库、配置文件等打包生成的模块包,其主要分为两种类型:entry和feature。
- entry:应用的主模块,作为应用的入口,提供了应用的基础功能。
- feature:应用的动态特性模块,作为应用能力的扩展,可以根据用户的需求和设备类型进行选择性安装。
其中,应用程序包可以只包含一个基础的entry包,也可以包含一个基础的entry包和多个功能性的feature包。
在项目工程中,entry模块默认存在,并且存在入口页面 @Entry
如果项目只有有个 Entry模块,那么该项目也可称为单HAP项目结构
此时,如果我们想要建立多个Feature模块,如
可以直接在项目工程中建立。
Feature模块:
此时 HAP中 Entry 和 Feature模块的关系我们可以使用 美团APP 和 美团外卖APP来简单举例。
- 美团APP做为一个超大的APP,里面包含 美团外卖、美团打车等入口。
- 美团外卖也可以作为一个单独的APP进行发布上线。
这也验证了开头 HAP包可以独立安装和运行,是应用安装的基本单位的官方描述
HAR
HAR(Harmony Archive)是静态共享包,可以包含代码、C++库、资源和配置文件。通过HAR可以实现多个模块或多个工程共享ArkUI组件、资源等相关代码。
使用场景
举个栗子
一个项目中,可能是多个HAP的结构。那么每一个HAP其实都需要用到登录的功能。此时可以将登录功能封装到一个单独的页面或组件中。Login.ets,此时考虑方便复用,可以将该功能单独抽离到一个 HAR中方便复用。
再举个栗子
如阿里集团下,有多个APP都需要登录,那么他们的登录功能可以抽离到一个单独的HAR中,然后作为二方库,发布到OHPM私仓,供公司内部其他应用使用。
继续举个栗子
如讯飞星火将一个内置了星火AI功能的页面或者组件,作为三方库,发布到OHPM中心仓,供其他应用使用。
项目中,建立一个HAR模块的示例如下:
HSP
HSP(Harmony Shared Package)是动态共享包,可以包含代码、C++库、资源和配置文件,通过HSP可以实现应用内的代码和资源的共享。
HSP往往是和 HAP做为对比区分了解。
- HSP 是动态共享包
- HAR 是静态共享包
项目中,如果其他模块引入了 HAR,那么其他模块中都会存在 一份HAR的拷贝,此时会存在资源冗余。而HSP则是通过多个模块共享一个引用,资源空间得到利用。
举个例子
项目是个多模块结构,多处地方都存在 显示用户头像+用户姓名等需求。此时可以考虑采用 HSP 实现该功能。
工程中,这样来新建一个 HSP模块:
最后附上小结:
Module类型 | 包类型 | 说明 |
Ability | HAP | 应用的功能模块,可以独立安装和运行,必须包含一个entry类型的HAP,可选包含一个或多个feature类型的HAP。 |
Static Library | HAR | 静态共享包,编译态复用。 - 支持应用内共享,也可以发布后供其他应用使用。 - 作为二方库,发布到OHPM私仓,供公司内部其他应用使用。 - 作为三方库,发布到OHPM中心仓,供其他应用使用。 - 多包(HAP/HSP)引用相同的HAR时,会造成多包间代码和资源的重复拷贝,从而导致应用包膨大。 |
Shared Library | HSP | 动态共享包,运行时复用。 - 当前仅支持应用内共享。 - 当多包(HAP/HSP)同时引用同一个共享包时,采用HSP替代HAR,可以避免HAR造成的多包间代码和资源的重复拷贝,从而减小应用包大小。 |
规格 | HAP | HAR | HSP |
支持在配置文件中声明UIAbility组件与ExtensionAbility组件 | √ | × | × |
支持在配置文件中声明pages页面 | √ | × | √ |
支持包含资源文件与.so文件 | √ | √ | √ |
支持依赖其他HAR文件 | √ | √ | √ |
支持依赖其他HSP文件 | √ | √ | √ |
支持在设备上独立安装运行 | √ | × | × |