Monkey的学习与使用技巧

一、Monkey是什么？有什么用？

Monkey是Android SDK自带的一个命令行工具，可以运行在模拟器或实际设备中。它向系统发送伪随机的用户事件流(如按键输入、触摸屏输入、手势输入等)，可实现对应用程序进行自动化测试。Monkey一般用于对程序进行压力测试、可靠性测试。

二、Monkey工具的特点

1. 测试的对象仅为应用程序包，可通过命令设置对一个或多个包名进行测试
2. Monkey测试使用的事件流数据流是随机或伪随机的，不能对具体的事件流进行自定义
3. 可对Monkey测试产生的事件总数量，类型，事件所占百分比，事件发生频率等进行自定义设置

三、Monkey的环境配置

由于Monkey是Android SDK自带的一个命令行工具，所以需要通过Android 的adb shell命令来启动。在具备Android环境的windows系统下只需要简单的配置一下环境变量即可使用。adb shell实际上就是启动了 …\sdk\platform-tools\ 路径下的adb.exe程序。
本例中，adb.exe的完整路径为 D:\android-sdk-windows\sdk\platform-tools ，因此在配置过程为
右击“计算机”-》属性-》高级系统设置-》环境变量-》

点击系统变量中的 Path,将“D:\android-sdk-windows\sdk\platform-tools ”添加到变量值中，与之前的变量值用“；”隔开。
另外需要注意检查你的android-sdk-windows目录下有没有platform-tools目录。并检查访目录下是否有adb.exe！ 如果没有可以自行下载。
以上准备完毕即可用数据线连接手机和电脑准备启动Monkey。

四、Monkey的基本用法

在CMD中输入指令启动Monkey

基本语法如下：

$ adb shell monkey [options]

如果不指定options，Monkey将以无反馈模式启动，并把事件任意发送到安装在目标环境中的全部包。
下面是一个更为典型的命令行示例，它启动你指定的应用程序，并向其发送500个伪随机事件：

$ adb shell monkey -p your.package.name -v 500

Monkey测试实例

通过这个实例，我们能理解Monkey测试的步骤以及如何知道哪些应用程序能够用Monkey进行测试。

Windows下（注：2和4步是为了查看我们可以测试哪些应用程序包，可省略）：

1、 用数据线连接手机和电脑

2、 在命令行中输入：adb devices查看设备连接情况

3、 在有设备连接的前提下，在命令行中输入：adb shell 进入shell界面

注意，如果手机没有完全root，shell界面显示的是$符号，此时无法通过shell命令查看手机中的应用程序包。只需要再输入 su 命令即可解决。

4、在命令行中输入 ：ls /data/data ，查看data/data文件夹下的应用程序包。注：我们能测试的应用程序包都在这个目录下面

5、以 com.android.calculator2 作为测试对象进行 MonkeyTest

输入指令： monkey -p com.android.calculator2 -v 500 > D:\android-sdk-windows\monkey_log\log.txt

其中 -p 表示对象包 –v 表示log等级 500 表示生产500个随机事件 >后面部分指令表示将生成日志信息存放在 log.txt 文件
运行过程中，从手机屏幕可以看出程序在自动生产各种事件流（触摸，按键，拖动等）。
按照设定的不同级别的反馈信息，在Monkey log中还可以看到其执行过程报告和生成的事件。

6、Monkey测试的停止条件

Monkey 执行过程中通常有以下两种情况会令其停止：

1、如果应用程序崩溃或接收到任何失控异常，Monkey将停止并报错。
2、如果应用程序产生了应用程序不响应ANR(Application Not Responding)的错误，Monkey将会停止并报错。

只有被测程序通过多次并且不同设定下的Monkey测试才算是一个稳定性足够的程序。

五、Monkey的命令参数

使用 monkey help 命令查看命令参数

1 参数： -p

用于约束限制，用此参数指定一个或多个包（Package，即App）。指定包之后，monkey将只允许系统启动指定的APP,如果不指定包，将允许系统启动设备中的所有APP.

• 指定一个包： adb shell monkey -p cn.emoney.acg 10
• 指定多个包：adb shell monkey -p cn.emoney.acg –p cn.emoney.wea -p cn.emoney.acg 100
• 不指定包：adb shell monkey 100

2 参数: -v

用于指定反馈信息级别（信息级别就是日志的详细程度），总共分3个级别，分别对应的参数如下表所示：

日志级别 Level0
示例 ：adb shell monkey -p cn.emoney.acg –v 100
说明 ： 缺省值，仅提供启动提示、测试完成和最终结果等少量信息

日志级别 Level 1
示例 ：adb shell monkey -p cn.emoney.acg –v -v 100
说明 ：提供较为详细的日志，包括每个发送到Activity的事件信息

日志级别 Level 2
示例 ：adb shell monkey -p cn.emoney.acg –v -v –v 100
说明 ：最详细的日志，包括了测试中选中/未选中的Activity信息

3 参数： -s

用于指定伪随机数生成器的seed值，如果seed相同，则两次Monkey测试所产生的事件序列也相同的。

Monkey 测试1：adb shell monkey -p cn.emoney.acg –s 10 100
Monkey 测试2：adb shell monkey -p cn.emoney.acg –s 10 100
两次测试的效果是相同的，因为模拟的用户操作序列（每次操作按照一定的先后顺序所组成的一系列操作，即一个序列）是一样的。

4 参数： –throttle （ms）

用于指定用户操作（即事件）间的时延，单位是毫秒；
adb shell monkey -p cn.emoney.acg –throttle 5000 100

5 参数： –ignore-crashes

用于指定当应用程序崩溃时（Force& Close错误），Monkey是否停止运行。如果使用此参数，即使应用程序崩溃，Monkey依然会发送事件，直到事件流结束。

adb shellmonkey -p cn.emoney.acg –ignore-crashes 1000
测试过程中即使acg程序崩溃，Monkey依然会继续发送事件直到事件数目达到1000为止

adb shellmonkey -p cn.emoney.acg 1000
测试过程中，如果acg程序崩溃，Monkey将会停止运行

6 参数： –ignore-timeouts

用于指定当应用程序发生ANR（Application No Responding）错误时，Monkey是否停止运行。如果使用此参数，即使应用程序发生ANR错误，Monkey依然会发送事件，直到事件计数完成。

adb shellmonkey -p cn.emoney.acg –ignore-timeouts 1000

7 参数： –ignore-security-exceptions

用于指定当应用程序发生许可错误时（如证书许可，网络许可等），Monkey是否停止运行。如果使用此参数，即使应用程序发生许可错误，Monkey依然会发送事件，直到事件计数完成。

adb shellmonkey -p cn.emoney.acg –ignore-security-exception 1000

8 参数： –kill-process-after-error

用于指定当应用程序发生错误时，是否停止其运行。如果指定此参数，当应用程序发生错误时，应用程序停止运行并保持在当前状态
（注意：应用程序仅是静止在发生错误时的状态，系统并不会结束该应用程序的进程）。
adb shellmonkey -p cn.emoney.acg –kill-process-after-error 1000

9 参数： –monitor-native-crashes

用于指定是否监视并报告应用程序发生崩溃的本地代码。

adb shellmonkey -p cn.emoney.acg –monitor-native-crashes 1000

10 参数： –pct-｛+事件类别｝｛+事件类别百分比｝

用于指定每种类别事件的数目百分比（在Monkey事件序列中，该类事件数目占总事件数目的百分比）
示例:

–pct-touch （percent）0

调整触摸事件的百分比(触摸事件是一个down-up事件，它发生在屏幕上的某单一位置)

adb shell monkey -p cn.emoney.acg –pct-touch 10 1000

–pct-motion （percent）1

调整动作事件的百分比(动作事件由屏幕上某处的一个down事件、一系列的伪随机事件和一个up事件组成)

adb shell monkey -p cn.emoney.acg –pct-motion 20 1000

–pct-trackball （percent）2

调整轨迹事件的百分比(轨迹事件由一个或几个随机的移动组成，有时还伴随有点击)

adb shell monkey -p cn.emoney.acg –pct-trackball 30 1000

–pct-nav （percent）3

调整“基本”导航事件的百分比(导航事件由来自方向输入设备的up/down/left/right组成)

adb shell monkey -p cn.emoney.acg –pct-nav 40 1000

–pct-majornav （percent）4

调整“主要”导航事件的百分比(这些导航事件通常引发图形界面中的动作，如：5-way键盘的中间按键、回退按键、菜单按键)

adb shell monkey -p cn.emoney.acg –pct-majornav 50 1000

–pct-syskeys （percent）5

调整“系统”按键事件的百分比(这些按键通常被保留，由系统使用，如Home、Back、Start Call、End Call及音量控制键)

adb shell monkey -p cn.emoney.acg –pct-syskeys 60 1000

–pct-appswitch （percent）6

调整启动Activity的百分比。在随机间隔里，Monkey将执行一个startActivity()调用，作为最大程度覆盖包中全部Activity的一种方法

adb shell monkey -p cn.emoney.acg–pct-appswitch 70 1000

–pct-flip （percent） 7

调整“键盘翻转”事件的百分比。
adb shell monkey -p cn.emoney.acg–pct-flip 70 1000

–pct-anyevent （percent）8

调整其它类型事件的百分比。它包罗了所有其它类型的事件，如：按键、其它不常用的设备按钮、等等

adb shell monkey -p cn.emoney.acg

指定多个类型事件的百分比：

adb shell monkey -p cn.emoney.acg –pct-anyevent 50 –pct-appswitch 50 1000

不指定类型事件的百分比：

adb shell monkey -p cn.emoney.acg–pct-appswitch 70 1000