鸿蒙系统 wukong 测试指令详解新手经验笔记适用对象刚接触鸿蒙稳定性测试的新人适用版本OpenHarmony 3.2 / HarmonyOSwukong 已从 3.2 起预置在系统里文档定位随手查的命令速查 实战模板 踩坑记录一、wukong 是什么30 秒理解wukong悟空是鸿蒙系统自带的稳定性压力测试命令行工具本质相当于 Android 的 Monkey但能力更强。它通过模拟无序的用户行为随机点击、滑动、拖拽、按键、旋转、控件注入等对系统或指定应用持续施压从而暴露崩溃、卡死、冻屏、资源泄漏等问题并自动捕获异常、生成报告。一句话记忆法wukong 鸿蒙版 Monkey 控件遍历 异常报告。核心能力Ability 随机事件注入、控件注入异常捕获JS Crash / CPP Crash / AppFreeze 等自动生成测试报告Ability 数据遍历截图二、三大测试类型先选对类型测试类型主命令用途典型场景随机测试wukong exec整机或指定应用随机乱点乱滑系统/应用稳定性压测最常用专项测试wukong special指定应用控件顺序遍历、截图、休眠唤醒、录制回放界面遍历、UI 截图回归专注测试wukong focus对指定类型控件反复注入深挖某个控件如按钮/滑块的健壮性新手起步99% 的情况从wukong exec开始。三、前置准备每次开测前必做# 1. 确认设备已连接hdc list targets# 2. 进入设备 shell后续命令都在设备 shell 里敲hdc shell# 3. 确认 wukong 存在wukong-v# 查看版本能出版本号说明已预置wukonghelp# 查看帮助# 4. 列出当前设备可被拉起的应用拿 bundleName 和 mainAbilitywukong appinfo老版本3.2 之前系统不预置 wukong需要自行编译后用hdc file send推送并重挂载但3.2 之后基本不用管。推送旧方法备用仅老版本hdc_std shellmount-orw,remount / hdc_stdfilesend wukong / hdc_std shellchmodax /wukong hdc_std shellmv/wukong /bin/四、随机测试wukong exec—— 最常用4.1 完整参数速查表参数全称含义默认值冲突/注意-c--count执行次数10 次与-T二选一-T--time测试总时长10 分钟与-c二选一-i--interval事件间隔单位 ms1500 ms—-s--seed随机种子无同种子→同事件序列可复现-b--bundle允许测试的应用白名单全部应用与-p互斥-p--prohibit禁止测试的应用黑名单不禁止与-b互斥-d--page禁止测试的页面名单系统禁pages/system—-e--allow允许测试的ability—必须配合-b-E--block禁止测试的ability—必须配合-b-a--appswitch应用随机拉起比例10%0~1 小数-t--touch屏幕随机 touch比例10%0~1 小数-S--swap屏幕随机滑动比例3%0~1 小数-m--mouse随机鼠标比例1%0~1 小数-k--keyboard随机键盘比例2%0~1 小数-H--hardkey随机硬键比例2%0~1 小数-r--rotate随机旋转比例2%0~1 小数-C--component随机控件比例70%0~1 小数-I--screenshot控件测试截图关—-U--uri指定应用拉起页面 uri——-x--uriType指定拉起页面 uriType——比例相加不必等于 1wukong 内部会归一化处理各类事件占比给的是相对权重。4.2 新手直接抄的实战模板# 模板1整机随机压测 100 次最基础wukongexec-s10-i1000-a0.28-t0.72-c100# 模板2整机压测 30 分钟用时间代替次数wukongexec-s10-i1000-T30# 模板3只压测某一个应用白名单wukongexec-bcom.ohos.settings-a0.28-t0.72-c200# 模板4压测某应用但禁止系统设置里的某个abilitywukongexec-bcom.ohos.settings-ecom.ohos.settings.MainAbility-Ecom.ohos.settings.AppInfoAbility# 模板5带截图回归/留证wukongexec-bcom.example.myapp-t0.7-a0.3-c100-I# 模板6指定页面显式拉起已知 uriwukongexec-bbundlename-aabilityname-Uuri# 模板7指定页面隐式拉起已知 uri uriTypewukongexec-bbundlename-Uuri-xuriType模板1 逐字解析务必记住这组面试/实操都常用片段含义wukong exec主命令随机测试-s 10随机种子 10-i 1000事件间隔 1000 ms-a 0.28应用随机拉起占 28%-t 0.72屏幕随机 touch 占 72%-c 100总共执行 100 次五、专项测试wukong special—— 遍历/截图/休眠唤醒5.1 参数速查表参数全称含义默认值注意-h--help帮助——-k--spec_insomnia休眠唤醒专项关⚠️ 与 exec 的-k含义不同-c--count执行次数10 次—-i--interval执行间隔ms1500 ms—-S--swap滑动测试—配合-s/-e/-b-s--start[x,y]滑动起点坐标—⚠️ 与 exec 的-s(seed) 不同-e--end[x,y]滑动终点坐标——-b--bilateral往返滑动不往返—-t--touch[x,y]点击测试坐标——-T--time测试总时长分钟10 分钟—-C--component控件顺序遍历—需指定应用名-r--record录制—需指定录制文件-R--replay回放—需指定回放文件-p--screenshot控件测试截图关—5.2 实战模板# 控件顺序遍历 截图最常用专项wukong special-Ccom.example.myapp-p# 休眠唤醒专项反复灭屏亮屏wukong special-k-T5# 固定坐标滑动起点 100,200 → 终点 100,800往返wukong special-S-s100,200-e100,800-b# 固定坐标点击wukong special-t500,500-c50# 录制操作序列wukong special-r/data/local/tmp/record.txt# 回放操作序列wukong special-R/data/local/tmp/record.txt六、专注测试wukong focus—— 死磕某个控件专注测试继承exec的全部参数额外两个参数全称含义-n--numberfocus每个控件注入的次数-f--focustypes需要专注的控件类型英文逗号隔开# 对按钮类控件每个注入 50 次wukong focus-fbutton,switch-n50-c200# 对输入控件滑块死磕wukong focus-ftext_input,slider-n100-T10常见控件类型参考以wukong focus -h实际输出为准button、checkbox、image、list、radio、scroll_bar、slider、switch、tab、text、text_input、toggle等。七、⚠️ 新手必踩的 6 个坑重点记-s含义分家exec里是--seed随机种子special里是--start[x,y]滑动起点坐标。敲错直接语法报错或行为异常。-k含义分家exec里是--keyboard键盘比例special里是--spec_insomnia休眠唤醒专项。别混。-b/-p互斥白名单和黑名单不能同时用。-c/-T互斥要么按次数要么按时间二选一。-e/-E必须配-b想限定 ability 白/黑名单必须先-b指定应用否则不生效。比例是小数不是百分比-a 0.28是 28%不是 28。写成-a 28会出问题。记忆口诀exec 的 s 是种子(seed)、k 是键盘(key)special 的 s 是起点(start)、k 是休眠唤醒(sleep)。八、报告与结果分析wukong 运行时会打印日志结束后生成报告依赖 DFX 子系统收集异常。# 运行期间实时看日志建议另开一个 shell 观察hdc shell hilog|grepwukong# 异常日志落盘崩溃/冻屏排查hdc shell hilogwukong_run.log# 拉取报告/截图目录报告默认在设备 /data/... 或沙箱目录视版本而定hdcfilerecv /data/wukong ./wukong_report关注的重点异常类型JS CrashArkTS/JS 层崩溃CPP CrashNative 层崩溃AppFreeze应用冻屏/卡死Resource Leak资源fd/线程/内存泄漏App Killed应用被系统杀掉实操建议复现问题用相同-s种子相同种子会生成相同的随机事件序列方便研发复现。九、新手标准作业流SOP# Step 1 连接 进 shellhdc shell# Step 2 看版本 列应用wukong-vwukong appinfo# 抄下要测的 bundleName# Step 3 跑一轮快速随机测试先小剂量探路wukongexec-bcom.example.myapp-a0.3-t0.7-c50# Step 4 没问题再上压力长时间/多次数wukongexec-bcom.example.myapp-a0.3-t0.7-T60-s10# Step 5 收集日志 报告# 另开终端hdc shell hilog|grepwukong十、一句话速记卡贴显示器上wukong exec 随机压测整机/指定应用 ← 最常用 wukong special 遍历/截图/休眠唤醒/录回放 wukong focus 死磕某类控件 -c 次数 -T 分钟 -i 间隔ms -s 种子 -b 白名单 -p 黑名单互斥 -a 拉起比 -t 点击比 -C 控件比小数 exec:-s种子 -k键盘 | special:-s起点 -k休眠 同种子可复现-e/-E 必带 -b参考来源OpenHarmony 官方仓库ostest_wukong华为开发者文档HarmonyOS 应用上架运营流程 - 稳定性测试工具 wukong