OpenHarmony开发者论坛

标题: OpenHarmony三方库中心仓审核的那些要求~ [打印本页]

作者: 马迪    时间: 2023-11-23 09:17
标题: OpenHarmony三方库中心仓审核的那些要求~
本帖最后由 马迪 于 2023-11-23 09:24 编辑

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

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

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

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

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

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

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

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

作者: hyacinth养花人    时间: 2024-5-16 09:27
好文章,每次记不住就重新看下




欢迎光临 OpenHarmony开发者论坛 (https://forums.openharmony.cn/) Powered by Discuz! X3.5