鸿蒙应用开发-实用技巧-Har包上传OpenHarmony三方库中心仓本文将为大家详细介绍如何将鸿蒙应用的Har包上传至

鸿蒙NEXT配图.webp

前文

本文将为大家详细介绍如何将鸿蒙应用的Har包上传至OpenHarmony三方库中心仓。通过本文的步骤指导，你将能够轻松完成从注册、认证到上传Har包的全流程。

登录与注册

首先，访问OpenHarmony三方库中心仓的官方网站 OpenHarmony三方库中心。

若还未注册账户，点击页面中的“注册”按钮进行账户注册。注册后使用账户信息登录系统。

截屏2024-09-29 16.39.38.png

进入个人中心

登录成功后，点击页面右上角的头像，进入“个人中心”。

截屏2024-09-29 17.01.32.png

认证管理

截屏2024-09-29 17.08.13.png

为了上传Har包，你需要先配置SSH公钥。执行以下命令生成一个新的RSA公钥：

ssh-keygen -m PEM -t RSA -b 4096 -f ~/.ssh_ohpm/<YOUR_SSH_FILE_NAME>

请务必设置密码，发布不支持空密码。

接下来，使用如下命令将密钥配置到ohpm中：

ohpm config set key_path ~/.ssh_ohpm/<YOUR_SSH_FILE_NAME>

新增组织管理

在“组织管理”中，你可以新增一个组织，便于日后管理多个库。例如，如果你的组织名称为“pharos”，那么Har包的外部依赖命名可以为 @你的组织名称/你的组件名称,例:@pharos/pin_code_text_input，使得包管理更加直观和规范。

截屏2024-09-29 17.07.27.png

新增完毕后，需等待系统认证，认证通过后会有消息通知。

创建你的库

在完成个人和组织认证后，你便可以创建自己的Har库。请注意，上传至OpenHarmony三方库中心仓的库必须是静态包，即Har包。

截屏2024-09-29 16.48.49.png

确保库的类型为Har包

在创建库时，若选择错误，可以通过修改 hvigorfile.ts 文件来纠正：

import { harTasks } from '@ohos/hvigor-ohos-plugin';

export default {
    system: harTasks,  /* Hvigor内置插件，不可修改 */
    plugins: []        /* 可用于扩展Hvigor功能的自定义插件 */
}

同时，确保 src/main/module.json5 中的模块类型为 har：

{
  "module": {
    "name": "YOU_MODULE_NAME", // 模块名称
    "type": "har", // 确保类型为har
    "description": "$string:desc", // 模块描述
    "deviceTypes": [
      "phone",
      ...
    ]
  }
}

配置对外依赖包

为了便于外部项目引用你的Har包，你需要修改 YOU_MODULE_NAME/oh-package.json5 文件：

{
  "name": "@你的组织名称/你的组件名称",
  "version": "0.0.1",
  "description": "请描述组件的基本信息",  // 直接写描述不要使用$string:xxx, 
  "main": "Index.ets",
  "author": "作者姓名",
  "license": "MulanPSL-2.0", // 发布时需要指定开源许可证
  "repository": "代码地址",
  "dependencies": {} // 无其它依赖需要空不要删除 'dependencies'
}

description 填写的内容将直接显示在这里, 如果你资源描述 $string:xxx, 这里会直接显示 $string:xxx 截屏2024-09-30 10.51.10.png

完善Har包目录

在Har包的目录中，确保存在以下文件：

README.md：提供组件的详细使用说明。
CHANGELOG.md：记录每个版本的更新内容。

截屏2024-09-29 17.14.58.png

LICENSE：开源许可证。

这些文件是Har包发布的必要部分，缺少任何一个都会导致上传失败。 具体详细内容可查看OpenHarmony三方库中心-帮助。

构建Har

截屏2024-09-29 17.31.25.png

发布准备

登录OpenHarmony三方库中心仓，从【个人中心】页面中【复制发布码】

配置到 .ohpmrc 文件中 publish_id 字段上，可执行如下命令：

ohpm config set publish_id YOUR_PUBLISH_ID

配置发布地址：

ohpm config set publish_registry https://ohpm.openharmony.cn/ohpm

发布

先选中你要发布的Module, 在编译器中选择 Build -> Make Module 'YOUR_MODULE',

注意:一定要先选中你的Module在去点Build菜单

截屏2024-09-30 09.52.57.png

发布指令

ohpm publish <HAR路径>

你的<HAR路径>是你的module直接打包成的文件<MODULE>/build/default/outputs/default/<MODULE>.har, 例如:

ohpm publish build/default/outputs/default/PinCodeTextInput.har

发布完毕

ohpm WARN: The HAR package to be uploaded contains source code, which may cause code asset leakage. Please abort if you do not want to procceed.
what is your passphrase of the private key: **********
+@pharos/pin_code_text_input 0.0.1 
Thanks for your contribution, the submitted OHPM library is under review, you can check the package status from https://ohpm.openharmony.cn/#/cn/personalCenter/package

OpenHarmony三方库中心仓 -> 个人中心 -> package 查询审核状态

通过以上步骤，便可完成Har包的创建与上传流程。希望本文能够帮助你顺利将鸿蒙应用的Har包上传至OpenHarmony三方库中心仓！

鸿蒙应用开发-实用技巧-Har包上传OpenHarmony三方库中心仓

前文