【HarmonyOS NEXT】hdc环境变量配置

901 阅读3分钟

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

参数说明

-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目录复制即可

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

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