本章说的是如何贡献三方库,打造一个属于自己的三方库,成功的发布到OpenHarmony三方库中心仓
1.创建三方库
- 打开DevEco Studio创建一个项目,然后创建一个库模块,选择static library。详细步骤可参考:开发静态共享包。
- 对所创建的库模块进行开发,需要完善库模块中生成的 oh-package.json5 文件,有关三方库名称的规则,请参阅三方库名称指南章节,其他配置项的设置请参考oh-package.json5配置说明。
- 在库模块的根目录中,创建一个 README.md 文件,描述您三方库的代码以及如何使用它,文件不能为空。
- 在库模块的根目录中,创建一个 CHANGELOG.md 文件,描述您三方库的代码不同版本的变更内容,文件不能为空。
- 在库模块的根目录中,创建一个 LICENSE 文件,指定该软件包可以在什么样的许可下被使用、修改和共享,文件不能为空。
- 利用 DevEco Studio 对开发后的库模块打成 HAR 包。( 详情请见:构建闭源HAR)
2.本地测试
写好之后一定要测试,测试是否可以正常使用
3.发布三方库
1. 创建账号并且登录
HarmonyOS是华为推出的自主研发的分布式操作系统,旨在为各种设备提供无缝的连接和协同工作的体验。而OpenHarmony是HarmonyOS的开源版本,是由开源社区维护的一个开源项目。OpenHarmony是基于HarmonyOS代码开发的,旨在为社区开发者提供一个完全开放和透明的开发平台,帮助他们为更多设备开发应用程序和服务。
因此,HarmonyOS和OpenHarmony之间的关系是,HarmonyOS是华为自主开发的分布式操作系统,而OpenHarmony是其开源版本,由开源社区维护的一个项目,为开发者提供更多的开发机会和资源。两者都是为了推动分布式操作系统的发展,实现设备之间的无缝连接和协同工作。
相同点:1-都是华为研发的,2-都是分布式操作系统
不同点:1-HarmonyOS商业华为自己用,OpenHarmony开源大家用;2先有HarmonyOS于19年发布,再OpenHarmony于20年发布
OpenHarmony 是由开放原子开源基金会孵化及运营的开源项目,由开放原子开源基金会 OpenHarmony 项目群工作委员会负责运作。
atomgit.com/ 【开放原子开源基金会】【代码托管平台】
ohpm.openharmony.cn/#/cn/home 【OpenHarmony三方库中心仓】
2. 认证管理(OHPM公钥)
OpenHarmony 三方库中心仓 和 ohpm-cli 命令行工具的通信(查询、下载、发布),需要建立可信的安全通道,可以按如下步骤进行配置 OHPM 公钥。
- 在进行 publish 发布前,请先确保在OpenHarmony三方库中心仓上已经创建了帐号,且利用工具 ssh-keygen 生成公、私钥文件,可执行以下命令:
ssh-keygen -m PEM -t RSA -b 4096 -f ~/.ssh_ohpm/mykey
说明:
~/.ssh_ohpm/mykey为私钥文件mykey的文件路径(按照实际情况指定,win和mac不同,一定要重新配,不然肯定过不去)。指定的私钥存储目录必须存在。追加了.pub后缀的相应公钥文件会在与私钥相同的目录中生成。
注意:OHPM包管理器只支持加密密钥认证,请在生成公私钥时输入密码(密码不显示,直接输入就对了,相信自己)。
- 请将公钥上传至OpenHarmony三方库中心仓【个人中心】-【认证管理】下:点击页面左上角的“新增”按钮,并将公钥文件(mykey.pub)的内容粘贴到公钥输入框中。
- 请将对应私钥文件路径配置到 .ohpmrc 文件中 key_path 字段上,可执行以下命令进行配置:
ohpm config set key_path ~/.ssh_ohpm/mykey
3. 本地绑定发布码 登录OpenHarmony三方库中心仓,从 【个人中心】页面中【复制发布码】,并配置到 .ohpmrc 文件中 publish_id 字段上,可执行如下命令:
ohpm config set publish_id your_publish_id(看清楚,your_publish_id是你的发布码,兄弟们)
4. 本地配置发布地址
ohpm config set publish_registry https://ohpm.openharmony.cn/ohpm
5. 发布HAR包 执行如下命令发布HAR,<HAR路径>请指定为待发布HAR的具体路径
ohpm publish <HAR路径>
publish 命令其他使用方法及相关规则,请参阅 ohpm publish 常用命令章节。
发布成功之后,ohpm 将会给您的账户发送“创建上架审核单成功”通知,您可登录OpenHarmony三方库中心仓,进入个人中心界面,关注【消息】通知。
审核通过之后将会给您的账户发送 “审核通过”通知,您可登录OpenHarmony三方库中心仓个人中心管理界面,关注【个人中心】-【消息】通知。