鸿蒙Stage模型应用程序包结构

1、开发态包结构

在DevEco Studio上创建一个项目工程,理解开发态的应用程序结构。

AppScope目录由开发工具自动生成。

AppScope > app.json5:声明应用的全局配置信息,比如应用Bundle名称、应用名称、应用图标、应用版本号等。

AppScope > resources :用于存放应用需要用到的资源文件。

Module_name > src > main > module.json5:声明Module基本信息、支持的设备类型、所含的组件信息、运行所需申请的权限等。

Module_name > src > main > ets:用于存放Module的ArkTS源码文件。

Module_name > src > main > resources :用于存放该Module需要用到的资源文件。

build-profile.json5:工程级或Module级的构建配置文件,包括应用签名、产品配置等。

hvigorfile.ts:应用级或Module级的编译构建任务脚本,开发者可以自定义编译构建工具版本、控制构建行为的配置参数。

obfuscation-rules.txt:混淆规则文件。

oh-package.json5:用于存放依赖库的三方库和共享包信息。

2、编译包结构

不同类型的Module编译后会生成对应的HAP、HAR、HSP等文件,开发态视图与编译态视图的对照关系如下:

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

  • ets目录:ArkTS源码编译生成.abc文件。
  • resources目录:AppScope目录下的资源文件会合入到Module下面资源目录中。
  • module配置文件:AppScope目录下的app.json5文件字段会合入到Module下面的module.json5文件。

3、发布态包结构

每个应用中至少包含一个.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等信息。

4、HAP、HAR、HSP使用总结

Module类型 包类型 说明
Ability HAP 应用个功能模块,可独立运行,可包含一个或多个feature类型的HAP
Static Library HAR 静态共享包,编译态服用(应用内、二方库、三方库)
Shared Library HSP 动态共享包,运行时复用。多包同时引用HSP时,代码和资源不会重复拷贝。
相关推荐
程序猿追9 小时前
kotlin-retry 接入鸿蒙后,怎样确认它真的会停止重试
开发语言·kotlin·harmonyos
懿路向前13 小时前
HarmonyOS 粒子特效实战:emitter.size 是双刃剑:粒子精确定位 [0,0] 与条带随机出生(HarmonyOS)
华为·harmonyos
马剑威(威哥爱编程)13 小时前
【共创稿事节】HarmonyOS 7 Agent 开发实战 04:云端 RAG 搭企业私有知识库问答
人工智能·华为·harmonyos
贾伟康13 小时前
【晨迹相机|20】HarmonyOS ArkTS AppGallery 发布复查实战:核对包名、版本、设备、素材和离线声明
harmonyos·arkts·appgallery·发布审核·上架复查
特立独行的猫a14 小时前
用仓颉写桌面应用:从 npx 建工程到串口实时示波器
开源·harmonyos·tauri·仓颉·cj-tarui
懿路向前16 小时前
HarmonyOS 粒子特效实战:马赛克切块提速 17.6×~38×:desiredRegion 重复读盘与一次解码管线(HarmonyOS)
华为·harmonyos
天府云创17 小时前
Agentic开发时代到来——鸿蒙PC三大原生开发工具公测
华为·操作系统·harmonyos·鸿蒙系统·cli·deveco·agentic
程序猿追17 小时前
Fleks 鸿蒙适配:从八个小球看实体和组件的变化
华为·harmonyos
Sunny_GMF18 小时前
Markdown 导出 HTML 实战:2.6MB 编辑器快照如何瘦身 71%(DOM 净化 + CSSOM 运行时裁剪)
编辑器·html·ai编程·harmonyos
m0_7381858218 小时前
Flutter 鸿蒙化实战:the_apple_sign_in 适配 OpenHarmony,Apple 登录
flutter·华为·harmonyos·鸿蒙