鸿蒙NEXT开发实战往期必看文章:
一分钟了解”纯血版!鸿蒙HarmonyOS Next应用开发!
“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线!(从零基础入门到精通)
HarmonyOS NEXT应用开发案例实践总结合(持续更新......)
HarmonyOS NEXT应用开发性能优化实践总结(持续更新......)
hdc(HarmonyOS Device Connector)是为开发人员提供的用于调试的命令行工具,通过该工具可以在windows/linux/mac系统上与设备进行交互。
环境准备
hdc工具通过HarmonyOS SDK获取,存放于SDK的toolchains目录下,首次使用按照如下提示配置环境变量。
配置环境变量HDC_SERVER_PORT
Windows环境变量设置方法
在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量中,添加HDC端口变量名为:HDC_SERVER_PORT,变量值可设置为任意未被占用的端口,如7035。

环境变量配置完成后,关闭并重启DevEco Studio。
macOS环境变量设置方法
-
打开终端工具,执行以下命令,根据输出结果分别执行不同命令。
echo $SHELL-
如输出结果为/bin/bash,则执行以下命令,打开.bash_profile文件。
vi ~/.bash_profile -
如输出结果为/bin/zsh,则执行以下命令,打开.zshrc文件。
vi ~/.zshrc
-
-
单击字母“i”,进入Insert模式。
-
输入以下内容,在PATH路径下添加HDC_SERVER_PORT端口信息。
HDC_SERVER_PORT=7035 launchctl setenv HDC_SERVER_PORT $HDC_SERVER_PORT export HDC_SERVER_PORT -
编辑完成后,单击Esc键,退出编辑模式,然后输入“:wq”,单击Enter键保存。
-
执行以下命令,使配置的环境变量生效。
-
如果步骤1时打开的是.bash_profile文件,请执行如下命令:
source ~/.bash_profile -
如果步骤1时打开的是.zshrc文件,请执行如下命令:
source ~/.zshrc
-
-
环境变量配置完成后,关闭并重启DevEco Studio。
(可选)配置全局环境变量
说明
如未配置全局环境变量,开发者可通过命令行进入SDK的toolchains目录,在目录中执行hdc相关命令进行调试。
Windows环境变量设置方法
在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量 > 系统变量中,将SDK的toolchains完整路径添加到Path变量值中,具体路径信息以SDK实际配置路径为准。
以下图示内容以本地SDK的toolchains完整路径$DevEco Studio安装目录/sdk/default/openharmony/toolchains为例:


Linux/macOS环境变量设置方法
-
打开终端工具,执行以下命令,根据输出结果分别执行不同命令。
echo $SHELL-
如输出结果为/bin/bash,则执行以下命令,打开.bash_profile文件。
vi ~/.bash_profile -
如输出结果为/bin/zsh,则执行以下命令,打开.zshrc文件。
vi ~/.zshrc
-
-
单击字母“i”,进入Insert模式。
-
输入以下内容,在PATH路径下增加SDK路径信息,具体路径信息以SDK实际配置路径为准。
以下内容以本地SDK的toolchains完整路径$DevEco Studio安装目录/sdk/default/openharmony/toolchains为例:
HDC_SDK_PATH=/User/username/sdk/HarmonyOS/10/toolchains launchctl setenv HDC_SDK_PATH $HDC_SDK_PATH # 仅MacOS需要在此执行,Linux无须执行 export PATH=$PATH:$HDC_SDK_PATH -
编辑完成后,单击Esc键,退出编辑模式,然后输入“:wq”,单击Enter键保存。
-
执行以下命令,使配置的环境变量生效。
-
如果步骤1时打开的是.bash_profile文件,请执行如下命令:
source ~/.bash_profile -
如果步骤1时打开的是.zshrc文件,请执行如下命令:
source ~/.zshrc
-
全局option相关命令
| Option | 说明 |
|---|---|
| -h/help | 打印hdc帮助信息 |
| -v/version | 打印hdc版本信息 |
| -t [connect-key] [command] | 连接指定的目标设备,connect-key可通过hdc list targets查询 |
| -l [level] | 指定运行时日志等级,默认为LOG_INFO |
| wait | 等待设备正常连接,用于检测设备是否连接并准备好接收指令 |
| checkserver | 获取client-server版本 |
-
显示hdc相关的帮助信息,命令格式如下:
hdc -h/help返回值:
返回值 说明 HarmonyOS device connector(HDC) ...
---------------------------------global commands:----------------------------------
-h/help [verbose] - Print hdc help, 'verbose' for more other cmds
...(此处省略详细帮助信息)
hdc命令使用帮助信息 使用方法:
hdc -h 或 hdc help -
显示hdc的版本信息,命令格式如下:
hdc -v/version返回值:
返回值 说明 Ver: X.X.Xa hdc(SDK)的版本信息 使用方法:
hdc -v 或 hdc version -
连接单台设备时,执行命令无需指定设备标识符;连接了多台设备时,每次执行命令时需要指定目标设备的标识符,命令格式如下:
hdc -t [connect-key] [command]参数:
参数名 说明 connect-key 设备标识符 command hdc支持的命令
说明
connect-key为每个设备唯一的标识符。如果通过usb连接,标识符为序列号;如果通过网络连接设备,标识符为“IP地址:端口号”;
返回值:
| 返回值 | 说明 |
|---|---|
| 命令执行返回内容 | 请参考对应命令的返回值 |
| [Fail]Not match target founded, check connect-key please | 没有找到与connect-key匹配的设备 |
| [Fail]Device not founded or connected | 设备未找到或尚未连接 |
| [Fail]ExecuteCommand need connect-key? please confirm a device by help info | 多设备连接时需要指定一个设备 |
| Unknown operation command... | 不支持的命令 |
使用方法:
该方法需要与具体的操作命令搭配使用,下面以shell命令举例:
hdc list targets // 查询已连接的所有目标设备的connect-key
hd
2619



被折叠的 条评论
为什么被折叠?



