• Lv0
    粉丝20

积分1123 / 贡献0

提问0答案被采纳62文章8

[经验分享] OpenHarmony三方库中心仓审核的那些要求~ 原创 精华

马迪 显示全部楼层 发表于 2023-11-23 09:17:33
本帖最后由 马迪 于 2023-11-23 09:24 编辑

近期部分开发者反馈ohpm publish 三方库后,不知道什么时候可以上架,也不知道驳回的原因,因此借论坛这给大家说明一下:

1.发布后,可以在中心仓网站个人消息处查看发布的结果。如果审核通过后,也可以在中心仓直接搜索到这个三方库。
   如果审核不过的话,驳回的原因可能因为系统的bug会看不到。这个问题我已经反馈了,说是会在12月上旬修复。
fakename.png
2.审核不过,大概率是由于以下原因所致:

原因1:无功能
目前针对一些helloworld,test的三方库,为了避免生态初期中心仓上有很多无用的库,所以直接打回。

原因2:库命名规范
主要针对占用他人已知的、著名的包名,或者滥用他人的包名权益。  如果大家是基于xxx开源组件改的库,建议在名字上加个后缀或者是加个组织名,比如@xxx/库原名,便于跟原库区分开来。

原因3:Readme内容
建议ReadMe中包含简介,下载安装,所需权限,使用示例,接口说明,约束与限制(支持API几,SDK版本),目录结构,贡献代码,开源协议。  之所以有这些要求,也是便于开发者使用。

另外还有一些建议,希望大家能遵从,但不作严格审查:
1.License文件
2.ChangeLog文件
3.开源代码仓库,内含样例demo
  地址写在oh-package.json5的repository字段中,这样中心仓界面可以有个链接跳转到代码仓库
fakename.png

4.版本命名规范
建议参考Angular的 https://angular.io/guide/releases 的版本命名规范:
版本名为Major.Minor.Patch
其中Patch release为bug修改;Minor release为增加了新的特性,但API兼容;Major release表示大的重构和API变化。

注意: 三方库还未审核通过时,可以重新publish覆盖。 如果已经审核通过了,就必须用新的版本发布了。目前无主动下架的功能。

©著作权归作者所有,转载或内容合作请联系作者

您尚未登录,无法参与评论,登录后可以:
参与开源共建问题交流
认同或收藏高质量问答
获取积分成为开源共建先驱

精彩评论1

hyacinth养花人

沙发 发表于 2024-5-16 09:27:17
好文章,每次记不住就重新看下

Copyright   ©2023  OpenHarmony开发者论坛  京ICP备2020036654号-3 |技术支持 Discuz!

返回顶部