鸿蒙 动态共享包HSP的创建和引用

1.什么是动态共享包HSP

HSP（Harmony Shared Package）是动态共享包，可以包含代码、C++库、资源和配置文件，通过HSP可以实现代码和资源的共享。HSP不支持独立发布，而是跟随其宿主应用的APP包一起发布，与宿主应用同进程，具有相同的包名和生命周期。

说明：

应用内HSP：在编译过程中与应用包名（bundleName）强耦合，只能给某个特定的应用使用。

集成态HSP：构建、发布过程中，不与特定的应用包名耦合；使用时，工具链支持自动将集成态HSP的包名替换成宿主应用包名。

2.使用场景

• 多个HAP/HSP共用的代码和资源放在同一个HSP中，可以提高代码、资源的可重用性和可维护性，同时编译打包时也只保留一份HSP代码和资源，能够有效控制应用包大小。

• HSP在运行时按需加载，有助于提升应用性能。

• 同一个组织内部的多个应用之间，可以使用集成态HSP实现代码和资源的共享。

HSP旨在解决HAR存在的几个问题：

• 多个HAP引用相同的HAR，导致的APP包大小膨胀问题。

• 多个HAP引用相同的HAR，HAR中的一些状态变量无法共享的问题。

3.约束限制

• HSP不支持在设备上单独安装/运行，需要与依赖该HSP的HAP一起安装/运行。HSP的版本号必须与HAP版本号一致。
• HSP不支持在配置文件中声明UIAbility组件与ExtensionAbility组件。
• HSP可以依赖其他HAR或HSP，但不支持循环依赖，也不支持依赖传递。
• 集成态HSP只支持Stage模型。
• 集成态HSP需要API12及以上版本，使用标准化的OHMUrl格式。

4.创建动态共享包

（1）点击选择FIile>New > Module

（2）模板类型选择Shared Library，点击Next。

(3)在Configure New Module界面中，设置新添加的模块信息，设置完成后，单击Finish完成创建

• Module name：新增模块的名称。
• Device type：支持的设备类型。
• Enable native：是否创建一个用于调用C++代码的模块。

(4)创建完成后，会在工程目录中生成库模块及相关文件。

Index.ets如下：

5.编译HSP模块

开发完库模块后，选中模块名，然后通过DevEco Studio菜单栏的Build > Make Module ${libraryName}进行编译构建，生成HSP。

打包HSP时，会同时默认打包出HAR，在模块下build目录下可以看到*.har和*.hsp。

6.上传私仓

如需在应用内共享HSP，请将HSP共享包上传至私仓（请参考将三方库发布到 ohpm-repo），请先按以下操作编译生成*.tgz包。

（1.）将编译模式切换成release模式。

（2.）选中HSP模块的根目录，点击Build > Make Module ${libraryName}启动构建

（3.）构建完成后，build目录下生成HSP包产物，其中.tgz用来上传至私仓。

7.引用

（1. ）在使用方entry/feature模块的oh-package.json5文件中添加HSP模块引用

（2.）如果没有安装“ohpm install”，点击Run 'ohpm install'，HSP目录将映射到entry/feature的oh_modules目录下

（3.）使用

点击 “Edit Configurations...”

(4.)引用HSP下的utils/Calc.ets/add方法

运行结果如下：

8.发布共享包 

在之前的静态共享包里面已经介绍 静态共享包HAR的创建和引用_hsp和har-CSDN博客