鸿蒙技术分享 HarmonyOS Next 中的 HAP、HAR、HSP 区别

鸿蒙技术分享 HarmonyOS Next 中的 HAP、HAR、HSP 区别想要更加合理的开发一个企业级别的 Harmony 应用，那么就不得不提其中的HAP、HAR、HSP了。前言对于普通的用户来说，可能一个普通的应用就等于一个安装文件如安卓下的 APK。但是对于 Harmony 应用开发工程师来讲，一个应用包含的内容仅仅不止于此。用户应用程序

万少-

186人浏览 · 2024-12-12 06:38:37

万少- · 2024-12-12 06:38:37 发布

鸿蒙技术分享 HarmonyOS Next 中的 HAP、HAR、HSP 区别

想要更加合理的开发一个企业级别的 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 组件、资源等相关代码。

使用场景

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

举个栗子

一个项目中，可能是多个 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 文件	√	√	√
支持在设备上独立安装运行	√	×	×