文章

HAP-HAR-HSP的区别

HAP、HAR、HSP的区别

HAP-HAR-HSP的区别

HAP、HAR、HSP的区别

前言

对于普通的用户来说,可能一个普通的应用就等于一个安装文件如安卓下的_APK_。但是对于Harmony应用开发工程师来讲,一个应用包含的内容仅仅不止于此。

用户应用程序泛指运行在设备的操作系统之上,为用户提供特定服务的程序,简称“应用”。一个应用所对应的软件包文件,称为“应用程序包”。

项目架构

目前开发应用,稍微大一点的应用,都会采取模块化开发方式。它将应用中的某些功能看做一个单独的模块(module)。这样的开发方式有利于团队开发、封装复用、方便维护等优点。如: 外卖、小象超市、国内外酒店等可以视作一个单独的模块(module)

1731046647066-fc661dc1-0a08-4507-b94d-04f7bdae236a.png

在Harmony应用中,可以将模块看成三个种类。分别是

  1. HAP — Harmony Ability Package 鸿蒙能力单元包 - 作者自己翻译的
  2. HAR — Harmony Archive 静态共享库
  3. HSP — Harmony Shared Package** 动态共享库**

HAP

HAP(Harmony Ability Package)是应用安装和运行的基本单元。HAP包是由代码、资源、第三方库、配置文件等打包生成的模块包,其主要分为两种类型:entry和feature。

  • entry:应用的主模块,作为应用的入口,提供了应用的基础功能。
  • feature:应用的动态特性模块,作为应用能力的扩展,可以根据用户的需求和设备类型进行选择性安装。

其中,应用程序包可以只包含一个基础的entry包,也可以包含一个基础的entry包和多个功能性的feature包。

1731046694239-3fdf8100-6600-4de2-b53f-90d550548224.png


在项目工程中,entry模块默认存在,并且存在入口页面 @Entry
1731046708042-94ff42eb-da02-434b-b7c6-c949d2b3ed0c.png

如果项目只有有个 Entry模块,那么该项目也可称为单HAP项目结构

此时,如果我们想要建立多个Feature模块,如

1731046720139-d155de6a-e843-48f9-82a6-572e7fab98e2.png

可以直接在项目工程中建立。
1731046729242-bfabd705-b26c-4238-8438-86371d799eff.png


Feature模块:

1731046755043-ca6a9a22-f1ff-40c4-bcdb-d696df3544db.png

此时 HAP中 Entry 和 Feature模块的关系我们可以使用 美团APP 和 美团外卖APP来简单举例。

  • 美团APP做为一个超大的APP,里面包含 美团外卖、美团打车等入口。
  • 美团外卖也可以作为一个单独的APP进行发布上线。

这也验证了开头 HAP包可以独立安装和运行是应用安装的基本单位的官方描述

1731046780301-67eeb313-e7d1-4f1e-a665-ad0e558b2cf9.png

HAR

HAR(Harmony Archive)是静态共享包,可以包含代码、C++库、资源和配置文件。通过HAR可以实现多个模块或多个工程共享ArkUI组件、资源等相关代码。

使用场景

  • 作为二方库,发布到OHPM私仓,供公司内部其他应用使用。
  • 作为三方库,发布到OHPM中心仓,供其他应用使用。

举个栗子

一个项目中,可能是多个HAP的结构。那么每一个HAP其实都需要用到登录的功能。此时可以将登录功能封装到一个单独的页面或组件中。Login.ets,此时考虑方便复用,可以将该功能单独抽离到一个 HAR中方便复用。

再举个栗子

如阿里集团下,有多个APP都需要登录,那么他们的登录功能可以抽离到一个单独的HAR中,然后作为二方库,发布到OHPM私仓,供公司内部其他应用使用。

继续举个栗子

如讯飞星火将一个内置了星火AI功能的页面或者组件,作为三方库,发布到OHPM中心仓,供其他应用使用。


项目中,建立一个HAR模块的示例如下:

1731046844310-4f49741e-852f-4fa2-95e1-08a16966b83d.png

HSP

HSP(Harmony Shared Package)是动态共享包,可以包含代码、C++库、资源和配置文件,通过HSP可以实现应用内的代码和资源的共享。

HSP往往是和 HAP做为对比区分了解。

  • HSP 是动态共享包
  • HAR 是静态共享包

项目中,如果其他模块引入了 HAR,那么其他模块中都会存在 一份HAR的拷贝,此时会存在资源冗余。而HSP则是通过多个模块共享一个引用,资源空间得到利用。

举个例子

项目是个多模块结构,多处地方都存在 显示用户头像+用户姓名等需求。此时可以考虑采用 HSP 实现该功能。

1731046888822-d82fac4d-3689-4560-b4e2-4c7b27d91c13.png


工程中,这样来新建一个 HSP模块:

1731046911435-fe4d089a-d715-47ec-90b7-6a255dd1fd46.png

最后附上小结:

1731046942159-ef6411f1-e3bf-4b37-af12-9bcb150b885c.png

本文由作者按照 CC BY 4.0 进行授权