HDC（HarmonyOS）¶

适用：OpenHarmony / HarmonyOS 设备（RK3568 K1Mini 等）。hdc 类似 Android 的 adb，用于连接、执行命令、传输文件、查看日志。

使用须知

多数命令在 Windows 终端（CMD/PowerShell）直接执行即可；工具目录建议加入 PATH 或在该目录执行。
修改 /system、/vendor 分区文件仅临时生效，重启后建议烧录对应镜像固化。

设备连接¶

USB 方式¶

1. 准备工具：软件：HarmonyOS 镜像，HDC 调试工具（点击下载）；硬件：USB OTG线缆，搭载 HarmonyOS 镜像的KICKPI主板。

2. 通过USB线连接Windows电脑，下载HDC 调试工具，解压至任意目录下，进入该目录运行Windows命令行窗口，输入以下命令

hdc list targets

2. 如图显示HarmonyOS设备序列号，即表示USB方式连接成功，阅读下文常用命令章节进行相关调试。

TCP 方式¶

通过TCP 方式连接搭载HarmonyOS系统的KICKPI主板进行调试，KICKPI主板需事先连接网络（以太网或者无线网络）。

1. 在KICKPI主板端获取 HarmonyOS 设备 IP（图中方法是在windows命令行端获取HarmonyOS 设备 IP，在实际使用中您可以通过方式获取IP地址）。

hdc shell ifconfig

2.在控制端命令行接口输入以下命令

// 连接远程设备
hdc tconn <设备IP>:5555
//查看设备是否已经连接成功
hdc list targets
//如果只有一个被控制设备，指定该设备进入 Shell
hdc shell
//多个被控制设备，指定设备进入 Shell
hdc -t <设备IP>:5555 shell

串口调试¶

通过调试串口线连接HarmonyOS设备，进行调试。

1. 准备工具：软件：Mobaxterm（点击下载）；硬件：串口调试线，又称 USB-TTL 调试线。

!!! Note “USB-TTL调试线线序” 红色：VCC（无需连接）；绿色：TX（发送）；白色：RX（接收）；黑色：GND（接地）。若在 MobaXterm 中无法获取串口输出，只需调换绿色与白色接线后重试即可。

2. 通过调试连接Windows电脑后进行 Mobaxterm 配置，①点击session新建会话窗口；② 选择会话窗口类型为Serial；③选择串口COM编号（通常为COM3）；④设置 Speed(bps) 为1500000；⑤ 点击OK之后，就会进入命令行输入窗口。

3. 在进入串口调试后，Mobaxterm 可能会持续输出串口信息。可输入命令关闭日志

dmesg -n 1

常见命令¶

设备连接¶

hdc list targets                 # 查看已连接设备
hdc list targets -v              # 查看设备详细信息
hdc -t 设备序列号 shell           # 进入指定设备 Shell
hdc kill                         # 停止 hdc 服务
hdc start                        # 启动 hdc 服务
hdc -h                           # 查看所有命令帮助
hdc target boot                  # 重启设备

网络调试¶

hdc tmode port <端口号>           # 设备切换到 TCP 调试端口
hdc tconn <设备IP>:<端口号>       # 通过 WiFi 连接设备
hdc tmode usb                    # 切回 USB 调试

应用安装与卸载¶

hdc install <本地HAP路径>         # 安装 HAP
hdc install -r <本地HAP路径>      # 覆盖安装
hdc uninstall <应用bundleName>    # 按 bundleName 卸载
hdc shell bm dump -a             # 查看已安装应用列表

文件传输¶

hdc file send <电脑文件路径> <设备目标路径>    # 推送文件到设备
hdc file recv <设备文件路径> <电脑保存路径>    # 从设备拉取文件

查看日志¶

hdc hilog > <电脑日志保存文件>    # 抓取日志并保存
hdc shell hilog -x               # 实时输出日志

启动/停止 Ability¶

hdc shell aa start -b <应用bundleName> -a <Ability名称>
hdc shell aa stop -b <应用bundleName>

常用操作¶

hdc shell reboot                 # 重启设备
hdc shell param get <参数名>      # 获取系统参数
hdc shell param set <参数名> <参数值>      # 设置系统参数
hdc shell snapshot_display -f <设备截图保存路径>   # 截屏
hdc file recv <设备截图路径> <电脑保存路径>

常见问题¶

现象	处理
`hdc list targets` 为空	检查 USB 线/驱动、设备是否开机；`hdc kill -r` 后重试
提示 `need connect-key / please confirm a device`	断开重连或 `hdc kill -r` 重新枚举
`shell` 提示无权限	需要 root 的操作确认当前 shell 权限；改系统分区先 `mount -o remount,rw /`
中文/空格路径报错	命令与路径用双引号包裹