鸿蒙HarmonyOS 5.0开发：Stage模型应用步伐包结构

 往期鸿蒙全套实战文章必看：（文中附带鸿蒙全栈学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了
  
• 最新版！鸿蒙HarmonyOS Next应用开发实战学习门路
  
• 鸿蒙HarmonyOS NEXT开发技能最全学习门路指南
  
• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）
  

---

Stage模型应用步伐包结构

为了让开发者能对应用步伐包在差别阶段的形态有更加清晰的认知，分别对开发态、编译态、发布态的应用步伐结构展开介绍。
开发态包结构

在DevEco Studio上创建一个项目工程，并尝试创建多个差别类型的Module。根据实际工程中的目次对照本章节举行学习，可以有助于理解开发态的应用步伐结构。
图1 项目工程结构示意图（以实际为准）

工程结构紧张包含的文件类型及用途如下：
阐明
   

• 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等文件，开发态视图与编译态视图的对照关系如下：
图2 开发态与编译态的工程结构视图

从开发态到编译态，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和abilities等信息。
阐明
   

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

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

选择符合的包类型

HAP、HAR、HSP三者的功能和使用场景总结对比如下：
Module类型包类型阐明AbilityHAP应用的功能模块，可以独立安装和运行，必须包含一个entry类型的HAP，可选包含一个或多个feature类型的HAP。Static LibraryHAR 静态共享包，编译态复用。
- 支持应用内共享，也可以发布后供其他应用使用。
- 作为二方库，发布到OHPM私仓，供公司内部其他应用使用。
- 作为三方库，发布到OHPM中央仓，供其他应用使用。
- 多包（HAP/HSP）引用雷同的HAR时，会造成多包间代码和资源的重复拷贝，从而导致应用包膨大。
- 注意：编译HAR时，发起开启肴杂本领，掩护代码资产。
Shared LibraryHSP 动态共享包，运行时复用。
- 当多包（HAP/HSP）同时引用同一个共享包时，采取HSP更换HAR，可以避免HAR造成的多包间代码和资源的重复拷贝，从而减小应用包巨细。
  HAP、HSP、HAR支持的规格对比如下，其中“√”表现是，“×”表现否。
开发者可以根据实际场景所需的本领，选择相应类型的包举行开发。在后续的章节中还会针对如何使用HAP、HAR、HSP分别展开详细介绍。
规格HAPHARHSP支持在设置文件中声明UIAbility组件与ExtensionAbility组件√××支持在设置文件中声明pages页面√×√支持包含资源文件与.so文件√√√支持依靠其他HAR文件√√√支持依靠其他HSP文件√√√支持在设备上独立安装运行√×× 阐明
   

• 如果HAR支持声明pages页面，那么当HAR被打包到HAP或HSP中时，其内部声明的pages页面大概会与HAP/HSP中的pages页面存在相对路径上的重复，这将导致无法根据相对路径辨认特定的路由页面。因此，HAR不支持在设置文件中声明pages页面，但可以包含pages页面，并通过命名路由的方式举行跳转。
  
• 由于HSP仅支持应用内共享，如果HAR依靠了HSP，则该HAR文件仅支持应用内共享，不支持发布到二方仓或三方仓供其他应用使用，否则会导致编译失败。
  
• HAR和HSP均不支持循环依靠，也不支持依靠传递。
  

  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。