HarmonyOS 鸿蒙Next：har和hsp的转换

发布于 1周前 作者 htzhanglong 来自 鸿蒙OS

HarmonyOS 鸿蒙Next：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包放到引用模块下依赖：

更多关于HarmonyOS 鸿蒙Next：har和hsp的转换的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html

Harmonyos Next教程
3 回复 
har转换hsp后，启动崩溃

Error message: cannot find record '******/utils/', please check the request path '/data/storage/el1/bundle/utils/ets/modules.abc'.

Stacktrace:

SourceMap is not initialized yet

更多关于HarmonyOS 鸿蒙Next：har和hsp的转换的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


转换为hsp后首先看打包是否能生成hsp包，运行过程中如出现cppCrash请提供完整堆栈用于定位问题，如果是jsCrash请根据错误指向代码确认该配置是否正常。

在HarmonyOS（鸿蒙）系统中，har和hsp文件是与应用包和资源管理相关的文件格式。har文件通常指的是HarmonyOS应用包（HApp Archive），而hsp文件可能是指某种特定于鸿蒙系统的资源包或配置文件格式（注意：hsp并非鸿蒙官方文档中明确提及的标准文件格式，这里基于假设进行解释）。

关于har和hsp的转换，需要明确的是，鸿蒙系统并没有提供直接的命令行工具或API来进行这两种文件格式之间的转换。har文件主要用于应用的分发和安装，包含了应用的代码、资源、配置文件等，而hsp文件的具体用途和格式可能需要参考具体的应用或开发框架文档。

如果需要在har和某种资源格式（假设为hsp）之间进行转换，可能需要采取以下步骤：

  1. 解包har文件：使用鸿蒙提供的工具或第三方工具解压缩har文件，获取其中的资源文件。
  2. 资源处理：根据hsp文件的格式要求，对从har文件中提取的资源进行处理或转换。
  3. 打包为hsp：如果hsp是某种特定的打包格式，可能需要使用相应的打包工具或脚本来生成hsp文件。

请注意，以上步骤基于假设和一般经验，实际操作可能因具体的应用、开发框架或鸿蒙系统版本而有所不同。如果问题依旧没法解决请联系官网客服，官网地址是：。

回到顶部