【HarmonyOS NEXT】hdc环境变量配置

hdc（​​HarmonyOS​​ Device Connector）是 HarmonyOS 为开发人员提供的用于调试的命令行工具，通过该工具可以在 windows/linux/mac 系统上与真实设备或者模拟器进行交互。

全局参数

全局参数是指运行部分hdc命令时，可以跟随在hdc后面的参数，例如： 选择指定的设备执行命令，使用-t参数：

hdc -t connect-key shell echo "Hello world"

shell参数说明

-t 连接指定的目标设备，连接一台设备时为可选参数，连接多台设备时为必选参数。

-l 可选参数，指定运行时日志等级，范围为数字0-6，默认为3（LOG_INFO）。

-s 可选参数，指定客户端连接服务端时，服务进程的网络监听参数，格式为ip:port。

-p 可选参数，绕过对服务进程的查询步骤，用于快速执行客户端命令。

-m 可选参数，使用前台启动模式启动服务进程。

命令列表 list targets 查询已连接的所有目标设备。

wait 等待设备正常连接。

tmode usb 该命令已经废弃，不会实际操作设备连接通道，需要在设备设置界面通过USB调试开关进行设置。

tmode port 打开设备网络连接通道。

tmode port close 关闭设备网络连接通道。

tconn 指定连接设备：通过“IP地址：端口号”来指定连接的设备。

shell 在设备侧执行单次命令。

install 安装指定的应用文件。

uninstall 卸载指定的应用包。

file send 从本地发送文件至远端设备。

file recv 从远端设备发送文件至本地。

fport ls 列出全部转发端口转发任务。

fport 设置正向端口转发任务：监听“主机端口”，接收请求并进行转发， 转发到“设备端口”。

rport 设置反向端口转发任务：监听“设备端口”，接收请求并进行转发，转发到“主机端口”。

fport rm 删除指定的端口转发任务。

start 启动hdc服务进程。

kill 终止hdc服务进程。

hilog 打印设备端的日志信息。

jpid 显示设备上所有开启了JDWP调试协议的应用的PID。

track-jpid 实时显示设备上开启了JDWP调试协议的应用的PID和应用名。

target boot 重启目标设备。

target mount 以读写模式挂载系统分区（非root的设备不可用）。

smode 授予设备端hdc后台服务进程root权限， 使用-r参数取消授权（非root的设备不可用）。

keygen 生成一个新的秘钥对。

version 打印hdc版本信息，也可使用hdc -v打印版本信息。

checkserver 获取客户进程与服务进程版本信息。

1. 找到dev eco安装地址中的toolchains目录复制即可

2. 配置环境变量，直接在菜单搜索“环境”二字即可，打开“编辑账户的环境变量”，双击“系统变量”中的Path，点击新建，粘入刚才复制的hdc目录地址，点击确认。

3. 重新打开cmd窗口，输入 hdc -v 出现内容即代表hdc环境变量配置成功。