[Android]Monkey工具测试方法

Monkey程序简介：
Monkey程序由Android系统自带，使用Java语言写成，在Android文件系统中的存放路径是：/system/framework/monkey.jar

注：Monkey.jar程序是由一个名为“monkey”的Shell脚本来启动执行，shell脚本在Android文件系统中的存放路是：/system/bin/monkey；
这样就可以通过在CMD窗口中执行: adb shell monkey ｛+命令参数｝来进行Monkey测试了。

二、Monkey测试
1、Monkey测试准备
在执行Monkey测试之前，我们需要下载ADB工具，并安装JDK v1.5以上的版本。
Adb工具是谷歌提供的Android调试工具，可以通过linux命令行访问手机。
安装好JDK环境，下载adbtools之后，我们需要配置一下环境变量，把adbtools的存放路径添加到path中，我们可以开始进行Monkey测试。
注：需要root权限。
2、执行Monkey测试
测试命令
通过上文我们已经了解到，通过adb命令开始执行monkey测试，monkey命令的基本格式为：adb shell monkey –p com.android.xxx –v 180000 ––throttle 500。这条命令中，-p代表一个包，即我们monkey测试的对象，一条命令可以有多个包，每添加一个包则需要一个-p，如 adb shell monkey –p 包1 –p 包2…..Com.android.xxx 就是我们需要执行测试的对象，关于包名的获得会在下文详述。
-v 代表返回结果的详尽程度，分为3级，分别是level 1 level 2 level 3，级别越高，返回的log会更详尽，1级为-v ，2级为-v –v，3级为 –v –v –v .
180000 代表执行次数，根据实际测试需要来修改。
-throttle 500 代表间隔时间，即每次操作的时间间隔。为了更好的模拟用户操作，需要在每次操作之间增加时间间隔，单位是毫秒，此命令的含义就是增加500ms的时间间隔。

包名的获取
通过命令获取包名，adb shell ls /data/data，此命令可以显示出手机内的package，然后在列表中找到自己需要测试的包进行测试。
如果手机内存有的包比较多，在 cmd 窗口中查看不方便。可以将package list导出为txt文件并查找包的信息：adb shell ls /data/data > D:\xxx.txt

3、Monkey测试结果分析
得到Monkey测试的log之后，我们可以通过几个关键词来判断测试是否通过。
1）Monkey finished
用记事本打开LOG，查看log的最下端，是否有类似以下字段：
## Network stats: elapsed time=3799ms (3799ms mobile, 0ms wifi, 0ms not connected)
// Monkey finished
这个字段表明本次的Monkey测试通过，没有异常
2）CRASH
同样，在得到LOG后，搜索”CRASH”字段，如果搜索到有结果，则表明，在测试过程中，测试对象出现了报错现象，因此测试失败。
// CRASH: com.onekchi.downloadmanager (pid 12919)
3）NOT RESPONDING
在log中搜素该字段，如果有搜索有结果，则表示测试过程中，测试对象出现了进程无响应的现象，因此测试失败。
4）无法搜索到上述信息
出现这种情况，一般都是外界原因而非程序本身原因。比如测试过程中，电脑断电关机。或者测试过程中内存不足等等，结果作废，需要重新测试。

三、测试实例
对下载管家进行monkey测试，测试时间10小时。
测试步骤：1、手机连接电脑，通过adb shell ls /data/data查看下载管家具体的包名。

通过上图可以看到下载管家的包名具体为：com.onekchi.downloadmanager

接着在命令行输入：
adb shell monkey –p com.onekchi.downloadmanager
–v –v –v 180000 –throttle 500>D:\monkeytest.txt
由此测试开始，结束在D盘找到monkeytest.txt打开并查阅，根据结果提单即可。

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

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

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

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

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

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

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

6、参数： --ignore-timeouts
用于指定当应用程序发生ANR（Application No 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 10 1000

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

--pct-trackball ｛+百分比｝
调整轨迹事件的百分比(轨迹事件由一个或几个随机的移动组成，有时还伴随有点击)
adb shell monkey -p com.htc.Weather --pct-trackball 30 1000
--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 50 1000

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

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

--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%。