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

一、三方 HAR 引用方式

支持三种引用方式：

1. 从 ohpm 仓库安装（远程仓库）

2. 从本地文件夹安装（本地模块源码）

3. 从本地压缩包安装（本地 HAR/HSP 包）

二、仓库配置与设置

2.1 配置仓库地址

在 Terminal 中执行：

ohpm config set registry your_registry1,your_registry2

说明：

• 支持配置多个仓库地址，用英文逗号分隔

• DevEco Studio 默认使用 OpenHarmony 三方库中心仓

• 首次配置环境变量后需要重启 DevEco Studio

2.2 依赖配置方式

方式一：可视化界面

• 菜单栏：Tools > OHPM Index

• 进入内置的 OpenHarmony 开源中心仓

• 可视化选择和管理三方包

方式二：命令行安装

# 切换到目标模块目录
cd path/to/your/project/entry
# 安装指定包
ohpm install @ohos/animations

效果：自动在 oh-package.json5 中添加依赖

方式三：手动配置依赖

在模块的 oh-package.json5 中：

"dependencies": {
  "@ohos/animations": "^2.1.0"
}

配置后需要执行：

ohpm install

三、引用本地模块源码

前提：本地模块必须与宿主模块属于同一个工程

方式一：命令行安装

cd path/to/your/project/main
ohpm install ../common-utils

方式二：手动配置

在 oh-package.json5 中：

"dependencies": {
  "common-utils": "file:../common-utils"
}

然后执行：

ohpm install

说明：路径可以是绝对路径或相对于当前 oh-package.json5 的相对路径

四、引用本地 HAR/HSP 包

4.1 HAR 包引用

方式一：命令行安装

cd path/to/your/project/main
ohpm install ../libs/ui-components.har

方式二：手动配置

"dependencies": {
  "ui-components": "file:../libs/ui-components.har"
}

4.2 HSP 包引用

HSP 包是通过 HSP 模块在 release 模式下编译生成的 .tgz 文件

方式一：命令行安装

cd path/to/your/project/main
ohpm install ../output/data-service.tgz

方式二：手动配置

"dependencies": {
  "data-service": "file:../output/data-service.tgz"
}

安装执行

两种方式配置后都需要执行：

ohpm install

依赖包会安装到模块的 oh_modules 目录下

五、生命周期钩子管理

在 oh-package.json5 中可配置安装/卸载钩子：

"hooks": {
  "preInstall": "echo '开始安装依赖前执行'",
  "postInstall": "echo '依赖安装完成后执行'",
  "preUninstall": "echo '开始卸载依赖前执行'", 
  "postUninstall": "echo '依赖卸载完成后执行'"
}

说明：

• 目前只支持执行当前模块或工程的钩子

• 不支持执行依赖包中的钩子

六、使用 OpenHarmony 开源中心仓（可视化管理）

6.1 访问方式

• 菜单栏：Tools > OHPM Index

• 区域限制：仅支持中国境内

6.2 主要功能

搜索与浏览

• 左侧搜索框：按名称搜索三方包

• 目录树分类：按功能分类浏览推荐依赖包

安装流程

1. 选择需要的三方包

2. 点击右上角 Install 按钮

3. 如出现弹窗，点击 Add 将中心仓地址添加到 .ohpmrc

依赖管理

• 查看已安装的三方包及版本信息

• Update 按钮：更新到最新版本

• Delete 按钮：删除已安装的三方包

智能替换

对于已使用的依赖，如果存在推荐的同类三方包：

• Replace selected with recommended library：替换当前选中的依赖

• Replace all with recommended libraries：一键替换文件中所有同类推荐包

七、注意事项

1. 依赖声明位置：只在模块和工程级的 oh-package.json5 中声明的 dependencies 才会被构建系统处理

2. HSP 包生成：HSP 的 .tgz 包需要通过 HSP 模块在 release 模式下编译生成

3. 依赖名称规范：引用本地 HAR 时，依赖名称建议与三方包的 name 字段保持一致

4. 路径格式：文件路径支持绝对路径或相对于当前 oh-package.json5 的相对路径

5. 网络要求：可视化中心仓功能有区域限制，仅在中国境内可用

总结

引用和管理共享包提供了多源支持：

• 远程仓库：通过 ohpm 命令或可视化界面安装

• 本地源码：直接引用同一工程内的模块

• 本地包文件：引用已编译的 HAR/HSP 包文件

管理功能：

• 生命周期钩子

• 可视化依赖管理

• 版本更新和替换

• 多仓库源配置