鸿蒙hdc使用指导_鸿蒙dhc工具

简介

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

环境准备

hdc工具通过HarmonyOS SDK获取，存放于SDK的toolchains目录下，使用时将SDK的toolchains目录添加到环境变量。

• Windows环境变量设置方法：
  在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量中，添加HDC端口变量名为：HDC_SERVER_PORT，变量值可设置为任意未被占用的端口，如7035。
  
  环境变量配置完成后，关闭并重启DevEco Studio。

注意事项

• 使用hdc，如果出现异常，可以尝试通过hdc kill -r命令杀掉并重启hdc服务。
• 如果出现hdc list targets获取不到设备信息的情况，可以通过任务管理器查看是否有hdc进程存在。若进程存在，则通过hdc kill -r命令杀掉该进程。

说明

• 命令行中被[]修饰的参数表示可选参数。
• 命令行中的参数若是斜体，表示在使用时该参数需替换为具体的信息，例如：file send local remote命令中的local和remote，使用时需替换为本地待发送和远端待接收的文件路径。

简单使用

以真机为例：真机用的hmscore文件夹下的3.1.0，如果是开发板则是OpenharmonySDK安装路径下的设备版本：9/10\toolchains\hdc.exe

查找HDC位置：打开Setting，SDK存放位置下找到\hmscore\3.1.0\toolchains


在当前目录打开CMD 命令窗：查看真机版本和类型：（如果是Windows PowerShell,则：.\hdc -v)

$>hdc -v
Ver: 1.2.0a
$>hdc list targets
54g5h4f54h44f54hrrty4        device
$>hdc -c shell
getprop hw_sc.build.os.apiversion
getprop hw_sc.build.os.releasetype
HWPCT:/ $ getprop hw_sc.build.os.apiversion
6
HWPCT:/ $ getprop hw_sc.build.os.releasetype
Release

1
2
3
4
5
6
7
8
9
10
11
12

开发指导

全局option

1.显示hdc相关的帮助信息，命令格式如下：

hdc -h
1

• 返回值：
  返回hdc的帮助信息。

• 使用方法：

hdc -h
1

2. 显示hdc的版本信息，命令格式如下：

hdc -v
1

• 返回值：
  返回hdc的版本信息。

• 使用方法：

hdc -v
1

3. 连接设备时，若仅有一台，无需指定设备标识。若有多台，一次仅能连接一台，每次连接时需要指定连接设备的标识，命令格式如下：

hdc -t [key] [command]
1

• 参数

• 返回值：
  若连接的设备不存在，返回 Invalid arguments ***。若附件的命令不存在，返回unknown command ***。

• 使用方法：
  该方法需要与具体的操作命令搭配使用，下面以shell命令举例：

hdc list targets  （获取设备信息）
hdc -t [key] shell （-t后面添加的key需要替换为查询到的某一个设备信息）
1
2

说明
一台开发机可连接多个设备，每个设备有唯一的标识。如果通过网络连接设备，标识为IP地址，如果通过usb连接，标识为USB序列号。该命令需要跟随具体的操作命令。

查询相关命令行

显示所有已经连接的设备列表，命令格式如下：

hdc list targets[-v]
1

• 返回值
  若没有查询到设备信息，返回[Empty]。若查询到已经连接的的设备，返回设备列表。

• 使用方法：

hdc list targets
hdc list targets -v
1
2

服务进程相关命令

1. 以读写模式挂载系统分区，命令格式如下：

hdc target mount
1

• 返回值
  挂载成功，返回remount succeeded。挂载失败，返回具体的失败信息。

• 使用方法：

hdc target mount
1

2. 授予设备端hdc后台服务进程root权限，命令格式如下：

hdc smode [off]
1

• 使用方法：

hdc smode  
hdc smode off  // 取消root权限
1
2

3. 终止hdc服务进程，命令格式如下：

hdc kill [-r]
1

• 返回值
  服务进程终止成功，无返回值。服务进程终止失败，返回具体的失败信息。

• 使用方法：

hdc kill
hdc kill -r
1
2

网络相关命令

文件相关命令

1. 从本地发送文件至远端设备，命令格式如下：

hdc file send local remote
1

• 参数

• 返回值
  文件发送成功，返回传输成功的结果信息。文件发送失败，返回传输失败的具体信息。

• 使用方法：

hdc file send E:\example.txt /data/local/tmp/example.txt
1

2. 从远端设备发送文件至本地，命令格式如下：

hdc file recv remote local
1

参数

• 返回值
  文件接收成功，返回传输成功的结果信息。文件接收失败，返回传输失败的具体信息。

• 使用方法：

hdc file recv  /data/local/tmp/a.txt   ./a.txt
1

app相关命令

1. 安装HarmonyOS package，命令格式如下：

hdc install packageFile
1

参数

• 返回值：
  packageFile安装成功，无返回值。packageFile安装失败，返回具体的失败信息。

• 使用方法，以安装com.example.hello包为例：

hdc install E:\com.example.hello.hap
1

2. 卸载HarmonyOS应用，命令格式如下：

hdc uninstall packageName
1

• 参数：

• 返回值：
  packageName卸载成功，无返回值。packageName卸载失败，返回具体的失败信息。

• 使用方法，以卸载com.example.hello包为例：

hdc uninstall com.example.hello
1

调试相关命令

1. 抓取log信息，命令格式如下：

hdc hilog [options]
1

• 返回值：
  返回抓取到的日志信息。

• 使用方法：

hdc hilog 
1

2. 交互命令，命令格式如下：

hdc shell [COMMAND]
1

• 返回值：
  返回shell后面执行命令的结果信息。
• 使用方法：

hdc shell ps -ef
1