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

news2025/3/31 6:07:52

【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%') 
  } 
}