OpenHarmony开发板实战：5个HDC命令快速提升调试效率
刚拿到DAYU200或RK3568开发板时，面对全新的OpenHarmony系统，很多开发者会感到无从下手。本文将聚焦五个最实用的HDC（Harmony Device Connector）命令，帮助开发者快速完成从设备连接到基础调试的全流程。
1. 设备连接与状态检查
在开始任何调试前，首先要确保开发板与PC建立了稳定的连接。HDC提供了多种连接方式，包括USB、TCP/IP和串口。
1.1 查看已连接设备
使用以下命令列出当前所有连接的OpenHarmony设备：
hdc list targets -v输出示例：
7001005458323933328a59612f4b3900 transport_id:1 dev_type:device dev_name:DAYU200关键参数说明：
transport_id：连接会话IDdev_type：设备类型dev_name：设备型号名称
1.2 多设备连接时的选择
当连接多个设备时，需要指定目标设备进行操作：
hdc -t 7001005458323933328a59612f4b3900 shell提示：设备序列号可以通过
hdc list targets获取，建议将常用设备的序列号保存为环境变量方便调用。
2. 应用安装与管理
应用调试是开发中最频繁的操作之一，HDC提供了完整的应用管理功能。
2.1 安装HAP应用包
hdc install /path/to/your/app.hap常见问题处理：
- 签名验证失败：检查应用签名与设备的预置证书是否匹配
- 版本冲突：添加
-r参数覆盖安装现有应用
2.2 应用卸载技巧
卸载普通应用：
hdc uninstall com.example.app系统应用卸载需要额外步骤：
- 修改
/system/etc/app/install_list.json - 将目标应用的
removable属性设为true - 重启设备后执行卸载命令
3. 屏幕方向控制
开发横竖屏适配时，频繁切换屏幕方向是常见需求。通过HDC可以快速修改显示配置。
3.1 临时修改屏幕方向
hdc shell "echo 3 > /sys/class/graphics/fb0/rotate"方向参数说明：
| 值 | 方向 |
|---|---|
| 0 | 默认 |
| 1 | 竖屏 |
| 2 | 横屏 |
| 3 | 反向竖屏 |
3.2 永久修改显示配置
- 提取当前配置文件：
hdc file recv /system/etc/window/resources/display_manager_config.xml ./display_config.xml修改
buildInDefaultOrientation字段推送修改后的文件：
hdc shell mount -o remount,rw / hdc file send ./display_config.xml /system/etc/window/resources/display_manager_config.xml hdc shell reboot4. 高效截屏与录屏
调试UI界面时，可视化反馈至关重要。
4.1 快速截屏命令
hdc shell "snapshot_display -f /data/screenshot.png" hdc file recv /data/screenshot.png ~/Desktop/优化技巧：
- 添加时间戳自动命名：
hdc shell "snapshot_display -f /data/screenshot_$(date +%s).png"4.2 录屏功能实现
虽然HDC不直接支持录屏，但可以通过组合命令实现：
hdc shell "screenrecord --time-limit 30 /data/demo.mp4" hdc file recv /data/demo.mp4 ~/Videos/5. 文件传输技巧
高效的文件传输能极大提升开发效率。
5.1 基础文件操作
推送文件到设备：
hdc file send ./app.hap /data/local/tmp/从设备拉取文件：
hdc file recv /data/local/tmp/log.txt ./5.2 批量文件传输
使用通配符传输多个文件：
hdc file send ./images/*.png /sdcard/Pictures/同步目录（类似rsync）：
hdc file send -z -a ./project/ /data/local/project/参数说明：
-z：启用压缩传输-a：保持文件时间属性
调试效率提升技巧
结合上述命令，可以创建自动化调试脚本：
#!/bin/bash # auto_debug.sh DEVICE_ID="7001005458323933328a59612f4b3900" APP_PATH="./app/build/outputs/app.hap" # Step 1: Install app hdc -t $DEVICE_ID install $APP_PATH # Step 2: Set landscape mode hdc -t $DEVICE_ID shell "echo 2 > /sys/class/graphics/fb0/rotate" # Step 3: Take screenshot after 5s hdc -t $DEVICE_ID shell "sleep 5 && snapshot_display -f /data/debug_screen.png" hdc -t $DEVICE_ID file recv /data/debug_screen.png ./screenshots/ echo "Debug process completed"将常用命令组合成脚本，可以节省大量重复操作时间。实际使用DAYU200开发板时，这套命令组合让我在UI调试阶段的效率提升了至少3倍。特别是在处理横竖屏适配问题时，不再需要反复点击设备上的旋转按钮，直接通过命令行即可精确控制显示方向。
