【HarmonyOS】HDC 常见命令

一、HDC 简介

hdc（HarmonyOS Device Connector）是提供给开发人员的命令行调试工具，用于与设备进行交互调试、数据传输、日志查看以及应用安装等操作。该工具支持在 Windows/Linux/MacOS 系统上运行，为开发者提供高效，便捷的设备调试能力。

1、HDC 包含三部分

• 客户端（client）：运行在电脑端的进程，开发者在执行 hdc 命令时启动该进程，命令结束后进程自动退出。
• 服务器（server）：运行在电脑端的后台服务进程，用来管理客户端进程和设备端守护进程之间的数据交互，设备发现等。
• 守护程序（daemon）：运行在调试设备端的进程，用来响应服务器发来的请求。
  
• 客户端进程在启动时，默认会判断服务器进程是否正在运行。如果没有运行则会启动一个新的hdc进程作为服务器进程，运行在后台。
• 服务器运行时，默认会监听电脑端的 8710 端口。开发者可通过设置系统环境变量OHOS_HDC_SERVER_PORT 自定义监听的端口号，范围为 1~65535。

2、环境准备

• 通过 HarmonyOS SDK 可获取 hdc 工具。HarmonyOS SDK 已嵌入 DevEco Studio 中，无需额外下载配置。hdc 默认安装在 DevEco Studio/sdk/default/openharmony/toolchains 路径下。
• hdc 支持 USB 和 无线 两种连接调试方式。在设备的 “设置>系统>开发者选项” 中开启或关闭调试开关 ，无需重启设备即可生效。
• 添加 hdc 到系统环境变量中。打开 “系统属性 -> 环境变量 -> 系统变量”，在 Path 系统变量中添加 hdc 的安装路径。
  
• 配置好环境变量后，重新打开 DevEco Studio，点击打开 Terminal 命令行窗口，输入 hdc 命令即可输出相关的信息。
  

二、HDC 命令

1、查看 hdc 版本信息

hdc -v           # 查询hdc客户端进程的版本信息
hdc version      # 查询hdc服务进程的版本信息
hdc checkserver  # 查询客户端和服务器进程版本

> hdc -v
Ver: 3.2.0c
> hdc version
Ver: 3.2.0c
> hdc checkserver
Client version:Ver: 3.2.0c, server version:Ver: 3.2.0c

2、获取帮助信息

# 显示 hdc 命令帮助信息。可选参数：verbose，显示详细的帮助信息。
hdc -h [verbose]
hdc help

3、查询设备列表

# 查询已连接的所有目标设备, 可选参数：-v，显示设备更多详情。
hdc list targets [-v]

4、连接指定的目标设备

hdc -t [connect-key] [command]