HarmonyOS 6学习：DevEco Testing故障截图与录屏导出全流程实战

做鸿蒙应用开发的人，多少都经历过这样一个尴尬时刻：测试同事拿着一台真机跑你的应用，突然说"诶这有个bug，你过来看一下"——等你放下手头的事走过去，要么界面已经切走了，要么问题又"恰好"不复现了。你只能讷讷地说"你截个图发我呗"，对方掏出手机截了一张，再通过微信传过来，画质被压缩得妈都不认，上面的错误栈更是糊成一团……

如果你是负责提缺陷单的人，这种"截图靠微信拍照、录屏靠手机自带录屏再手动传文件"的工作流，会让你在提单质量上吃大亏——别人看不清上下文，复现路径又只靠嘴说，来回拉扯几次，大家都烦。

其实华为早就给你准备了一个更专业的方案：DevEco Testing​ 里的设备投屏 + 截屏/录屏功能。只是很多开发者第一次用的时候，卡在了几个不起眼的步骤上，比如设备连不上、截完找不到图、录屏点了没反应等等。本文就从真实踩坑的角度，把这个流程完整走一遍。

一、先搞清楚：为什么要用 DevEco Testing 而不是直接手机截图

手机自带的截屏/录屏不是不能用，而是有几个硬伤：

一句话：DevEco Testing 本质上把"手机屏幕"变成了一个你可以操控的外设显示器 + 录影机，截的不是手机相册里的图，而是设备当前帧缓冲的直接快照。

二、环境准备：最容易翻车的三个点

2.1 测试机：把"开发者选项"和"USB调试"打开

这是第一步，也是最多人卡住的一步。步骤如下（不同HarmonyOS版本菜单名可能略有差异，但路径基本一致）：

1. 进入「系统设置 → 关于本机」（有的机型叫"关于手机"）

2. 找到「软件版本」或「版本号」​ 这一行，连续快速点击 7 次

3. 系统会弹一个提示框——"您已进入开发者模式"——按提示重启设备

4. 重启后，进入「系统设置 → 系统 → 开发者选项」

5. 把「开发者选项」开关​ 和「USB调试」开关​ 都打开

⚠️常见踩坑：开了USB调试后，第一次用数据线连PC时，手机屏幕上会弹一个授权提示"是否允许USB调试"，一定要点允许（建议勾上"始终允许这台电脑"）。如果点了拒绝，DevEco Testing永远检测不到设备，你会怀疑数据线坏了。

2.2 数据线：别用充电-only线

听起来像废话，但实际踩坑的人非常多——一定要用支持数据传输的线（原装线最佳）。如果你连上后：

• DevEco Testing 显示"未检测到设备"

• 或者设备时不时出现又消失

先换一根线、换一个USB口（尽量别接Hub），再怀疑别的。

2.3 PC端：安装并启动 DevEco Testing

从华为开发者官网下载安装DevEco Testing，安装向导一路下一步就行。首次启动建议让它检查更新，确保你拿到的是较新的版本（老版本在某些HarmonyOS 5.x/6.x机型上投屏协议可能有兼容性问题）。

三、核心流程：投屏 → 截图/录屏 → 导出文件

3.1 连接设备并投屏

打开 DevEco Testing，主界面左侧菜单找「实用工具」→「设备投屏」：

左侧导航 └─ 实用工具 ├─ 设备投屏 ← 点这个 ├─ 文件管理 └─ ...

进入投屏界面后：

1. 选择你的测试机（下拉框里会列出通过USB连上的设备）

2. 投屏模式有两种可选——流畅模式 / 标准模式（一个走压缩更低延迟、一个走画质更稳），如果一种模式画面花屏或卡顿，切换另一种试试

3. 点「开始投屏」

连上之后，你就能在PC屏幕上看到一个实时镜像窗口了——这就是测试机的"显示器"。

💡投屏的意义不只是好看：它是后续所有截屏/录屏功能的基础通道。截屏按钮截的就是这个通道当前的帧，录屏按钮录的也是这段通道上的画面流。

3.2 截屏：一键抓当前帧

在投屏窗口上方（或快捷工具栏里）找截屏按钮（相机图标）。点击之后：

• 工具会立刻截取设备当前屏幕并保存为图片文件

• 保存路径会显示在下方执行日志里，一般是 DevEco Testing 安装目录下的一个 logs 或 screenshots 文件夹

[INFO] Screenshot saved: C:\Users\YourName\AppData\Local\Huawei\DevEcoTesting\screenshots\20260429_143052.png

你要做的就是把那个路径记下来（或者直接去文件夹里拖出来贴进缺陷单）。

什么时候截屏最有价值？

3.3 录屏：把"复现过程"变成证据

有些bug不是一帧的问题，而是一个过程——比如页面切换时闪白、列表快速滑动时错位、弹窗抖动。这种时候一张截图讲不清楚，你需要的是录屏。

操作逻辑很直白：

1. 点快捷工具栏里的录屏按钮（录像机图标）

2. 进入录屏模式后，那个按钮会变成「结束录屏」

3. 此时你在手机上正常操作、复现问题

4. 复现完，点「结束录屏」

5. 录屏文件同样保存在执行日志给出的路径里（一般是.mp4）

⚠️几个硬约束（踩过的都懂）：

• 锁屏 = 录屏死：录屏期间设备屏幕必须保持解锁状态，一旦锁屏录屏进程会被踢掉

• 模拟器不支持：这个功能面向真机，模拟器走的是另一条路（DevEco Studio 的 Log 页签里也有录屏，那是模拟器/真机通用的另一入口）

• 时长别贪心：录个一两分钟足够抓到问题就行，太长不仅文件大，设备也容易热

四、当你"截完找不到图"或"连不上"时的排查清单

下面这张排查表来自实际工单经验，照着对，基本能定位九成问题：

设备连不上

投屏花屏/卡顿

截屏点了没反应 / 找不到保存的文件

五、进阶：除了 DevEco Testing，还有两条"补充路线"要知道

DevEco Testing 的截屏/录屏是最顺手的（因为它就在你调试工作流里），但它不是唯一路。了解补充路线有助于你在不同场景下选对工具：

路线A：DevEco Studio 内置截屏/录屏（Log 页签）

如果你已经在用 DevEco Studio 跑调试，其实不用再单独开 Testing：

• 底部切到Log / HiLog 页签

• 左侧工具栏有相机图标（截屏）​ 和录像机图标（录屏）

• 点一下，选保存路径，一样的——文件直接落到PC本地

这条路线的好处是：少开一个工具，适合"我正在单步调试突然想截一张"的场景。

路线B：hdc 命令行（自动化/CI 场景）

如果你在做自动化测试或想把截图步骤写进脚本：

# 截屏：保存到设备在 /data/local/tmp/0.jpeg hdc shell snapshot_display -f /data/local/tmp/0.jpeg # 把文件拉到PC当前目录 hdc file recv /data/local/tmp/0.jpeg ./ # 录屏启动 hdc shell aa start -b com.huawei.hmos.screenrecorder \ -a com.huawei.hmos.screenrecorder.ServiceExtAbility \ --ps "CustomizedFileName" "test.mp4" # 录屏停止 hdc shell aa start -b com.huawei.hmos.screenrecorder \ -a com.huawei.hmos.screenrecorder.ServiceExtAbility # 查录屏文件位置并拉回来 hdc shell mediatool query test.mp4 -u hdc file recv {RecordFile} ./test.mp4

命令行路线适合提测前跑回归、跑 monkey 测试时自动抓证据帧，属于"工程化"用法。手工复现时，还是 DevEco Testing 的 GUI 更快。

六、总结：把截图/录屏从"随手行为"变成"提效杠杆"

很多团队觉得截图录屏是小事，直到他们开始认真做质量流程才意识到：缺陷单的质量，天花板就是截图/录屏的质量。

用 DevEco Testing 的正确姿势可以总结为四句话：

1. 开开发者选项 + USB调试（7次点击→重启→开两个开关→首次点允许）

2. 数据线别省（原装线直插，不稳先换线）

3. Testing → 实用工具 → 设备投屏 → 开始投屏（模式不对就切）

4. 截屏抓帧 / 录屏抓过程 → 从执行日志拿路径 → 直接贴进缺陷单

整套东西不复杂，但从"微信拍截图"升级到这个流程之后，你会发现：复现争议少了，QA和开发扯皮少了，提单一次过的概率高了。对一个鸿蒙开发团队来说，这就够了。

HarmonyOS 6学习系列的目标是：不追炫技，但把每个"看起来小事、实际卡人"的工程环节讲透。DevEco Testing 截图录屏这桩事，值得你花十分钟配好，然后让它替你省以后无数个小时。