发布三方库:将组件发布到OHPM仓库流程(268)
将组件发布到 OpenHarmony 三方库中心仓OHPM是一个严谨的流程整体可以分为账号准备、密钥配置、工程创建、打包构建、发布审核等核心步骤。以下是详细的操作指南1. 账号与组织准备前往 OpenHarmony 三方库中心仓ohpm.openharmony.cn注册账号并完成实名认证。如果需要以组织名义发布需在“组织管理”中新增组织包名需遵循组织名/包名的格式。2. 生成密钥与配置认证OHPM 使用 RSA 公私钥校验发布权限仅支持 PEM 格式。生成密钥使用ssh-keygen生成公私钥对生成时必须输入密码密码不能为空。bash编辑ssh-keygen -m PEM -t RSA -b 4096 -f ~/.ssh_ohpm/mykey上传公钥登录中心仓官网进入「个人中心」-「认证管理」新增 OHPM 公钥将mykey.pub的内容粘贴保存。配置私钥与发布码在命令行中配置私钥路径和从官网获取的发布码publish_id。bash编辑ohpm config set key_path ~/.ssh_ohpm/mykey ohpm config set publish_id your_publish_id3. 创建 Library 模块与完善必备文件创建模块在 DevEco Studio 中通过New Module Static Library创建一个静态库模块。完善配置文件确保模块级oh-package.json5包含必填字段如name,version,main,license且所有直接依赖必须在模块内声明完整不能依赖工程级配置。准备三个必备文件在库模块根目录与src同级下必须包含以下三个文件且内容不能为空README.md包含包的介绍和引用方式。CHANGELOG.md填写版本更新记录。LICENSE真实的许可证全文推荐 Apache-2.0。4. 编译打包 HAR选中 HAR 模块通过 DevEco Studio 菜单栏执行Build Make Module 模块名。安全警告请务必使用Release 模式构建避免使用 Debug 模式因为 Debug 包中会含有源码存在代码泄露风险。构建成功后会在build目录下生成.har文件。5. 发布与等待审核执行发布在命令行中指定.har文件的具体路径进行发布。bash编辑ohpm publish HAR路径执行后需输入生成密钥时设置的密码。等待审核发布成功后中心仓会发送“创建上架审核单成功”通知。审核通过后会发送“审核通过”通知此时其他开发者即可通过ohpm install安装使用。⚠️ 重要注意事项版本号唯一性一旦三方库以给定的名称和版本发布并审核通过该特定名称及版本号将被永久占用无法再次使用。后续迭代必须递增版本号。包大小限制从 ohpm 命令行 5.0.1 版本开始支持发布与下载最大 300M 的.har或.tgz包。敏感信息自检发布前请务必删除私钥、密码、个人信息等敏感数据避免造成安全与法律风险。