05-Stage 模型应用程序包介绍

根据应用程序包在不同状态的分类，我们分为了开发态、编译态、发布态的应用程序结构三个状态进行介绍。

开发态包

开发态包就是项目工程的源代码模样

工程结构主要包含的文件类型及用途如下：

说明

• AppScope 目录由 DevEco Studio 自动生成，不可更改。
• Module 目录名称可以由 DevEco Studio 自动生成（比如 entry、library 等），也可以自定义。为了便于说明，下表中统一采用 Module_name 表示。

文件类型	说明
配置文件	包括应用级配置信息、以及 Module 级配置信息：- AppScope > app.json5：app.json5 配置文件，用于声明应用的全局配置信息，比如应用 Bundle 名称、应用名称、应用图标、应用版本号等。- Module_name > src > main > module.json5：module.json5 配置文件，用于声明 Module 基本信息、支持的设备类型、所含的组件信息、运行所需申请的权限等。
ArkTS 源码文件	Module_name > src > main > ets：用于存放 Module 的 ArkTS 源码文件（.ets 文件）。
资源文件	包括应用级资源文件、以及 Module 级资源文件，支持图形、多媒体、字符串、布局文件等，详见资源分类与访问。- AppScope > resources ：用于存放应用需要用到的资源文件。- Module_name > src > main > resources ：用于存放该 Module 需要用到的资源文件。
其他配置文件	用于编译构建，包括构建配置文件、编译构建任务脚本、混淆规则文件、依赖的共享包信息等。- build-profile.json5：工程级或 Module 级的构建配置文件，包括应用签名、产品配置等。- hvigorfile.ts：应用级或 Module 级的编译构建任务脚本，开发者可以自定义编译构建工具版本、控制构建行为的配置参数。- obfuscation-rules.txt：混淆规则文件。混淆开启后，在使用 Release 模式进行编译时，会对代码进行编译、混淆及压缩处理，保护代码资产。- oh-package.json5：用于存放依赖库的信息，包括所依赖的三方库和共享包。

编译态包

先了解即可

不同类型的 Module 编译后会生成对应的HAP、HAR、HSP(后面会介绍)等文件，开发态视图与编译态视图的对照关系如下：

从开发态到编译态，Module 中的文件会发生如下变更：

• ets 目录：ArkTS 源码编译生成.abc 文件。
• resources 目录：AppScope 目录下的资源文件会合入到 Module 下面资源目录中，如果两个目录下存在重名文件，编译打包后只会保留 AppScope 目录下的资源文件。
• module 配置文件：AppScope 目录下的 app.json5 文件字段会合入到 Module 下面的 module.json5 文件之中，编译后生成 HAP 或 HSP 最终的 module.json 文件。

发布态包

每个应用中至少包含一个.hap 文件，可能包含若干个.hsp 文件、也可能不含，一个应用中的所有.hap 与.hsp 文件合在一起称为Bundle，

其对应的 bundleName 是应用的唯一标识（详见app.json5 配置文件中的 bundleName 标签）。

当应用发布上架到应用市场时，需要将 Bundle 打包为一个.app 后缀的文件用于上架，这个.app 文件称为App Pack（Application

Package），与此同时，DevEco Studio 工具自动会生成一个pack.info文件。pack.info文件描述了 App Pack 中每个 HAP 和 HSP 的属性，

包含 APP 中的 bundleName 和 versionCode 信息、以及 Module 中的 name、type 和 abilities 等信息。

说明

• App Pack 是发布上架到应用市场的基本单元，但是不能在设备上直接安装和运行。
• 在应用签名、云端分发、端侧安装时，都是以 HAP/HSP 为单位进行签名、分发和安装的。

HAP、HAR、HSP

HAP、HAR、HSP 三者的功能和使用场景总结对比如下：

Module 类型	包类型	说明
Ability	HAP	应用的功能模块，可以独立安装和运行，必须包含一个 entry 类型的 HAP，可选包含一个或多个 feature 类型的 HAP。
Static Library	HAR	静态共享包，编译态复用。- 支持应用内共享，也可以发布后供其他应用使用。- 作为二方库，发布到OHPM 私仓，供公司内部其他应用使用。- 作为三方库，发布到OHPM 中心仓，供其他应用使用。- 多包（HAP/HSP）引用相同的 HAR 时，会造成多包间代码和资源的重复拷贝，从而导致应用包膨大。- 注意：编译 HAR时，建议开启混淆能力，保护代码资产。
Shared Library	HSP	动态共享包，运行时复用。- 当多包（HAP/HSP）同时引用同一个共享包时，采用 HSP 替代 HAR，可以避免 HAR 造成的多包间代码和资源的重复拷贝，从而减小应用包大小。

HAP、HSP、HAR 支持的规格对比如下，其中“√”表示是，“×”表示否。

开发者可以根据实际场景所需的能力，选择相应类型的包进行开发。在后续的章节中还会针对如何使用HAP、HAR、HSP分别展开详细介绍。

规格	HAP	HAR	HSP
支持在配置文件中声明UIAbility组件与ExtensionAbility组件	√	×	×
支持在配置文件中声明pages页面	√	×	√
支持包含资源文件与.so 文件	√	√	√
支持依赖其他 HAR 文件	√	√	√
支持依赖其他 HSP 文件	√	√	√
支持在设备上独立安装运行	√	×	×

说明

• HAR 虽然不支持在配置文件中声明 pages 页面，但是可以包含 pages 页面，并通过命名路由的方式进行跳转。
• 由于 HSP 仅支持应用内共享，如果 HAR 依赖了 HSP，则该 HAR 文件仅支持应用内共享，不支持发布到二方仓或三方仓供其他应用使用，否则会导致编译失败。
• HAR 和 HSP 均不支持循环依赖，也不支持依赖传递。