【转】Monkey工具（一）

Monkey工具

前言：

最近开始研究Android自动化测试方法，对其中的一些工具、方法和框架做了一些简单的整理，其中包括android测试框架、CTS、Monkey、Monkeyrunner、benchmark、其它test tool等等。因接触时间很短，很多地方有不足之处，希望能和大家多多交流。
 

一、  什么是Monkey

Monkey是Android中的一个命令行工具，可以运行在模拟器里或实际设备中。它向系统发送伪随机的用户事件流(如按键输入、触摸屏输入、手势输入等)，实现对正在开发的应用程序进行压力测试。Monkey测试是一种为了测试软件的稳定性、健壮性的快速有效的方法。
 

二、 Monkey的特征

1、测试的对象仅为应用程序包，有一定的局限性。

2、 Monky测试使用的事件流数据流是随机的，不能进行自定义。

3、可对MonkeyTest的对象，事件数量，类型，频率等进行设置。

三、Monkey的基本用法

基本语法如下：

$ adb shell monkey [options]

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

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

四、Monkey测试的一个实例

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

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

1、 通过eclipse启动一个Android的emulator

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

C:\Documents and Settings\Administrator>adb devices

List of devices attached

emulator-5554   device

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

C:\Documents and Settings\Administrator>adb shell

#

4、 查看data/data文件夹下的应用程序包。注：我们能测试的应用程序包都在这个目录下面

C:\Documents and Settings\Administrator>adb shell

# ls data/data

ls data/data

com.google.android.btrouter

com.android.providers.telephony

com.android.providers.downloads

com.android.deskclock

com.android.email

com.android.providers.media

com.android.browser

com.android.calculator2

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

#monkey -p com.android.calculator2 -v 500

其中-p表示对象包 –v 表示事件数量

运行过程中，Emulator中的应用程序在不断地切换画面。

按照选定的不同级别的反馈信息，在Monkey中还可以看到其执行过程报告和生成的事件。 

 

 

五、关于Monkey测试的停止条件

Monkey Test执行过程中在下列三种情况下会自动停止：

1、如果限定了Monkey运行在一个或几个特定的包上，那么它会监测试图转到其它包的操作，并对其进行阻止。

2、如果应用程序崩溃或接收到任何失控异常，Monkey将停止并报错。

3、如果应用程序产生了应用程序不响应(application not responding)的错误，Monkey将会停止并报错。

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

 

六、Monkey命令参数介绍

1) 参数： -p
参数-p用于约束限制，用此参数指定一个或多个包（Package，即App）。指定
包之后，Monkey将只允许系统启动指定的APP。如果不指定包，Monkey将允许系统启动设备中的所有APP。
* 指定一个包：adb shell monkey -p com.idreamsky.yqwan 100
说明：com.idreamsky.yqwan为包名，100是事件计数（即让Monkey程序模拟100次随机用户事件）。
* 指定多个包：adbshell monkey -p com.idreamsky.yqwan –p com.htc.pdfreader -pcom.htc.photo.widgets 100
* 不指定包：adbshell monkey 100
　说明：Monkey随机启动APP并发送100个随机事件。
* 要查看设备中所有的包，在CMD窗口中执行以下命令：
>adb shell
#cd data/data
#ls

2) 参数:-v
用于指定反馈信息级别（信息级别就是日志的详细程度），总共分3个级别，分别对应的参数如下表所示：
日志级别 Level 0 
示例 adb shell monkey -pcom.htc.Weather –v 100
说明 缺省值，仅提供启动提示、测试完成和最终结果等少量信息

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

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

3)参数： -s
用于指定伪随机数生成器的seed值，如果seed相同，则两次Monkey测试所产生的事件序列也相同的。
* 示例：
　Monkey测试1：adbshell monkey -p com.htc.Weather –s 10 100
Monkey 测试2：adbshell monkey -p com.htc.Weather –s 10 100
两次测试的效果是相同的，因为模拟的用户操作序列（每次操作按照一定的先后顺序所组成的一系列操作，即一个序列）是一样的。操作序列虽 然是随机生成的，但是只要我们指定了相同的Seed值，就可以保证两次测试产生的随机操作序列是完全相同的，所以这个操作序列伪随机的；

4) 参数：--throttle <毫秒>
用于指定用户操作（即事件）间的时延，单位是毫秒；
* 示例：adbshell monkey -p com.htc.Weather –throttle 3000 100

5) 参数：--ignore-crashes
用于指定当应用程序崩溃时（Force & Close错误），Monkey是否停止运行。如果使用此参数，即使应用程序崩溃，Monkey依然会发送事件，直到事件计数完成。
* 示例1：adbshell monkey -p com.htc.Weather --ignore-crashes 1000
测试过程中即使Weather程序崩溃，Monkey依然会继续发送事件直到事件数目达到1000为止；
* 示例2：adbshell monkey -p com.htc.Weather 1000
测试过程中，如果Weather程序崩溃，Monkey将会停止运行。


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

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

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

9) 参数：--monitor-native-crashes
用于指定是否监视并报告应用程序发生崩溃的本地代码。

10) 参数：--pct-｛+事件类别｝ ｛+事件类别百分比｝
用于指定每种类别事件的数目百分比（在Monkey事件序列中，该类事件数目占总事件数目的百分比）

参数:
使用说明:
示例:

--pct-touch ｛+百分比｝
调整触摸事件的百分比(触摸事件是一个down-up事件，它发生在屏幕上的某单一位置)
adb shell monkey -p com.htc.Weather --pct-touch 101000

--pct-motion ｛+百分比｝
调整动作事件的百分比(动作事件由屏幕上某处的一个down事件、一系列的伪随机事件和一个up事件组成)adbshell monkey -p com.htc.Weather --pct-motion 20 1000

--pct-trackball ｛+百分比｝
调整轨迹事件的百分比(轨迹事件由一个或几个随机的移动组成，有时还伴随有点击)
adb shell monkey -p com.htc.Weather --pct-trackball 301000
--pct-nav ｛+百分比｝

调整“基本”导航事件的百分比(导航事件由来自方向输入设备的up/down/left/right组成)
adb shell monkey -p com.htc.Weather --pct-nav 40 1000

--pct-majornav ｛+百分比｝
调整“主要”导航事件的百分比(这些导航事件通常引发图形界面中的动作，如：5-way键盘的中间按键、回退按键、菜单按键)
adb shell monkey -p com.htc.Weather --pct-majornav 501000

--pct-syskeys ｛+百分比｝
调整“系统”按键事件的百分比(这些按键通常被保留，由系统使用，如Home、Back、StartCall、End Call及音量控制键)
adb shell monkey -p com.htc.Weather --pct-syskeys  601000

--pct-appswitch ｛+百分比｝
调整启动Activity的百分比。在随机间隔里，Monkey将执行一个startActivity()调用，作为最大程度覆盖包中全部Activity的一种方法
adb shell monkey -p com.htc.Weather --pct-appswitch 701000

--pct-anyevent ｛+百分比｝
调整其它类型事件的百分比。它包罗了所有其它类型的事件，如：按键、其它不常用的设备按钮、等等
adb shell monkey -p com.htc.Weather

--pct -anyevent 100 1000* 指定多个类型事件的百分比： 
adb shell monkey -p com.htc.Weather --pct-anyevent 50--pct-appswitch 50 1000

注意：各事件类型的百分比总数不能超过100%；

 

 

注：具体参数的设定可参考：

 

http://developer.android.com/guide/developing/tools/monkey.html

 

文章部分出处：

http://blog.csdn.net/jiguanghoverli/article/details/7182952