如何发布第三方库到 OpenHarmony,并提交一个PR

2024-12-22 15:16:52
116次阅读
0个评论

1. 项目准备

创建一个新的Empty Ability项目,并在其中创建一个新的Library模块。这将是要发布的第三方库的基础。

2. 配置oh-package.json5

在的Library模块中,需要配置oh-package.json5文件。这个文件类似于npm的package.json,它包含了对当前三方库的元数据描述。确保文件中的配置项符合规范,并且包含必要的信息,如库的名称、版本、描述、入口文件、作者和开源协议等。

3. 生成HAR文件

选中的Library模块,点击Build,然后选择Make Module Library,这将生成一个HAR文件。HAR文件是OpenHarmony的二进制分发格式,类似于npm的包文件。生成的HAR文件将位于build/default/outputs/default目录下。

4. 注册OpenHarmony三方库账号

需要在OpenHarmony三方库中心仓注册一个账号。在注册过程中,需要配置公钥和私钥。生成公钥的命令为ssh-keygen -m PEM -t RSA -b 4096 -f your-keypath,然后将公钥粘贴到OpenHarmony三方库中心仓的【个人中心】-【认证管理】下。配置私钥路径可以通过执行ohpm config set key_path your-keypath命令来完成。最后,在个人中心复制发布码,并在命令行执行ohpm config set publish_id your-publishId。

5. 发布到三方库

执行ohpm publish logfishing.har命令,将生成的HAR文件发布到OpenHarmony三方库。发布成功后,的库将进入人工审核阶段。在发布正式库时,确保CHANGELOG.md、readme.md和oh-package.json5中的内容清晰准确,否则审核可能不通过。

6. 提交PR

在的库通过审核并成功发布后,可以提交一个Pull Request(PR)将的库合入到OpenHarmony的主仓库或相关的SIG仓库中。提交PR的具体步骤可以参考OpenHarmony的官方文档或相关教程,通常包括以下几个步骤:

  1. Fork目标仓库到自己的账号下。
  2. 克隆Fork后的仓库到本地。
  3. 在本地进行修改和提交。
  4. 将修改推送到的远程仓库。
  5. 在GitHub或Gitee上创建一个新的PR,选择的分支和目标分支,并填写相关的描述信息。
  6. 等待审核和合并。
  7. 在提交PR时,确保遵循OpenHarmony的贡献指南和代码规范,并且在PR描述中清晰地说明的修改内容和目的。

以上步骤综合了多个搜索结果中的信息,确保了发布第三方库到OpenHarmony并提交PR的过程的完整性和准确性。在实际操作时,请根据OpenHarmony的最新文档和指南进行操作,因为开源项目的流程和要求可能会随着时间的推移而变化。

收藏00

登录 后评论。没有帐号? 注册 一个。