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，然后重启服务