【鸿蒙开发】hpm-cli的介绍、安装避坑、详细使用教程

---

HPM包管理器是华为鸿蒙推出的HarmonyOS组件包管理和分发工具，可以方便地根据当前项目需要从官网获取需要的组件，主要面向设备开发，可以获取、定制鸿蒙os的源码，是执行安装、编译、打包、升级等操作的工具集合

---

安装环境准备

前提条件：Ubuntu 16.04 + 的 64 位系统，<hpm也是支持windows的>

• 将linux shell改为bash：
• 安装nodejs 12.13 + ， npm 6.14.4 +
• 安装hpm
• 配置hpm
• 安装相关组件

具体方法

1. 将linux shell改为bash

   #先查看shell是否是bash
   ls -l $(which sh)
   #可以看到是/bin/sh --》bash
   # 如果不是bash，则
   # 先删除sh，再重新创建软连接
   rm -f /bin/sh
   ln -s bash /bin/sh
   

2. 安装nodejs 12.13 + ， npm 6.14.4 +

   方法一：可能会慢一点

   #下载nodejs
   wget https://nodejs.org/dist/v14.15.1/node-v14.15.1-linux-x64.tar.xz
   #解压
   tar xvJf node-v14.15.1-linux-x64.tar.xz
   #移动
   sudo mv node-v14.15.1-linux-x64  /usr/local/node-v14
   #设置全局变量
   sudo ln -s /usr/local/node-v14/bin/node /bin/node
   sudo ln -s /usr/local/node-v14/bin/npm /bin/npm
   
   #配置环境变量，在~/.bashrc文件的上次输入的后面添加
   sudo vi /etc/profile
   # 添加路径输入以下一行，如果原来有node的配置，修改成/usr/local/node-v14/bin即可)
   export PATH=/usr/local/node-v14/bin:$PATH
   
   #退出vi后，启动环境变量
   source /etc/profile
   
   

   如果报错文件存在

   #本步骤为报错解决，不报错可跳过
   #node文件存在的方法
   # 修改软连接
   sudo ln -snf /usr/local/node-v14/bin/node  /bin/node
   # 检查是否正确
   ls -l  /bin/node   
   结果：lrwxrwxrwx 1 root root 28 Dec 12 20:54 /bin/node -> /usr/local/node-v14/bin/node
   
   #npm文件存在的方法
   sudo ln -snf /usr/local/node-v14/bin/npm  /bin/npm
   # 检查是否正确
   ls -l  /bin/npm
   
   

   方法二：

   #安装nodejs和npm
   sudo apt-get install nodejs
   sudo apt-get install npm
   # 查看版本
   node --version  
   npm --version   
   

   若nodejs和npm的版本低于要求可先执行下列命令，再重复上述命令

   curl -L https://deb.nodesource.com/setup_12.x | bash
   

3. 安装hpm

   # 修改为淘宝镜像，否则太慢了，会报错
   npm config set registry https://registry.npm.taobao.org
   npm install -g @ohos/hpm-cli
   ln -s /root/node-v12.14.0 /bin/hpm 
   #检测
   hpm -V
   #若出现版本号，则安装成功
   

4. 配置hpm（选做，不做也没关系）

   #配置文件
    sudo vim ~/.hpm/hpmrc
    
    #常用配置介绍
    registry = https://hpm.harmonyos.com/hpm/registry/api  # hpm注册中心地址，下载组件必须
   login = https://hpm.harmonyos.com/hpm/auth/pk          # hpm处理登录地址，发布组件必须
   loginUser = {your-account}                             # 配置hpm登录账号，发布组件必须
   shellPath = /bin/sh                                    # hpm命令执行使用的shell
   globalRepo = /root/.hpm/global                         # 全局安装的组件存放路径
   http_proxy = http://your-proxy-server:port             # HTTP代理
   https_proxy = http://your-proxy-server:port            # HTTPS代理
   

5. 安装相关组件

   sudo apt-get install python3
   sudo apt-get install python3-pip
   sudo pip3 install setuptools
   sudo pip3 install kconfiglib  
   

   #检测python版本
   python
   #若显示版本为python2则需要修改python为python3
   ll `which python`
   rm /usr/bin/python
   ln -s python3 /usr/bin/python
   

   #安装文件打包工具
   sudo apt-get install dosfstools
   sudo apt-get install mtools
   

---

使用教程

开始下载代码前，需要先初始化目录

#创建目录
mkdir text
cd text
#初始化目录
hpm init -t dist 

继承发行版

hpm i @ohos/ip_camera_hi3516ev300
#hpm i @ohos/‘你的开发板对应的名称’
#当显示installed时，下载成功了

编译代码

#在下载源码的命令内
hpm dist

编译成功后，镜像文件在./out目录下，且源码目录内会出现build.py 以后还可以用以下命令进行编译

python build.py  '你的输出目录'

升级hpm

npm update -g @ohos/hpm-cli

---

踩坑集合