HarmonyOS5调试秘籍：模拟器与真机调试要点全解

前言

DevEco Studio的预览器能够提供高效的UI实时反馈，但要是想要进行全面的功能测试、性能剖析以及和硬件相关的功能调试，那就得在模拟器或者真机上运行应用啦。

模拟器的安装以及启动可以参考往期文章：【HarmonyOS 5开发入门】DevEco Studio安装配置完全指南

使用本地真机运行应用/服务

设备连接

• USB连接：用USB线把手机或者平板连接到电脑，在设备的“设置 > 系统 > 开发者选项”中开启USB调试。当设备弹出授权对话框的时候，点击“允许”就行。
• 无线连接：开启“无线调试”，通过IP地址来连接设备，命令如下：

hdc tconn 设备IP地址:端口号

设备管理

在DevEco Studio底部的Device Manager里查看已经连接的设备，确认设备的状态、系统版本还有连接方式。

应用部署

点击菜单栏的Run > Run '模块名'，或者使用快捷键：
- Windows/Linux：Shift + F10
- macOS：Control + R

调试技巧

• 断点调试：点击代码行号旁边设置断点。
• 日志查看：使用Logcat窗口实时查看日志。
• 性能监控：内置的工具能够监控CPU、内存等性能指标。
• 热更新：支持代码变更之后不用重新安装就能快速同步到设备上。

使用模拟器运行应用/服务

系统要求

• 操作系统：Windows 10/11 64位、macOS 10.15及以上版本。
• CPU：支持VT - x / AMD - V虚拟化。
• 内存：8GB起（推荐16GB）。
• 硬盘：至少有10GB可用空间。

前置条件

• 在BIOS中开启虚拟化功能。
• 安装最新版本的DevEco Studio。
• 下载并且安装所需的模拟器系统镜像。

模拟器与真机对比

操控屏幕

使用工具栏

移动与缩放模拟器窗口

• 拖动标题栏来移动窗口。
• 支持缩放比例（50%、100%、150%）。
• 支持全屏模式（通过F11切换）。
• 支持多窗口并排显示。

应用安装与文件传输

应用安装

• 方法一：把.hap文件拖拽到模拟器窗口。
• 方法二：使用如下命令行。

hdc install path/to/your/app.hap

文件传输

# 发送文件
hdc file send local_file remote_path

# 接收文件
hdc file recv remote_path local_folder

支持配置共享文件夹，实现主机与模拟器之间的文件共享。

扩展能力

• 快照：保存/恢复测试状态。
• 硬件模拟：模拟加速度计、陀螺仪、通话、电量等。
• 调试工具：进行性能分析、UI渲染分析。
• 自动化测试：录制操作、批量运行、脚本回放。

常见问题与解决方案

HDC常用命令

设备管理

# 列出所有已连接的设备
hdc list targets

# 连接到指定IP和端口的设备（无线调试）
hdc target connect 192.168.1.100:8710

# 断开与指定设备的连接
hdc target disconnect 192.168.1.100:8710

# 重启设备
hdc target reboot

# 检查设备连接状态
hdc check-status

应用管理

# 安装应用
hdc install path/to/your/app.hap

# 安装多个HAP包
hdc install -m path/to/entry.hap path/to/feature.hap

# 卸载应用
hdc uninstall com.example.app

# 启动应用
hdc shell aa start -a com.example.app.MainAbility -b com.example.app

# 停止应用
hdc shell aa stop -a com.example.app.MainAbility -b com.example.app

# 清除应用数据
hdc shell aa clear -b com.example.app

文件操作

# 从设备拉取文件到本地
hdc file recv /data/storage/el2/base/files/example.db ./local_folder/

# 发送本地文件到设备
hdc file send ./local_file.txt /data/storage/el2/base/files/

# 列出设备目录内容
hdc shell ls -la /data/storage/el2/base/files/

# 删除设备上的文件
hdc shell rm /data/storage/el2/base/files/temp.txt

# 创建设备上的目录
hdc shell mkdir /data/storage/el2/base/files/new_folder

日志与调试

# 查看实时日志
hdc shell hilog

# 按标签过滤日志
hdc shell hilog | grep "MyApp"

# 保存日志到文件
hdc shell hilog > app_log.txt

# 清除日志缓冲区
hdc shell hilog -c

# 设置日志级别
hdc shell hilog -L DEBUG

性能分析

# 显示进程列表
hdc shell ps -ef

# 显示特定应用的进程
hdc shell ps -ef | grep com.example.app

# 查看内存使用情况
hdc shell free -m

# 查看CPU使用情况
hdc shell top -n 1

# 获取应用内存使用详情
hdc shell dumpsys meminfo com.example.app

网络相关

# 端口转发（将设备8080端口映射到本地8888端口）
hdc forward tcp:8888 tcp:8080

# 移除端口转发
hdc forward --remove tcp:8888

# 列出所有端口转发规则
hdc forward --list

# 查看设备网络配置
hdc shell ifconfig

# 测试网络连接
hdc shell ping www.example.com

自动化测试

# 执行UI自动化测试
hdc shell aa test -p com.example.test -s class com.example.test.TestClass

# 模拟输入事件（点击屏幕坐标x=500, y=600）
hdc shell input tap 500 600

# 模拟滑动事件（从(300,500)滑动到(300,100)）
hdc shell input swipe 300 500 300 100

# 模拟按键事件（按下返回键）
hdc shell input keyevent 4

# 模拟文本输入
hdc shell input text "Hello%sWorld"  # %s表示空格

模拟器专用

# 列出所有可用模拟器
hdc emulator list

# 创建新模拟器
hdc emulator create -n MyEmulator -t phone

# 启动模拟器
hdc emulator start -n MyEmulator

# 停止模拟器
hdc emulator stop -n MyEmulator

# 设置模拟器属性
hdc emulator set -n MyEmulator -k resolution -v 1080x2340

批处理示例

# 执行设备上的Shell脚本
hdc shell sh /data/local/tmp/test_script.sh

# 执行本地Shell脚本并将结果传回
hdc shell < ./local_script.sh > result.txt

# 批量安装多个应用
for hap in ./apps/*.hap; do hdc install "$hap"; done

总结

不管是用真机还是模拟器来进行开发调试，合理挑选测试环境和工具，能够明显提升开发效率和应用质量。配合强大的HDC命令行工具，开发者可以实现高效的部署、调试和自动化测试，这可是日常HarmonyOS应用开发的核心能力呢。

要是有疑问，随时私信交流哦！