做鸿蒙应用开发的人多少都经历过这样一个尴尬时刻测试同事拿着一台真机跑你的应用突然说诶这有个bug你过来看一下——等你放下手头的事走过去要么界面已经切走了要么问题又恰好不复现了。你只能讷讷地说你截个图发我呗对方掏出手机截了一张再通过微信传过来画质被压缩得妈都不认上面的错误栈更是糊成一团……如果你是负责提缺陷单的人这种截图靠微信拍照、录屏靠手机自带录屏再手动传文件的工作流会让你在提单质量上吃大亏——别人看不清上下文复现路径又只靠嘴说来回拉扯几次大家都烦。其实华为早就给你准备了一个更专业的方案DevEco Testing 里的设备投屏 截屏/录屏功能。只是很多开发者第一次用的时候卡在了几个不起眼的步骤上比如设备连不上、截完找不到图、录屏点了没反应等等。本文就从真实踩坑的角度把这个流程完整走一遍。一、先搞清楚为什么要用 DevEco Testing 而不是直接手机截图手机自带的截屏/录屏不是不能用而是有几个硬伤对比维度手机自带截图/录屏DevEco Testing 投屏截屏/录屏导出到电脑需要手动传文件/微信/数据线拷截图/录屏直接保存在PC本地路径路径在日志里清清楚楚写着画面清晰度微信压缩、屏幕比例可能不对PC端投屏原比例截图是设备实际帧缓冲内容操作节奏复现问题→锁屏解锁→截→发→找文件连上后全程鼠标操作复现同时就能截提单体验截图糊、缺上下文截图录屏文件可直接贴进缺陷管理系统一句话DevEco Testing 本质上把手机屏幕变成了一个你可以操控的外设显示器 录影机截的不是手机相册里的图而是设备当前帧缓冲的直接快照。二、环境准备最容易翻车的三个点2.1 测试机把开发者选项和USB调试打开这是第一步也是最多人卡住的一步。步骤如下不同HarmonyOS版本菜单名可能略有差异但路径基本一致进入「系统设置 → 关于本机」有的机型叫关于手机找到「软件版本」或「版本号」 这一行连续快速点击 7 次系统会弹一个提示框——您已进入开发者模式——按提示重启设备重启后进入「系统设置 → 系统 → 开发者选项」把「开发者选项」开关 和「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主界面左侧菜单找「实用工具」→「设备投屏」左侧导航 └─ 实用工具 ├─ 设备投屏 ← 点这个 ├─ 文件管理 └─ ...进入投屏界面后选择你的测试机下拉框里会列出通过USB连上的设备投屏模式有两种可选——流畅模式 / 标准模式一个走压缩更低延迟、一个走画质更稳如果一种模式画面花屏或卡顿切换另一种试试点「开始投屏」连上之后你就能在PC屏幕上看到一个实时镜像窗口了——这就是测试机的显示器。投屏的意义不只是好看它是后续所有截屏/录屏功能的基础通道。截屏按钮截的就是这个通道当前的帧录屏按钮录的也是这段通道上的画面流。3.2 截屏一键抓当前帧在投屏窗口上方或快捷工具栏里找截屏按钮相机图标。点击之后工具会立刻截取设备当前屏幕并保存为图片文件保存路径会显示在下方执行日志里一般是 DevEco Testing 安装目录下的一个 logs 或 screenshots 文件夹[INFO] Screenshot saved: C:\Users\YourName\AppData\Local\Huawei\DevEcoTesting\screenshots\20260429_143052.png你要做的就是把那个路径记下来或者直接去文件夹里拖出来贴进缺陷单。什么时候截屏最有价值场景怎么用截屏复现 crash 前的最后一帧手动复现看到异常帧出现立刻截权限弹窗时机问题边操作边截把弹窗出现/消失各截一张布局在不同屏幕尺寸上的表现连不同测试机分别截横向对比动画中间态比如闪一下截屏抓不住那就用下面的录屏3.3 录屏把复现过程变成证据有些bug不是一帧的问题而是一个过程——比如页面切换时闪白、列表快速滑动时错位、弹窗抖动。这种时候一张截图讲不清楚你需要的是录屏。操作逻辑很直白点快捷工具栏里的录屏按钮录像机图标进入录屏模式后那个按钮会变成「结束录屏」此时你在手机上正常操作、复现问题复现完点「结束录屏」录屏文件同样保存在执行日志给出的路径里一般是.mp4⚠️几个硬约束踩过的都懂锁屏 录屏死录屏期间设备屏幕必须保持解锁状态一旦锁屏录屏进程会被踢掉模拟器不支持这个功能面向真机模拟器走的是另一条路DevEco Studio 的 Log 页签里也有录屏那是模拟器/真机通用的另一入口时长别贪心录个一两分钟足够抓到问题就行太长不仅文件大设备也容易热四、当你截完找不到图或连不上时的排查清单下面这张排查表来自实际工单经验照着对基本能定位九成问题设备连不上检查项操作USB调试授权手机屏幕有没有弹允许USB调试没弹→重拔线触发一次数据线换原装线别用充电线USB口别接Hub/扩展坞直插主板口开发者选项确认「开发者选项」和「USB调试」两个开关都在 ON设备列表为空重启 DevEco Testing → 拔线重插 → 等 5 秒投屏花屏/卡顿方案在投屏界面切换流畅/标准模式降低设备侧动画缩放开发者选项里有窗口动画缩放关掉设备上同时运行的大型应用释放GPU截屏点了没反应 / 找不到保存的文件方案不要看桌面另存为弹窗直接去看执行日志里打印的保存路径检查 PC 磁盘是不是满了录屏文件比较大容易中招截屏功能依赖投屏通道——确认投屏本身是正常工作的五、进阶除了 DevEco Testing还有两条补充路线要知道DevEco Testing 的截屏/录屏是最顺手的因为它就在你调试工作流里但它不是唯一路。了解补充路线有助于你在不同场景下选对工具路线ADevEco Studio 内置截屏/录屏Log 页签如果你已经在用 DevEco Studio 跑调试其实不用再单独开 Testing底部切到Log / HiLog 页签左侧工具栏有相机图标截屏 和录像机图标录屏点一下选保存路径一样的——文件直接落到PC本地这条路线的好处是少开一个工具适合我正在单步调试突然想截一张的场景。路线Bhdc 命令行自动化/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 的正确姿势可以总结为四句话开开发者选项 USB调试7次点击→重启→开两个开关→首次点允许数据线别省原装线直插不稳先换线Testing → 实用工具 → 设备投屏 → 开始投屏模式不对就切截屏抓帧 / 录屏抓过程 → 从执行日志拿路径 → 直接贴进缺陷单整套东西不复杂但从微信拍截图升级到这个流程之后你会发现复现争议少了QA和开发扯皮少了提单一次过的概率高了。对一个鸿蒙开发团队来说这就够了。HarmonyOS 6学习系列的目标是不追炫技但把每个看起来小事、实际卡人的工程环节讲透。DevEco Testing 截图录屏这桩事值得你花十分钟配好然后让它替你省以后无数个小时。
、python代码的读写分离)
