1. OpenHarmony设备调试基础入门

第一次接触OpenHarmony设备调试时，我也曾被各种命令行工具搞得晕头转向。经过几个项目的实战积累，我发现HDC（OpenHarmony Device Connector）确实是开发者最得力的助手。这个轻量级的命令行工具，就像一把瑞士军刀，能帮我们完成从基础设备管理到高级系统配置的各种操作。

先说说最基本的设备连接。在Windows环境下，你需要先确保HDC工具已经正确安装。打开命令行窗口，输入hdc list targets，这个命令就像是在问："嘿，现在有哪些设备可以陪我玩？"如果一切正常，你会看到类似这样的响应：

7001005458323933328a59612f4b3900 device

这串神秘代码就是你的设备ID。我建议新手在这里加个-v参数，使用hdc list targets -v可以显示更详细的设备信息，比如设备型号、连接方式等，这对后续调试很有帮助。

连接设备后，第一个要掌握的技能就是应用安装与卸载。还记得我第一次尝试安装HAP包时，反复确认命令格式生怕出错。基本语法很简单：

hdc install my_app.hap

卸载应用也很直观：

hdc uninstall com.example.myapp

但这里有个坑我踩过：系统应用默认是不可卸载的。有次我需要替换系统相机应用，直接卸载时报错了。后来发现需要修改/system/etc/app/install_list.json文件，把对应应用的removable属性改为true才行。这个经验告诉我，系统级操作前一定要先检查权限和配置。

2. 系统配置实战技巧

2.1 显示配置调整

在开发DAYU200这类带屏幕的设备时，屏幕方向配置是个常见需求。OpenHarmony的显示配置文件藏在/system/etc/window/resources/display_manager_config.xml里。我习惯先用以下命令把配置文件拉到本地：

hdc file recv /system/etc/window/resources/display_manager_config.xml ./local_config.xml

修改buildInDefaultOrientation参数时要注意：0表示自动旋转，1是竖屏，2是横屏，3是反向竖屏，4是反向横屏。改完后记得三步走：

hdc shell mount -o remount,rw /
hdc file send ./local_config.xml /system/etc/window/resources/display_manager_config.xml
hdc shell reboot

这里有个实用小技巧：如果设备通过调试线连接电脑，建议设置为反向竖屏(3)，这样操作时线缆不会碍手。

2.2 电源管理优化

保持屏幕常亮是开发调试时的刚需。我发现两种可靠方法：

第一种是临时方案，直接设置性能模式：

hdc shell power-shell setmode 602

这个命令立竿见影，但设备重启后会恢复默认。第二种是修改/system/etc/power_config/power_mode_config.xml，把所有模式的DisplayOffTime都设为-1。不过要注意，某些设备上这个修改可能不生效，这时候就需要检查温控策略是否覆盖了电源配置。

电源管理最实用的命令其实是这个：

hdc shell power-shell wakeup

当你的设备屏幕意外熄灭时，这个命令比找电源键快多了。我经常在演示前用它确保设备处于唤醒状态。

3. 高级调试技巧

3.1 系统参数调优

OpenHarmony的param系统是个宝藏，通过它我们可以查看和修改各种系统参数。比如要调试hilog日志级别：

hdc shell param set persist.sys.hilog.debug.on true
hdc shell param set hilog.debug.on true
hdc shell hilog -b D

这个组合拳打开了Debug级别日志，调试应用时特别有用。param命令还能查看CPU架构：

hdc shell param get const.product.cpu.abilist

输出arm64-v8a说明是64位ARM架构，这对native开发很重要。

3.2 输入模拟实战

uinput工具可以模拟各种输入事件，是我做自动化测试的利器。模拟返回键操作：

hdc shell uinput -K -d 2 -u 2

模拟触摸点击需要先获取坐标，我常用的方法是：

hdc shell "hilog | grep -i RotateTouchScreen"

找到坐标后，模拟点击(假设坐标是100,200)：

hdc shell uinput -T -d 100 200 -u 100 200

更复杂的是滑动操作，这个命令实现了从(100,200)到(300,200)的平滑滑动：

hdc shell uinput -T -m 100 200 300 200 500

最后的500表示滑动耗时500毫秒，调整这个值可以控制滑动速度。

4. 系统文件管理

4.1 配置文件管理

OpenHarmony有几个关键配置文件需要掌握：

• /system/etc/app/install_list.json：控制应用安装权限
• /system/etc/window/resources/display_manager_config.xml：显示配置
• /system/etc/power_config/power_mode_config.xml：电源管理配置

我习惯的工作流程是：

1. 拉取配置文件到本地
2. 用VSCode修改（比vi方便多了）
3. 推送回设备
4. 必要时重启生效

比如修改开机动画：

hdc shell mount -o remount,rw /
hdc file send ./bootpic.zip /system/etc/init/bootpic.zip
hdc shell chmod 644 /system/etc/init/bootpic.zip

注意文件权限很重要，否则修改可能不生效。

4.2 日志收集技巧

hilog是OpenHarmony的日志系统，这几个参数组合是我的最爱：

hdc shell "hilog -b D -t 1000 > /data/log.txt"
hdc file recv /data/log.txt ./device_log.txt

这样就能把1000行Debug级别日志保存到本地分析。对于性能问题，我还会加上时间戳：

hdc shell "hilog -b D -t 1000 -T > /data/log_with_time.txt"

遇到棘手问题时，这个命令可以收集更全面的系统信息：

hdc shell bugreport /data/bugreport.zip
hdc file recv /data/bugreport.zip ./

掌握这些调试技巧后，OpenHarmony设备就像透明的水晶球，所有内部状态都清晰可见。刚开始可能会觉得命令繁多，但熟能生巧，我现在已经能像玩街机游戏一样流畅地操作这些命令了。记住，每个高手都是从第一条命令开始学起的，重要的是保持好奇心和实践精神。