当前位置：首页 > news >正文

【HarmonyOS Next】鸿蒙中App、HAP、HAR、HSP概念详解

news 来源：原创 2025/8/3 9:00:14

【HarmonyOS Next】鸿蒙中App、HAP、HAR、HSP概念详解

在这里插入图片描述
（图1-1）

一、鸿蒙中App、HAP、HAR、HSP是什么？

（1）App Pack（Application Package） 是应用发布的形态，上架应用市场是以App Pack形式上架。以 .app 后缀的文件，只能上架到应用市场，不能在设备上直接安装和运行。

（2）HAP（Harmony Ability Package） 是应用安装和运行的基本形态。

HAP的两种类型：
其主要分为两种类型：entry和feature：
1.entry 是应用的主模块，作为应用的入口，提供应用的基础功能，一个 App 中对于同一设备类型必须有且只有一个 entry 类型的 HAP，可独立安装运行。

2.feature 是应用的动态特性模块，作为应用能力的扩展，可以根据用户的需求和设备类型进行选择性安装，一个 App 可以包含一个或多个 feature 类型的 HAP，也可以不含。

模块配置：
在feature模块的module.json5配置中，type有entry和feature两种值，设置为后者feature，就是feature模块。
并且deliveryWithInstall设置为false，为按需下载，用户需通过应用内引导或应用市场手动获取。

{"module": {"name": "application","type": "feature","description": "$string:module_desc","mainElement": "ApplicationAbility","deviceTypes": ["phone"],"deliveryWithInstall": false,"installationFree": false,"pages": "$profile:main_pages","abilities": [{"name": "ApplicationAbility","srcEntry": "./ets/applicationability/ApplicationAbility.ets","description": "$string:ApplicationAbility_desc","icon": "$media:layered_image","label": "$string:ApplicationAbility_label","startWindowIcon": "$media:startIcon","startWindowBackground": "$color:start_window_background","exported": true}]}
}

如上图（1-1）所示，feature模块主要是为了动态功能扩展，按需加载优化，跨设备适配三种效果。

例如，京东APP的直播模块，就可以设计为feature，用户点击直播入口才去加载，减小初始包大小。并且京东APP在车机和手表等不同设备上，可以适配硬件加载不同的feature模块。

不过需要注意的是，使用feature模块，需处理 Feature HAP 的加载时机、依赖关系及错误处理，避免因模块未下载导致功能不可用。（如首次使用时的网络请求和安装时间）。

feature HAP 是实现轻量化、动态化、跨设备应用的核心机制。一般是面试题目，要好好记住。

（3）HAR（Harmony Archive） 是静态共享包。说人话，HAR可以理解为SDK依赖，与HSP的区别在加载机制上。

多包（HAP/HSP）引用相同的HAR时，会造成多包间代码和资源的重复拷贝，从而导致应用包膨大。不过HAR 打包时全部打进引用方的 HSP/HAP 包中，可以节省安装和加载成本。

那为什么还需要HAR呢？ 是因为加载效率高，HAR在编译时就被打包到依赖它的每个 HAP 中，在应用启动时就已经随 HAP 存在于内存中，后续使用时无需额外加载步骤，直接调用即可。

而 HSP 是动态共享包，运行时复用，在运行时按需加载，每次使用时都需要额外的查找、加载和初始化等操作，这些操作会消耗一定时间，导致加载效率降低。

并且如果我的HAR包并不会在很多HAP中引用，那做成HAR包的加载效率是比做成HSP包高很多。

（4）HSP（Harmony Shared Package） 是动态共享包，分为应用内HSP和集成态HSP。

详细区别，参加文档
【HarmonyOS Next】鸿蒙应用useNormalizedOHMUrl详解

跳转到HSP模块中的一个页面，如何实现：
因为HSP中不能创建 UIAbility，那主模块entry下跳转到HSP模块中的页面需求实现如下：

import { router } from '@kit.ArkUI'; 
import { BusinessError } from '@kit.BasicServicesKit'; @Entry 
@Component 
struct Index { @State message: string = '跳转到HSP页面'; build() { Row() { Column() { Button() { Text(this.message) .fontSize(24) } .onClick(() => { // '@bundle:包名（bundleName）/模块名（moduleName）/路径/页面所在的文件名(不加.ets后缀)'router.pushUrl({ url: '@bundle:com.example.gotohsppage/library/ets/pages/Index' }).then(() => { console.info("Go to hSP page success."); }).catch((err: BusinessError) => { console.error(`Go to hSP page failed, code is ${err.code}, message is ${err.message}.`); }) }) .width(200) } .width('100%') } .height('100%') } 
}