鸿蒙应用程序框架基础

应用程序包基础知识

应用的多Module设计机制

• **支持模块化开发：**一个应用通常会包含多种功能，将不同的功能特性按模块来划分和管理是一种良好的设计方式。在开发过程中，我们可以将每个功能模块作为一个独立的Module进行开发，Module中可以包含源代码、资源文件、第三方库、配置文件等，每一个Module可以独立编译，实现特定的功能。在这种模块化、松耦合的应用管理方式有助于应用的开发、维护与拓展。
• **支持多设备适配：**一个应用往往需要适配多种设备类型，在采用多Module设计的应用中，每个Module都会标注所支持的设备类型。有些Module支持全部类型的设备，有些Module只支持一种或几种类型的设备，那么在应用市场分发应用包时，也能够根据设备类型做精准的筛选和匹配，从而将不同的包合理的组合和部署到对应的设备上。

Module类型

Module按照使用场景可以分为两种类型：

• **Ability类型的Module：**用于实现应用的功能和特性。每一个Ability类型的Module编译后，会生成一个以.hap为后缀的文件，我们称其为HAP(Harmony Ability Package)包。HAP包可以独立安装和运行，是应用安装的基本单位，一个应用中可以包含一个或者多个HAP包，具体包含如下两种类型。
  • entry类型的Module： 应用的主模块，包含应用的入口界面、入口图标和主功能特性，编译后生成entry类型的HAP。每一个应用分发到同一类型的设备上的应用程序包，只能包含唯一一个entry类型的HAP。
  • feature类型的Module：应用的动态特性模块，编译后生成feture类型的HAP。一个应用中可以包含一个或者多个feature类型的HAP，也可以不包含。
• **Library类型的Module：**用于实现代码和资源的共享。同一个Library类型的Module可以被其他的Module多次引用，合理的使用该类型的Module，能够降低开发和维护成本。Library类型的module分为Static和Shared两种类型，编译后会生成共享包。
  • Static Library：静态共享库。编译后会生成一个以.har为后缀的文件，即静态共享包HAR(Harmony Archive)。
  • Shared Library：动态共享库。编译后会生成一个以.hsp为后缀的文件，即动态共享包HSP(Harmony Shared Package)。实际上，Shared Library编译后除了会生成一个.hsp文件，还会生成一个.har文件。这个.har文件中包含了HSP对外导出的接口，应用中的其他模块需要通过.har文件来应用HSP的功能。为了表述方便，我们通常认为Shared Library编译后生成HSP。

HAR和HSP两种共享包的主要区别体现在：

HAR和HSP在APP包中的形态示意图：

Stage模型应用程序包结构

开发态包结构

工程结构示意图：


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

• AppScope目录有DevEco Studio自动生成，不可修改。
• Module目录名称可以由DevEco Studio自动生成（比如entry、library等），也可以自定义。

编译包形态

开发态与编译态试图的对照关系如下：

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

• ets目录：ArkTs源码编译生成.abc文件
• resources目录：AppScope目录下的资源文件会合并到Module下边的资源目录中，如果两个目录存在重名文件，编译后只会保留AppScope目录下的资源文件。
• module配置文件：AppScope目录下的app.json5文件字段会合并到Module下面的module.json5文件中，编译后生成HAP或者HSP最终的module.json文件。在编译HAP和HSP时，会把他们所依赖的HAR直接编译到HAP和HSP中。

发布台包结构

每个应用中至少包含一个.hap文件，可能包含若干个.hsp文件，也可能不包含。一个应用中的所有.hap文件和.hsp文件合并在一起称为一个Bundle，其对应的bundleName是应用的唯一标识。

当应用发布上架到应用市场时，需要将Bundle打包为一个.app文件用于上架，这个.app文件称为App Pack（Application Package），与此同时，DevEco Studio会自动生成一个pack.info文件。pack.info文件猫叔了App Pack中每个HAP和HSP的属性，包含App中的bundleName和versionCode信息，以及Module中的name、type和abilites等信息。

注意：

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

编译发布与上架部署流程图

选择合适的包类型

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

HAP、HSP、HAR支持的规格对比如下：

说明：

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