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秒或更长时间的非零值联合起来，从而提供一个环境，可以监视应用程序所调 用的包之间的转换

示例：

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% 

日志分析

在命令的最后，加上 > 重定向到本地文件。 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