前言
类似于 Android 项目中的 jar/aar ,鸿蒙肯定也是支持第三方依赖库的。
鸿蒙提供了 静态共享包 HAR(Harmony Archive) 和 动态共享包 HSP(Harmony Shared Package) 两种方式。根据官网的介绍:
HAR中的代码和资源跟随使用方编译,如果有多个使用方,它们的编译产物中会存在多份相同拷贝。
HSP中的代码和资源可以独立编译,运行时在一个进程中代码也只会存在一份。
看起来 HSP 应该是个更好的选择,但是 HSP 的限制又很多。
应用内 HSP 指的是专门为某一应用开发的HSP,只能被该应用内部其他HAP/HSP使用,用于应用内部代码、资源的共享。
应用间 HSP 暂不支持。
所以,理论上,HSP 只支持应用内部源码编译,应用内 HAP 可以共享使用。
如果是需要公开发布产物的 sdk 的话,目前只能选择 HAR 。
准备工作
-
首先到 OpenHarmony 三方库中心仓[1] 注册账号,进入到个人中心页面。
-
执行
ssh-keygen -m PEM -t RSA -b 4096 -f your_key_path
生成公私钥对,在个人中心 -》认证管理 -》 新增,填入公钥内容。 -
执行
ohpm config set key_path your_key_path
配置私钥路径。 -
个人中心 头像下方,点击复制发布码。
-
执行
ohpm config set publish_id your_publish_id
配置发布码。
准备工作完成。
编写依赖库
以写 WanHarmony[2] 的过程中,编写的一个标签布局组件为例,进行发布过程。
代码实现很简单,总共两个文件,且都需要对外暴露。
HAR 中需要导出的组件/接口,除了常规的 export 修饰符之外,还需要在 Index.ets
中进行声明。
export { FlowLayout } from './src/main/ets/components/flowlayout/FlowLayout'
export { FlowLayoutConfig } from './src/main/ets/components/flowlayout/FlowLayoutConfig'
然后配置到 oh-packages.json5
文件中:
{
"main": "Index.ets"
}
其他的一些项目配置:
-
README.md
: 必须包含包的介绍和引用方式,如果没有包含安装命令ohpm install xxx
,审核会被拒 -
CHANGELOG.md
: 更新记录 -
LICENSE
文件
oh-package.json5
这里是依赖库的一些发布信息。示例如下:
{
"name": "@luyao/flowlayout", // 必选,@group/packagename
"version": "1.0.0", // 必须,版本号,从 1.0.0 开始
"description": " xxxx", // 必须,必须大于一定字符,好像是 32
"keywords": ['flowlayout'], // 可选
"main": "Index.ets", // 必须,入口文件
"author": "luyao", // 必须
"homepage": "https://github.com/lulululbj/WanHarmony",
"license": "Apache-2.0", // 必须
"dependencies": {} // 可选,用到的依赖
}
完整介绍在这里:https://ohpm.openharmony.cn/#/cn/help/createfile
发布
首先要构建 HAR 产物,选中依赖库的 module,工具栏 Build -》 Make,产物在依赖库 Module 的 build/default/outputs/default/xxx.har
。
执行发布命令,发布过程中会要求输入密码。
ohpm publish <HAR路径>
不出意外的话,应该就发布成功了。但一般情况,肯定是会发生意外的。
如果你遇到这个错误:
说明你在 oh-package.json 文件中的 name 属性填写的组织未经过认证。比如我填写的是 @luyao/flowlayout
,luyao
这个组织就是未经认证的。
但也不麻烦,申请一下就行。到 OpenHarmony 三方库中心仓[3] 的 个人中心 -》组织管理 -》新增,然后等到审核通过即可。
截止完成本文,因为没有说明安装命令被拒一次,后续如果发布成功,在这个 https://ohpm.openharmony.cn/#/cn/detail/@luyao%2Fflowlayout 地址应该可以看到我发布的库。
资料推荐
-
如何创建 HAR[4] 来自 OpenHarmony 网站
-
发布 HAR[5] 来自 HarmonyOS 网站
-
创建及发布三方库[6] 来自 OpenHarmony 三方库中心仓文档 OpeOpenHarmony三方库中心仓rmony三方库中心仓
参考资料
[1]
OpenHarmony 三方库中心仓: https://ohpm.openharmony.cn/#/cn/home
[2]
WanHarmony: https://github.com/lulululbj/WanHarmony
[3]
OpenHarmony 三方库中心仓: https://ohpm.openharmony.cn/#/cn/personalCenter/organizations
[4]
如何创建 HAR: https://docs.openharmony.cn/pages/v4.0/zh-cn/application-dev/quick-start/har-package.md/
[5]
发布 HAR: https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/creating_har_api9-0000001518082393-V3#section1213451811512
[6]
创建及发布三方库: https://ohpm.openharmony.cn/#/cn/help/createandpublish
转自:如何发布鸿蒙三方库