本文同步发表于我的微信公众号，微信搜索 程语新视界 即可关注，每个工作日都有文章更新

一、发布前的准备

1.1 支持范围

• OpenHarmony 三方库中心仓仅支持 HAR 共享包发布

• 不支持 HSP 共享包发布

• 如需在应用内共享 HSP，可将 HSP 发布至私仓

  • 参考官方：ohpm 私仓搭建工具

1.2 HAR 模块文件准备

在 HAR 模块根目录（与 src 文件夹同级）下必须添加以下文件：

README.md 文件

• 必须包含：

  • 包的介绍说明

  • 引用方式示例

• 建议包含：

  • 功能特性列表

  • 详细使用指南

  • API 文档说明

内容示例：

# 工具库说明
这是一个提供通用工具函数的共享包。

## 安装方式
```json
// oh-package.json5 中添加：
"dependencies": {
  "utils": "1.0.0"
}

主要功能

• 日期格式化

• 数据验证

• 加密解密

#### **CHANGELOG.md 文件**
- 记录 HAR 的**版本更新历史**
- 遵循语义化版本控制规范

示例：
```markdown
# 更新日志

## [1.1.0] - 2024-06-15
### 新增
- 添加数据加密功能
- 新增网络请求工具

## [1.0.0] - 2024-05-20
### 初始版本
- 基础工具函数集合

LICENSE 文件

• 包含软件许可协议

• 明确授权条款和使用限制

二、编译生成 HAR

2.1 编译步骤

1. 按照 编译 HAR 模块 的流程操作

2. 生成 *.har 文件

2.2 注意事项

• 如果修改了 oh-package.json5 文件中的 version 字段：

  1. 先执行 Build > Clean Project

  2. 再执行 Build 全量构建

• 确保版本号符合语义化版本规范（如：1.0.0）

三、SSH 密钥配置

3.1 生成公私钥对

执行以下命令生成 RSA 密钥对：

ssh-keygen -m PEM -t RSA -b 4096 -f ~/.ssh_ohpm/my_private_key

参数说明：

• -m PEM：指定 PEM 格式

• -t RSA：使用 RSA 算法

• -b 4096：密钥长度 4096 位

• -f ~/.ssh_ohpm/my_private_key：指定私钥文件路径

3.2 密钥管理说明

• 私钥文件：my_private_key（无后缀）

• 公钥文件：my_private_key.pub（自动生成，追加 .pub 后缀）

• 目录要求：指定的私钥存储目录必须已存在

• 密码要求：OHPM 只支持加密密钥认证，生成时必须输入密码

四、OpenHarmony 中心仓配置

4.1 上传公钥

1. 登录 OpenHarmony 三方库中心仓

2. 单击主页右上角个人中心

3. 选择新增 OHPM 公钥

4. 将公钥文件内容（my_private_key.pub）完整粘贴到公钥输入框中

4.2 配置本地环境

配置私钥路径：

ohpm config set key_path ~/.ssh_ohpm/my_private_key

配置发布码：

1. 在个人中心复制发布码

2. 执行以下命令配置：

ohpm config set publish_id your_publish_code_here

五、发布 HAR 包

5.1 发布命令

执行以下命令发布 HAR：

ohpm publish <HAR文件具体路径>

示例：

ohpm publish ./mylibrary/build/mylibrary.har

5.2 发布验证

• 发布成功后，可在 OpenHarmony 三方库中心仓查看已发布的包

• 也可以通过 ohpm 安装使用：

// 在其他项目的 oh-package.json5 中：
"dependencies": {
  "mylibrary": "1.0.0"
}

六、发布流程总结

1. 文档准备 → 创建 README.md、CHANGELOG.md、LICENSE 文件

2. 版本确认 → 检查并更新 oh-package.json5 中的 version 字段

3. 清理构建 → 执行 Clean Project 后重新构建生成 HAR

4. 密钥生成 → 使用 ssh-keygen 创建加密的 RSA 密钥对

5. 公钥上传 → 在中心仓个人中心配置公钥

6. 本地配置 → 设置私钥路径和发布码到 .ohpmrc 文件

7. 执行发布 → 使用 ohpm publish 命令上传 HAR 包

8. 验证发布 → 在中心仓确认包已成功发布

备注

• 版本管理：每次发布前确保更新版本号，遵循语义化版本规范

• 密钥安全：妥善保管私钥文件，不要泄露

• 文档完整：README.md 的质量直接影响其他开发者的使用体验

• 测试验证：发布前充分测试 HAR 包的功能完整性