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获取客户进程与服务进程版本信息。
开始
- 找到dev eco安装地址中的toolchains目录复制即可
- 配置环境变量,直接在菜单搜索“环境”二字即可,打开“编辑账户的环境变量”,双击“系统变量”中的Path,点击新建,粘入刚才复制的hdc目录地址,点击确认。
- 重新打开cmd窗口,输入 hdc -v 出现内容即代表hdc环境变量配置成功。