HarmonyOS鸿蒙开发：har和hsp包的转换场景

一、场景描述

伙伴开发过程中可能会遇到共享包转型场景，主要有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包：

最后

小编在之前的鸿蒙系统扫盲中，有很多朋友给我留言，不同的角度的问了一些问题，我明显感觉到一点，那就是许多人参与鸿蒙开发，但是又不知道从哪里下手，因为资料太多，太杂，教授的人也多，无从选择。有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）文档用来跟着学习是非常有必要的。 

为了确保高效学习，建议规划清晰的学习路线，涵盖以下关键阶段：

 →【纯血版鸿蒙全套最新学习文档】希望这一份鸿蒙学习文档能够给大家带来帮助~

---

 鸿蒙（HarmonyOS NEXT）最新学习路线

​

该路线图包含基础技能、就业必备技能、多媒体技术、六大电商APP、进阶高级技能、实战就业级设备开发，不仅补充了华为官网未涉及的解决方案

路线图适合人群：

IT开发人员：想要拓展职业边界
零基础小白：鸿蒙爱好者，希望从0到1学习，增加一项技能。
技术提升/进阶跳槽：发展瓶颈期，提升职场竞争力，快速掌握鸿蒙技术

2.学习视频+学习PDF文档

HarmonyOS Next 最新全套视频教程 （鸿蒙语法ArkTS、TypeScript、ArkUI教程……）

​​

 纯血版鸿蒙全套学习文档（面试、文档、全套视频等）

                   

​​​​鸿蒙APP开发必备

​​

总结

【纯血版鸿蒙全套最新学习文档】

总的来说，华为鸿蒙不再兼容安卓，对程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，才能在这个变革的时代中立于不败之地。