1. HarmonyOS hsp制作与引用
1.1 介绍
HSP动态共享包(模块),应用内HSP指的是专门为某一应用开发的HSP,只能被该应用内部其他HAP/HSP使用,用于应用内部代码、资源的共享。应用内HSP跟随其宿主应用的APP包一起发布,与该宿主应用具有相同的包名和生命周期。官网文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V2/in-app-hsp-0000001523312158-V2
对于企业大型应用开发,有部分公共的资源和代码,只能在开发态静态共享,并且打包到每个依赖的HAP里,这样导致包体积较大,且有重复多份公共资源和代码重复打包到应用中。
为了解决运行态状态无法共享,以及减少包体积,让多个HAP能够共享同一公共资源代码,DevEco Studio支持动态共享包HSP(Harmony Shared Package)。
应用内HSP指的是专门为某一应用开发的HSP,只能被该应用内部其他HAP/HSP使用,用于应用内部代码、资源的共享。 应用内HSP跟随其宿主应用的APP包一起发布,与该宿主应用具有相同的包名和生命周期。
当前暂不支持跨应用共享包。一个项目自能有一个HSP包。
1.1.1 HSP旨在解决HAR存在的几个问题
(1)多个HAP引用相同的HAR,导致的APP包大小膨胀问题。
(2)多个HAP引用相同的HAR,HAR中的一些状态变量无法共享的问题。
1.1.2 HSP的一些约束
(1)HSP及其使用方都必须是Stage模型。
(2)HSP及其使用方都必须使用esmodule编译模式。
(3)HSP不支持在配置文件中声明abilities、extensionAbilities标签。
1.2 流程
1.2.1 创建步骤
该工程为Stage模型,在工程中创建HAR模块。
(1)点击项目右键=>New=>Module
(2)New Module选择Static Library
(3)在该Module的build-profile.json5中添加"artifactType": "obfuscation"开启代码混淆
(4)编辑Hsp包
(5)编译构建的HSP可在模块下的build目录下获取,包格式为.hsp。*
1.2.2 在使用方模块中引用HSP
在使用方entry/feature模块的oh-package.json5文件中添加HSP模块引用,以引用名为sharedlibrary的HSP为例:
(1)Add.ets
{..."dependencies": {"sharedlibrary": "file:../sharedlibrary"}
}
添加引用后,dependencies字段内的片段将出现报错:
将鼠标放置在报错处会出现提示,在提示框中点击Run ‘ohpm install’。
1.3 运行引用HSP的使用方模块
连接本地真机或本地模拟器。
单击Run > Edit Configurations,选择Deploy Multi Hap标签页,勾选Deploy Multi Hap Packages,选择使用方模块(如entry)和HSP模块(如sharedlibrary),点击OK。
单击Run > Run’模块名称’(如Run ‘entry’)或。
DevEco Studio会启动应用/服务的编译构建,完成后应用/服务即可运行在本地真机或模拟器上。