HDC工具

hdc（OpenHarmony Device Connector）是 OpenHarmony 为开发人员提供的用于调试的命令行工具。类似于 adb工具，通过 hdc 可以在设备上执行各种调试操作，如查看设备信息、查看进程、查看内存、查看文件、查看日志等。

hdc 工具使用

以下以在ubuntu 环境调试为例

1、编译sdk

1
./build.sh --product-name ohos-sdk –ccache

编译后生成工具存放路径：

1
2
out/ohos-arm64-release/ohos-sdk

2、设备配置hdc参数

hdc有支持usb调试和网络调试。在有网络情况下，设备端可以配置网络调试，可以先通过串口登录后进行查看配置，如设置“9527”端口：

1
2
3
4
5
6
7
8
9
10
11
12
# 查看hdcd版本
hdcd -v

# 查询hdc参数
param get | grep hdc

# 设置hdc参数
param set persist.hdc.mode tcp
param set persist.hdc.port 9527

# 启动hdcd服务
hdcd &

3、PC端连接设备

PC端在刚刚编译好的sdk目录下执行：

1
2
3
4
5
tconn ip:port
hdc  tconn 10.31.94.242:9527
❰fovt❙~❱✘≻ hdc  tconn 10.31.94.242:9527
Connect OK

输入以上命令后，就可以使用hdc命令了

常用命令

  • 帮助信息和版本信息
1
2
3
4
5
hdc -h
hdc -v

# 获取设备信息
hdc list targets
  • 日志相关
1
2
3
4
5
# 查看日志和这只日志
hdc hilog / hdc shell hilog

# -l 0-5 用于指定运行时日志等级,默认为LOG_INFO。
hdc -l5 start

日志等级说明

参数 参数说明
0 LOG_OFF
1 LOG_FATAL
2 LOG_WARN
3 LOG_INFO
4 LOG_DEBUG
5 LOG_ALL

hdc和adb一样，可以执行shell命令

  • shell相关
1
2
3
4
5
# 执行shell命令但是不进入shell
hdc shell [command]

# 启动shell
./hdc shell
  • 设备重启
1
hdc target boot
  • 文件传输
1
2
3
4
5
6
7
8
9
# 接收
hdc file recv [-a] remote local // -a:文件保留时间戳模式
hdc file recv -a /data/atomic_test ./

# 发送
hdc file send openharmony-debug/ /data/test

# 如果要传入东西到根分区，需要重新挂载/分区，将只读改成可写
hdc shell "mount -o remount,rw /"
  • 安装程序
1
2
3
4
5
# 安装
hdc install hwadmin.hap

# 卸载
hdc uninstall package

注意点

  • hdc连接不到设备

解决方法参考：
1、确保hdc版本和设备版本一致，每个发行版本对应的hdc版本可能不兼容
2、usb线连接正常，并开启调试模式。服务也正常启动
3、切换调试方法，网络调试方法

  • 其他异常

执行hdc kill -r，然后重启服务