0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

鸿蒙OS开发:【Stage模型应用程序包结构】

jf_46214456 来源:jf_46214456 作者:jf_46214456 2024-05-15 16:08 次阅读

Stage模型应用程序包结构

为了让开发者能对应用程序包在不同阶段的形态更有清晰的认知,分别对开发态、编译态、发布态的应用程序结构展开介绍。

开发态包结构

在DevEco Studio上[创建一个项目工程],并尝试创建多个不同类型的Module。根据实际工程中的目录对照本章节进行学习,可以有助于理解开发态的应用程序结构。

开发前请熟悉鸿蒙开发指导文档:[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

图1 项目工程结构示意图(以实际为准)

project

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

说明:

  • 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 开发态与编译态的工程结构视图 app-view

从开发态到编译态,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是应用的唯一标识(详见[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为单位进行签名、分发和安装的。

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

选择合适的包类型

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

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

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

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

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

搜狗高速浏览器截图20240326151450.png

说明:
HarmonyOSOpenHarmony鸿蒙文档籽料:mau123789是v直接拿

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

审核编辑 黄宇

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 开发
    +关注

    关注

    0

    文章

    348

    浏览量

    40631
  • 模型
    +关注

    关注

    1

    文章

    2750

    浏览量

    47807
  • 鸿蒙
    +关注

    关注

    55

    文章

    1786

    浏览量

    42158
  • 鸿蒙OS
    +关注

    关注

    0

    文章

    156

    浏览量

    4290
收藏 人收藏

    评论

    相关推荐

    鸿蒙Stage模型--概述

    Stage模型:HarmonyOS 3.1 Develper Preview版本开始新增的模型,是目前主推且会长期演进的模型。在该模型中,由
    的头像 发表于 01-29 13:59 753次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>Stage</b><b class='flag-5'>模型</b>--概述

    Stage 模型深入解读

    跨设备的迁移和协同机制。本文为大家详细介绍 Stage 模型。 一、Stage 模型概念 应用开发模型
    的头像 发表于 02-18 09:28 510次阅读
    <b class='flag-5'>Stage</b> <b class='flag-5'>模型</b>深入解读

    怎么开发一个鸿蒙os应用程序?带示例演示。

    听说这里大神特别多,听说鸿蒙开源,作为今年刚入行的码农,我还是想参与一下鸿蒙开源建设的,现在的问题是有一个示例应用程序给大家看一下吗?
    发表于 09-08 16:38

    鸿蒙OS应用程序开发

    这份学习文档主要是带领大家在鸿蒙OS上学习开发一个应用程序,主要知识点如下:1、U-Boot引导文件烧写方式;2、内核镜像烧写方式;3、镜像运行。
    发表于 09-11 14:39

    应用程序开发

    应用程序开发不少开发者还针对AI Camera、手表做一些应用和前端展示,这里给到的应用程序开发资料可能有所帮助,主要内容有:鸿蒙
    发表于 11-24 11:58

    什么是程序包

    什么是程序包?编译一个程序包 导入程序包
    发表于 12-17 07:20

    Stage模型深入解读

    的迁移和协同机制。本文为大家详细介绍Stage模型。 一、Stage模型概念 应用开发模型是运行
    发表于 03-15 10:32

    OpenHarmony应用程序包整体说明

    来源:OpenHarmony官网 应用程序包结构Stage模型)*附件:OpenHarmony应用程序包整体说明.docx
    发表于 09-20 15:34

    OpenHarmony应用模型的构成要素与Stage优势

    一、应用模型的构成要素 应用模型是OpenHarmony为开发者提供的应用程序所需能力的抽象提炼,它提供了应用程序必备的组件和运行机制。有了
    发表于 09-26 16:48

    鸿蒙 OS 应用开发初体验

    Package 的缩写)。是鸿蒙操作系统设计的应用程序包格式。 .hap 文件包含了应用程序的代码、资源和元数据等信息,用于在 HarmonyOS 设备上安装和运行应用程序。 整
    发表于 11-02 19:38

    NI Package Manager创建程序包

    在安装了PackageManager的任何系统上安装单个程序包。 双击程序包,打开Package Manager。 按照安装提示完成安装。 这是LabVIEW的一个功能介绍,更多的使用方法与开发案例,欢迎登录官网,了解更多信息
    发表于 11-19 20:11

    modbus开发程序包

    modbus开发程序包 详细说明
    发表于 07-09 17:52 114次下载

    uC/OS-II 应用程序基本结构及重要的API介绍

    应用uC/OS-II,自然要为它开发应用程序,下面论述基于uC/OS-II的应用程序的基本结构
    发表于 10-24 11:28 2次下载

    第4节《鸿蒙OS应用程序开发

    这份学习文档主要是带领大家在鸿蒙OS上学习开发一个应用程序,主要知识点如下: 1、U-Boot引导文件烧写方式; 2、内核镜像烧写方式; 3、镜像运行。
    发表于 10-20 15:40 15次下载
    第4节《<b class='flag-5'>鸿蒙</b><b class='flag-5'>OS</b><b class='flag-5'>应用程序</b><b class='flag-5'>开发</b>》

    Stage模型深入解读

    形态下统一的应用组件生命周期,并支持跨设备的迁移和协同机制。本文为大家详细介绍Stage模型。 一 Stage模型概念 应用开发
    的头像 发表于 03-16 13:35 607次阅读