【HarmonyOS开发】HAP包与APP包

wMeng_0923

已于 2024-06-21 17:31:33 修改

阅读量961

点赞数 24

分类专栏：鸿蒙开发 HarmonyOS 文章标签： harmonyos 华为

于 2024-06-21 17:28:34 首次发布

本文链接：https://blog.csdn.net/wMeng_0923/article/details/139833003

版权

2 篇文章 0 订阅

订阅专栏

2 篇文章 0 订阅

订阅专栏

我们在DevEco编辑器中完成项目之后经常会在构建窗口中编译项目的时候，看到有两个选项，分别是Hap与APP：

那么就让我们来深入探究一下这两个包的区别与联系吧

Hap与APP包

首先需要理解Hap和APP包都分别是什么

Hap的全称为“HarmonyOS Ability Package”，它是Ability的部署包（Hap内带有Ability组件），也是应用安装和运行的基本单元。HAP包是由代码、资源、第三方库、配置文件等打包生成的模块包。

hap包有两种类型，分别是entry和feature

entry类型的HAP：是应用的主模块，在module.json5配置文件中的type标签配置为“entry”类型。然而feature类型的HAP是应用的动态性模块，在module.json5文件中的type标签配置为“feature”类型。
在同一个应用中，同一设备类型只支持一个entry类型的HAP，通常用于实现应用的入口界面、入口图标、主特性功能等。一个应用程序包可以包含一个或多个Feature类型的HAP，也可以不包含；Feature类型的HAP通常用于实现应用的特性功能，可以配置成按需下载安装，也可以配置成随Entry类型的HAP一起下载安装。

将一个项目打包成Hap，可以在目录中看到有一个hap文件和info文件

其实本质上这个hap文件就是一个压缩包，可以更改后缀名为zip解压压缩包看下 hap 包里的文件结构，解压出来的文件结构如下所示：

可以看到解压之后，里面目录结构包含了ets、resources两个目录和三个配置文件。

abc 文件表示方舟字节码（ark bytecode，简称 abc），所以项目运行的时候 ark 虚拟机需要加载运行这些 abc 文件。module.json 是项目里的默认配置文件，只是在打包的时候添加了一些额外的默认配置。

不支持导出接口和ArkUI组件，给其他模块使用。
多HAP场景下，App Pack包中同一设备类型的所有HAP中必须有且只有一个Entry类型的HAP，Feature类型的HAP可以有一个或者多个，也可以没有。
多HAP场景下，同一应用中的所有HAP的配置文件中的bundleName、versionCode、versionName、minCompatibleVersionCode、debug、minAPIVersion、targetAPIVersion、apiReleaseType相同，同一设备类型的所有HAP对应的moduleName标签必须唯一。HAP打包生成App Pack包时，会对上述参数配置进行校验。
多HAP场景下，同一应用的所有HAP、HSP的签名证书要保持一致。上架应用市场是以App Pack形式上架，应用市场分发时会将所有HAP从App Pack中拆分出来，同时对其中的所有HAP进行重签名，这样保证了所有HAP签名证书的一致性。在调试阶段，开发者通过命令行或DevEco Studio将HAP安装到设备上时，要保证所有HAP签名证书一致，否则会出现安装失败的问题。

APP包是用于上架发布的。根据不同的设备类型，一个APP包可以由多个HAP包，以及描述APP 包属性的pack.info文件组成。

一个 APP 中可以包含多个 HAP，但必须含有 Entry.HAP；一个 APP 可包含多个 Feature.HAP，也可以不包含 Feature.HAP。

1、编译构建角度

编译构建是将HarmonyOS应用的源代码、资源、第三方库等打包生成HAP或者APP的过程。其中，HAP可以直接运行在真机设备或者模拟器中；APP则是用于应用上架到华为应用市场。
一个HarmonyOS工程下可以存在多个Module，在编译构建时，可以选择对单个Module进行编译构建；也可以对整个工程进行编译构建，同时生成多个HAP。

2、签名角度

APP

HarmonyOS应用发布形态为APP Pack（Application Package，简称APP），它是由一个或多个HAP（HarmonyOS Ability Package）包以及描述APP Pack属性的pack.info文件组成。

Hap

一个HAP在工程目录中对应一个Module，它是由代码、资源、第三方库及应用配置文件组成，可以分为Entry和Feature两种类型。Entry：应用的主模块。一个APP中，对于同一设备类型必须有且只有一个entry类型的HAP，可独立安装运行。Feature：应用的动态特性模块。一个APP可以包含一个或多个feature类型的HAP，也可以不含。
HAP是Ability的部署包，HarmonyOS应用代码围绕Ability组件展开，它是由一个或多个Ability组成。
一个App可以有很多HAP。HAP可以直接在模拟器或者真机设备上运行，用于HarmonyOS应用开发阶段的调试和查看运行效果。
原子化服务由1个或多个HAP包组成，1个HAP包对应1个FA或1个PA。每个FA或PA均可独立运行，完成1个特定功能；1个或多个功能（对应FA或PA）完成1个特定的便捷服务。