Monkey的学习与使用技巧
一、Monkey是什么?有什么用?
Monkey是Android SDK自带的一个命令行工具,可以运行在模拟器或实际设备中。它向系统发送伪随机的用户事件流(如按键输入、触摸屏输入、手势输入等),可实现对应用程序进行自动化测试。Monkey一般用于对程序进行压力测试、可靠性测试。
二、Monkey工具的特点
- 测试的对象仅为应用程序包,可通过命令设置对一个或多个包名进行测试
- Monkey测试使用的事件流数据流是随机或伪随机的,不能对具体的事件流进行自定义
- 可对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