ohpm使用指导-命令行工具-DevEco Studio使用指南-工具

OHPM CLI 作为鸿蒙生态三方库的包管理工具，支持OpenHarmony共享包的发布、安装和依赖管理。

如何安装

下载ohpm工具包，点击链接获取。
解压文件，进入“ohpm/bin”目录，打开命令行工具，执行如下指令初始化ohpm。
说明
初始化ohpm前，需先完成node.js环境变量配置。
Windows环境下执行：
```
init.bat
```
Linux/macOS环境下执行：
```
./init
```
将ohpm配置到环境变量中。
- Windows环境变量设置方法：
  在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量中，将ohpm命令行工具的bin目录配置到系统或者用户的PATH变量中。
- macOS环境变量设置方法：
  打开终端工具，执行以下命令。
```
export OHPM_HOME=/home/xx/Downloads/ohpm  #本处路径请替换为ohpm的安装路径
export PATH=${OHPM_HOME}/bin:${PATH}
```
安装完成之后，执行如下命令：
```
ohpm -v
```
终端输出为版本号（如：0.6.10），则表示安装成功。

如何更改配置

用户级配置文件存放在C:/Users/用户名目录/.ohpm/.ohpmrc文件，显示默认配置，可执行如下命令：

ohpm config list -j

设置配置项，可执行如下命令：

ohpm config set key value

默认配置项如下所示：

展开

配置项	字段名称	字段说明	字段类型	默认值	备注
仓库设置	registry	仓库地址	字符串	https://repo.harmonyos.com/ohpm/	可以配置多个仓库地址，多个仓库地址的优先级按照配置顺序排序。
仓库设置	@group:registry	指定仓库	字符串	""	根据 group 指定组织的仓库地址。支持多个仓库地址，且优先级大于 registry 配置，多个仓库地址的优先级按照配置顺序排序。
发布设置	publish_registry	发布仓库	字符串	https://repo.harmonyos.com/ohpm/	配置发布的仓库地址，仅支持配置一个仓库地址。
发布设置	publish_id	用户发布号	字符串	""	用户发布号，用来发布鸿蒙生态三方库，全局唯一。
路径设置	cache	缓存路径	字符串	C:/Users/用户名目录/.ohpm/cache	-
路径设置	key_path	私钥路径	字符串	""	利用ssh-keygen 工具生成的私钥的放置路径地址。
网络设置	no_proxy	不使用proxy代理	字符串	""	配置不使用代理的仓库地址，可配置多个，以英文逗号间隔；值可以是域名或者ip，支持二级域名通配符（例如：.huawei.com）。
	http_proxy	http代理	字符串	""	支持用户名和密码的网络代理，示例：http://proxy_server:port。
	https_proxy	https代理	字符串	""	支持用户名和密码的网络代理，示例：http://proxy_server:port。
	strict_ssl	ssl校验	布尔	true	默认值为 true，校验 https 证书；若配置为 false，则不校验 https 证书。
	ca_files	ca证书路径	字符串	""	strict_ssl=true时校验服务端证书需要的ca证书放置路径，可以放置多个证书路径，以英文逗号间隔。
	fetch_timeout	请求超时时间	数值	60000	单位为毫秒。
其他设置	log_level	日志级别	字符串	info	可设置日志输出级别，对应级别类型有 debug、info、warn、error。

常用命令

展开

命令类别	命令格式	含义说明
版本查询	ohpm -v 或 ohpm --version	查看ohpm-cli 版本号
帮助查询	ohpm help 或 ohpm -h 或 ohpm --help	查看命令帮助列表
创建	ohpm init	创建 oh-package.json5 文件
安装	ohpm install [[<@group>/]<pkg> [@<version>]] ...	安装指定版本的三方库，当未指定三方库名称时，会根据当前目录下oh-package.json5 定义的依赖关系进行全量安装
	ohpm install <folder>	安装本地文件夹
	ohpm install <tarball file>	安装压缩包
卸载	ohpm uninstall [<@group>/]<pkg> ...	卸载三方库
查看	ohpm list [[<@group>/]<pkg>[@<version>]]	列出已安装的三方库
查询	ohpm info [<@group>/]<pkg>[@<version>]	查询指定三方库的具体信息
设置ohpm配置项	ohpm config set key value	设置配置值，如服务器地址，网络代理
	ohpm config delete key	删除配置
	ohpm config get key	获取单个配置项
	ohpm config list	获取所有的配置项列表
更新	ohpm update [[<@group>/]<pkg>] ...	更新三方库
发布	ohpm publish [<folder> \| <tarball file>]	发布三方库
下架	ohpm unpublish [<@group>]<pkg>[@<version>]	下架已发布的三方库
校验仓库地址	ohpm ping	校验仓库地址是否有效

更多命令使用以及命令支持的配置项，请参阅ohpm-cli。