在移动自动化测试中,通常是需要adb命令和monkey命令的联合使用来进行测试,adb命令何其多,monkey命令也不少,组合起来让人头疼,本文讲列出一些常用的命令,帮助大家更好地进行移动自动化测试
Monkey 简介
Monkey 在英文里的含义是“猴子”,在测试行业对应有一个术语叫“猴子测试”,那么什么是“猴子测试”
- Android自带命令行工具,运行在模拟器或实际设备中
- 向被测应用发送伪随机事件流(如按键、触屏、手势等)
- 通过 monkey 用随机重复的方式来对应用程序进行一些稳定性、健壮性方面的测试
Monkey 原理
- 利用 socket 通讯(Android 客户端和服务器以 TCP/UDP 方式)
- 使用的事件流数据流是随机的,不能自定义
- monkey 是用 Java 语言写成,名为 Monkey.jar
- 通过名为 monkey 的 shell 脚本启动执行,shell脚本的存放路径为: /system/bin/monkey
Monkey 命令
adb shell monkey [+ 命令参数] [指令数]
最简单的示例:
adb shell monkey 100 # 发送 100 个随机指令
上面的 monkey 命令发送了 100 个随机指令,因为并没有指定具体的应用包名。会在整个系统内随机执行。
注意: 指令数,也就是发送的随机数的数值一定要放在所有参数的最后。
Monkey 参数
- -p 用于约束限制,用此参数指定一个或多个包。指定包后,所有的随机指令都会针对该应用进行操作。(如 何查找包名,请查看文章最后
示例:
adb shell monkey -p com.huomaotv.mobile 100 # 对“火猫 TV”发送 100 个随机指令
接下来的 100 条指令都会在 火猫TV 应用内进行。不过注意,100 条指令会在极快的时间完成。
- -v 用于指定反馈信息级别(信息级别就是日志的详细程度),总共分 3 个级别,以 -v 参数在命令中的个数 决定级别, -v 参数个数越多日志就越详细。
Level 1: 缺省值,仅提供启动提示、测试完成、最终结果及 Crash 日志等少量信息
adb shell monkey -p com.huomaotv.mobile -v 100
Level 2: 提供较为详细的日志,包括每个发送到 Activity 的事件信息
adb shell monkey -p com.huomaotv.mobile -v -v 100
Level 3:最详细的日志,包括了测试中选中/未选中的Activity信息
adb shell monkey -p com.huomaotv.mobile -v -v -v 100
- --throttle 每个事件结束后的间隔时间。用于降低系统压力。如果不指定,系统会尽快的发送事件序列
adb shell monkey -p com.huomaotv.mobile --throttle 300 100 # 每个指令间延时 300 毫秒
- -s 指定测试的种子值(编号),如果两次的种子值相同,则两次测试的随机指令完全相同。主要用于回归和 重现出现的 Bug。 这里稍微难以理解一点, 每次 monkey 命令的指令都是完全随机的,导致如果测试过程中 发现问题,就无法复现。这也就导致开发修复问题之后,我们也无法确定之前的问题是否被修复。 为了保证 能重现问题,在运行 monkey 指令的时候加一个 种子值,只要后续的指令带上该种子值,那么两次运行的随 机命令完全一致。
adb shell monkey -p com.huomaotv.mobile -s 5555 -v 100
可以修改命令其他参数,保留 -s 5555 可以看到随机指令都一样。如果修改了数量,应该是百分比和前面的指令 是一致的。比如把数量从 100 改为 200,前面的百分比和前面的随机指令是一致的
调试参数
以下命令主要用于控制在 monkey 命令执行过程中的一些调试选项。 其中 --ignore-crashes 和 --ignoretimeouts 在长时间运行(比如下班后运行几个小时),可以保证在运行过程中遇到崩溃等问题的时候,依然能执 行剩余的指令。避免刚开始执行就遇到 Crash 和 ANR 导致后续指令不会执行。
参数 | 说明 | 备注 |
--ignorecrashes | 用于指定当应用程序崩溃时,Monkey是否停止运行。如果使用此参数,即使应用程序 崩溃,Monkey依然会发送事件,直到事件计数完成。 | 长 时 间 运 行 必 备 |
--ignoretimeouts | 用于指定当应用程序发生ANR(Application No Responding)错误时,Monkey是否 停止运行。如果使用此参数,即使应用程序发生ANR错误,Monkey依然会发送事件, 直到事件计数完成。 | 长 时 间 运 行 必 备 |
--ignoresecurityexceptions | 用于指定当应用程序发生许可错误时(如证书许可,网络许可等),Monkey是否停止 运行。如果使用此参数,即使应用程序发生许可错误,Monkey依然会发送事件,直到 事件计数完成 | |
--killprocessafter-erro | 用于指定当应用程序发生错误时,是否停止其运行。如果指定此参数,当应用程序发 生错误时,应用程序停止运行并保持在当前状态(注意:应用程序仅是静止在发生错 误时的状态,系统并不会结束该应用程序的进程)。 | |
--monitornativecrashes | 用于指定是否监视并报告应用程序发生崩溃的本地代码。 | |
-wait-dbg | 停止执行中的Monkey,直到有调试器和它相连接。 | |
-dbg-noevents | 设置此选项,Monkey将执行初始启动,进入到一个测试Activity,然后不会再进一步 生成事件。为了得到最佳结果,把它与-v、一个或几个包约束、以及一个保持Monkey 运行30秒或更长时间的非零值联合起来,从而提供一个环境,可以监视应用程序所调 用的包之间的转换 | |
参数 | 说明 | 备注 |
--ignorecrashes | 用于指定当应用程序崩溃时,Monkey是否停止运行。如果使用此参数,即使应用程序 崩溃,Monkey依然会发送事件,直到事件计数完成。 | 长 时 间 运 行 必 备 |
--ignoretimeouts | 用于指定当应用程序发生ANR(Application No Responding)错误时,Monkey是否 停止运行。如果使用此参数,即使应用程序发生ANR错误,Monkey依然会发送事件, 直到事件计数完成。 | 长 时 间 运 行 必 备 |
--ignoresecurityexceptions | 用于指定当应用程序发生许可错误时(如证书许可,网络许可等),Monkey是否停止 运行。如果使用此参数,即使应用程序发生许可错误,Monkey依然会发送事件,直到 事件计数完成 | |
--killprocessafter-erro | 用于指定当应用程序发生错误时,是否停止其运行。如果指定此参数,当应用程序发 生错误时,应用程序停止运行并保持在当前状态(注意:应用程序仅是静止在发生错 误时的状态,系统并不会结束该应用程序的进程)。 | |
--monitornativecrashes | 用于指定是否监视并报告应用程序发生崩溃的本地代码。 | |
-wait-dbg | 停止执行中的Monkey,直到有调试器和它相连接。 | |
-dbg-noevents | 设置此选项,Monkey将执行初始启动,进入到一个测试Activity,然后不会再进一步 生成事件。为了得到最佳结果,把它与-v、一个或几个包约束、以及一个保持Monkey 运行30秒或更长时间的非零值联合起来,从而提供一个环境,可以监视应用程序所调 用的包之间的转换 | |
示例:
adb shell monkey -p com.huomaotv.mobile --ignore-crashes --ignore-timeouts --monitornative-crashes -v 100000
指定时间类型百分比参数
monkey 随机发送的命令中包含各种随机事件,各种类型的事件按照某种比例产生。如果想要指定某种类型的事件 更多一些,可以指定该事件的百分比。
比如当前测试的应用中主要支持的操作就是 触摸和滑动 等常规操作,那么就可以提高这两种类型的随机事件的比 例。
事件类别 | 调整事件说明 |
--pct-touch | 调整触摸事件的百分比(触摸事件是一个down-up事件,它发生在屏幕上的某单一位置) |
--pctmotion | 调整滑动事件的百分比(动作事件由屏幕上某处的一个down事件、一系列的伪随机事件和一 个up事件组成) |
--pctpinchzoom | 调整缩放事件的百分比(缩放事件即智能机上的放大缩小手势) |
--pcttrackball | 调整轨迹事件的百分比(轨迹事件由一个或几个随机的移动组成,有时还伴随有点击) |
--pctrotation | 调整横竖屏切换事件的比例 |
--pct-nav | 调整“基本”导航事件的百分比(导航事件由来自方向输入设备up/down/left/right组成) |
--pctmajornav | 调整“主要”导航事件的百分比(这些导航事件通常引发图形界面中的动作,如:回退按键、菜 单按键) |
--pct-flip | 调整键盘事件的百分比(键盘事件如点击输入框、键盘弹起、点击输入框以外区域、键盘收 回等) |
--pctsyskeys | 调整“系统”按键事件的百分比(这些按键通常被保留,由系统使用,如Home、Back、Start Call、End Call及音量控制键) |
--pctappswitch | 调整启动Activity的百分比。在随机间隔里,Monkey将执行一个startActivity()调用,作为最 大程度覆盖包中全部Activity的一种方法 |
--pctanyevent | 调整其它类型事件的百分比。它包罗了所有其它类型的事件,如:按键、其它不常用的设备 按钮、等等 |
示例:
# 单个参数设置百分比
adb shell monkey -p com.huomaotv.mobile --pct-appswitch 20 10000
# 多个参数设置百分比
adb shell monkey -p com.huomaotv.mobile --pct-appswitch 20 --pct-rotation 20 --pcttouch 30 --pct-motion 20 10000
注意: 参数后面紧接百分比 ,百分比的总量不能大于 100%
- # 单个参数设置百分比
adb shell monkey -p com.huomaotv.mobile --pct-appswitch 20 10000- # 多个参数设置百分比
adb shell monkey -p com.huomaotv.mobile --pct-appswitch 20 --pct-rotation 20 --pcttouch 30 --pct-motion 20 10000
注意: 参数后面紧接百分比 ,百分比的总量不能大于 100%
日志分析
在命令的最后,加上 > 重定向到本地文件。 d:/monkey.log 放在 d 盘的根目录
示例:
adb shell monkey -p com.huomaotv.mobile --pct-appswitch 20 --pct-rotation 20 --pcttouch 30 --pct-motion 20 --ignore-crashes --ignore-timeouts --monitor-native-crashes 10000 > d:/monkey.log
那么对于 monkey 跑完之后,我们要如何去确认有没有出现 bug 呢? 最直观简单的方式就是通过搜索以下关键字:
- 1. 程序无响应的情况:搜索关键字“ANR in”
- 2. 崩溃的情况1:搜索关键字“CRASH”
- 3. 崩溃的情况2:搜索关键字“Exception”
- 4. 内存溢出的情况:搜索关键字“OOM”
- 5. 测试成功的情况:搜索关键字“Monkey finished”
- 6. 如果出现空指针 NullPointerException ,就一定是 bug
结语
需要adb命令和monkey命令大全的可以私聊我,也欢迎大家进群一起交流自动化测试遇到的问题或经验,群内給