鸿蒙5.0实战案例:har和hsp的转换

发布于:2025-02-27 ⋅ 阅读:(9) ⋅ 点赞:(0)

往期推文全新看点(文中附带全新鸿蒙5.0全栈学习笔录)

✏️ 鸿蒙(HarmonyOS)北向开发知识点记录~

✏️ 鸿蒙(OpenHarmony)南向开发保姆级知识点汇总~

✏️ 鸿蒙应用开发与鸿蒙系统开发哪个更有前景?

✏️ 嵌入式开发适不适合做鸿蒙南向开发?看完这篇你就了解了~

✏️ 对于大前端开发来说,转鸿蒙开发究竟是福还是祸?

✏️ 鸿蒙岗位需求突增!移动端、PC端、IoT到底该怎么选?

✏️ 记录一场鸿蒙开发岗位面试经历~

✏️ 持续更新中……


一、场景描述

共享包选型: 应用模块化选型

伙伴开发过程中可能会遇到共享包转型场景,主要有hsp转har包和har转hsp包两种情况,由此经常要求提供har和hsp转换方案。共享包转换核心思路就是将配置文件统一,比如将hsp支持的配置文件转换为har的配置文件,主要涉及module.json5、hvigorfile.ts、build-profile.json5文件,以及路由方式切换等场景。

二、方案描述

场景一:hsp转har包

提供方hsp包转换

1.在hsp下的module.json5中,把"type": “shared"修改为"type”: “har”,删除"deliveryWithInstall"、"pages"字段。

2.由于har中不能声明page,需要先删除原hsp中module.json5的page声明;har不能用router.pushurl路由方式,需要修改原有router.pushurl路由为navigation(推荐)或命名路由跳转方式,以navigation为例,使用组件导航的demo如下:

左entry中Index页面,右har1中pageOne页面

若沿用router的方式,需要使用命名路由的方式,可参考官网指南: 命名路由

3.然后再找到hsp下的hvigorfile.ts文件,将里面的hspTasks改为harTasks。

4.(可选)如需要指定该library被依赖时的混淆规则(该项仅har模块可配置,详情可见 consumerFiles属性介绍 ,可在build-profile.json5添加配置"consumerFiles": ‘./consumer-rules.txt’ 。

5.清理重新安装打包(clean——>build)

引用方引用har包

转化前引用hsp包:

转换后引用har包:

源码方式依赖:

将产物har包放到引用模块下依赖:

场景二:har转hsp包

提供方har包转换

1.在har下的module.json5中,把"type": “har"修改为"type”: “shared”,添加"deliveryWithInstall"。

2.(可选)当Hsp需要对外声明router可跳转的page时,需要添加module.json5的"pages"字段,并在resources/base目录下建立profile/main_pages.json文件,添加配置参考如下,并在对应位置添加页面。

3.再找到har下的hvigorfile.ts文件,将里面的harTasks改为hspTasks。

4.har包的build-profile.json5默认会有"consumerFiles": ‘./consumer-rules.txt’ ,该项仅har模块可配置,为默认导出的混淆规则(详细描述见: 代码混淆 ),需将其删除。

5.清理重新安装打包(clean——>build)

引用方引用hsp包

转换前引用har包:

转换后引用hsp包: