【HarmonyOS开发】共享包HAR和HSP的创建和使用以及三方库的发布

OpenHarmony提供了两种共享包，HAR（Harmony Archive）静态共享包，和HSP（Harmony Shared Package）动态共享包。 

HAR与HSP都是为了实现代码和资源的共享，都可以包含代码、C++库、资源和配置文件，最大的不同之处在于：HAR中的代码和资源跟随使用方编译，如果有多个使用方，它们的编译产物中会存在多份相同拷贝；而HSP中的代码和资源可以独立编译，运行时在一个进程中代码也只会存在一份。

1、HAR：静态共享包（模块）

1.1 创建/编译

1.2 引用/使用

1.2.1 从ohpm三方库中引用

ohpm install 发布成功的包名(eg: @ohos/lottie)

1.2.2 从本地引用HAR包

ohpm install ./package.har

开发及引用静态共享包https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/creating_har_api9-0000001518082393-V3#section143510369612

1.3 发布我们的HAR包到三方开源库

1.3.1 OpenHarmony中心仓创建账号

OpenHarmony三方库中心仓https://ohpm.openharmony.cn/#/cn/personalCenter/notifications

1.3.2 利用工具ssh-keygen生成公钥和私钥文件

// /d/SSH/ohpm.pub为密钥存放的位置
ssh-keygen -m PEM -t RSA -b 4096 -f /d/SSH/ohpm-test.pub
 
// 输入量两次一致的密码，即可自动生成密钥
Enter passphrase (empty for no passphrase):
Enter same passphrase again:

1.3.3 OpenHarmony中心仓中配置ohpm公钥

注册成功后，进入个人中心【认证管理】，用我们生成的密钥，进行配置，具体见下图：

1.3.4 配置本地的环境变量.ohrmrc

// 1、配置私钥，d/SSH/ohpm.pub为我们生成的私钥文件位置
ohpm config set key_path d/SSH/ohpm-test.pub

// 2、配置发布码：publish_id，或者找到.ohrmrc直接修改publish_id字段
ohpm config set publish_id CQF******Z

// 结果
// ohpm WARN: invalid config key_path="d/SSH/ohpm.pub" set in C:\Users\*****\.ohpm\.ohpmrc - invalid filesystem path.

1.3.5 发布HAR到三方库

// 1、执行推包命令
ohpm publish D:\workspace-hw-OS\HAR\GridEdit.har

// 2、输入开源仓配置的密码即可完成

1.3.6 三方库审核

审核通过，即可通过ohpm从开源仓下载我们的包

工具扫描包括完整性检查与安全性检查两部分。完整性检查将基于创建三方库的具体要求进行三方库目录、内容审核，如果您提交的三方库缺少必要性文件，三方库将被退回，请您根据提示完善三方库内容后再次提交上架审核；安全性检查将结合目前已有的安全检测工具，对三方库进行定期检测。

1.3.7 发布失败问题整理

• 模块源码中缺少文件

  • 缺少开源声明文件：ohpm ERROR: HttpCode 400 The OHPM package must contain a non-empty license file.

  • 缺少README.md说明文件：ohpm ERROR: HttpCode 400 The OHPM package must contain a non-empty readme.md file.

  • 缺少GHANGELOG.md版本说明文件：ohpm ERROR: HttpCode 400 The OHPM package must contain a non-empty changelog.md file.

2、HSP：动态共享包（模块）

2.1 创建/编译

2.2 引用

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

{
  ...
  "dependencies": {
    "sharedlibrary": "file:../libraryTest"
  }
}

2.2.2 点击执行 Run 'ohpm install'

HSP目录将映射到entry/feature的oh_modules目录下

2.3 使用

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

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

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

HSP的一些约束：

• HSP及其使用方都必须是Stage模型。

• HSP及其使用方都必须使用esmodule编译模式。

• HSP不支持在配置文件中声明abilities、extensionAbilities标签。