adb之monkey（七)

一，monkey

　　1，Monkey测试是Android平台自动化测试的一种手段，通过Monkey程序模拟用户触摸屏幕、滑动Trackball、按键等操作来对设备上的程序进行测试，检测程序多久的时间会发生异常     官方介绍: https://developer.android.com/studio/test/monkey.html

　　2，monkey什么时候用？等我们产品稳定了，没有特别多的bug的时候，一般用monkey去测试待测应用的稳定性，健壮性(是否会发生闪退，崩溃)，手机出厂前的整机测试等

　　3，monkey是使用Java语言写成，在Android文件系统中的存放路径是：/system/framework/monkey.jar，Monkey.jar程序是由一个名为“monkey”的Shell脚本来启动执行，shell脚本在Android文件系统中的存放路径是：/system/bin/monkey

二，Monkey 命令启动方式　

　　a. 可以通过PC机CMD窗口中执行: adb shell monkey ｛+命令参数｝来进行Monkey测试

　　b. 在PC上adb shell 进入Android系统，通过执行monkey {+命令参数} 来进行Monkey 测试

　　c. 在Android机或者模拟器上直接执行monkey 命令，可以在Android机上安装Android终端模拟器

三，monkey的特征

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

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

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

四，monkey的命令

　　1，adb shell monkey -v -p <package_name> 500　　　

　　　　-p 对象包

      　　 -v 反馈信息级别

　　2，monkey的参数说明：运行adb shell monkey -help

　　　　

 　　3,monkey的参数说明

　　　　

　　　　

 　　　　

　　　　

 　　4，monkey的执行命令

　　　　adb shell monkey-p com.hst.che --throttle 500 -s 100 --ignore-crashes --ignore-timeouts --ignore-security-exceptions --ignore-native-crashes --monitor-native-crashes -v -v -v 1000>D:androidmonkey_log16v3.txt 

　　　　参数说明：　　　　

　　　　　　-s :伪随机数生成器的 seed 值。如果用相同的 seed 值再次运行 Monkey ，它将生成相同的事件序列。

　　　　　　--throttle :在事件之间插入固定延迟。通过这个选项可以减缓 Monkey 的执行速度。如果不指定该选项， Monkey 将不会被延迟，事件将尽可能快地被产成。

 　　　　　　-p:　　如果用此参数指定了一个或几个包，Monkey将只允许系统启动这些包里的Activity。 如果你的应用程序还需要访问其它包里的Activity(如选择取一个联系人)，那些包也需要在此 同时指定。如果不指定任何包，

　　　　　　　　　　Monkey将允许系统启动全部包里的Activity。要指定多个 包，需要使用多个 -p选项，每个-p选项只能用于一个包。

　　　　　--kill-process-after-error:  通常，当Monkey由于一个错误而停止时，出错的应用程序将继续处于运行状态。当设置了此选项时，将会通知系 统停止发生错误的进程。

　　　　　　　　　　　　　　　　　　注意，正常的(成功的)结束，并没有停止启动的进程，设备只是在　　结束事件之 后，简单地保持在最后的状态　

　　　　--ignore-timeouts:　　通常，当应用程序发生任何超时错误(如“Application Not Responding”对 话框)时，Monkey将停止运行。如果设置此选项，Monkey将继 续向系统发送事件，直到计数完成　

　　　　--ignore-security-exceptions:  通常，当应用程序发生许可错误(如启动一个需要某些许可的Activity)时，Monkey将 停止运行。如果设置了此选项，Monkey将继续向系统发送事件，直到计数完成

　　　　-v:命令行的每一个 -v 将增加反馈信息的级别。 Level 0( 缺省值 ) 除启动提示、测试完成和最终结果之外，提供较少信息。 Level 1 提供较为详细的测试信息，如逐个发送到 ActivITy 的事件。

　　　　　　Level 2 提供更加详细的设置信息，如测试中被选中的或未被选中的 Activity 。下面的例子使用了"-v -v -v"，表示输出最详尽的monkey log。

　　　5，实例

　　　　adb shell monkey -p com.xiaomi.sc -v -v -v --throttle 200 -s 1 --ignore-crashes --ignore-timeouts --ignore-native-crashes --pct-touch 30 100000 2>/Users/admin/Desktop/error.txt 1>/Users/admin/Desktop/info.txt

　　　　

 　　　　

 五，事件类命令

　　　　1，adb shell monkey -f <scriptfile> <event-count>　

　　　　-f:后接测试脚本名，表示要使用monkey运行指定的monkey脚本

　　　　2，adb shell monkey -f /mnt/sdcard/test01 3

　　　　　　这里的3是指循环次数，不是事件数

　　　　3，adb shell monkey --pct-touch <percent>　　　　　

　　　　　　--pct-touch:后面接触摸事件百分比，触摸事件泛指发生在某一位置的一个down-up事件，点击

　　　　4，adb shell monkey --pct-montion <percent>　　　　

　　　　　　--pct-motion:后面接动作事件百分比，动作事件泛指从某一位置接下（即down事件）后经过一系列伪随机事件后弹出（即up事件）

　　　　5，adb shell monkey --pct-trackball <percent>　　　　　

　　　　　　--pct-trackball:后面接轨迹事件百分比，轨迹事件包括一系列的随机移动，以及偶尔跟随在移动后面的点击事件

　　　　6，adb shell monkey --pct-nav <percent>　　　　

　　　　　　--pct-nav:后面接基本导航事件百分比，基本导航事件主要来自方向输入设备的上、下、左、右事件

　　　　7，adb shell monkey --pct-majornav <percent>

　　　　　　--pct-marjornav:后面接主要导航事件百分比，主要导航事件通常指引发图形界面的一些动作，如键盘中间按键、返回按键、菜单按键

　　　　8，adb shell monkey --pct-syskeys <percent>　　　　　

　　　　　　--pct-syskeys:后面接系统按键事件百分比，系统按键事件通常指仅供系统使用的保留按键，如HOME键、BACK键、拨号键、挂断键、音量键等

　　　　9，adb shell monkey --pct-appswtich <percent>　　　　

　　　　　　--pct-appswitch:后面接应用启动事件百分比，应用启动事件（activity launches)即打开应用，通过调用startActivity()方法最大限度地开启该package下的所有应用

　　　　10，adb shell monkey --pct-anyevent <percent>　　

　　　　　　--pct-anyevent:后面接其他类型事件百分比，其他类型事件指上文中未涉及的所有其他事件，如keypress、不常用的button等

 　　　　

　六，约束类命令

　　　　约束类命令可以让随机事件运行的范围限制在某几个包或类中

　　　　1，adb shell monkey -p <allowed-package-name>  <event-count>　　　　　　

　　　　后面接一个或多个包名,如果不指定任何包，monkey将允许系统启动全部包里的Activity。每个-p对应一个包，指定多个包时每个包名前都需要加上-p

　　　　2，adb shell monkey -c <main-category>  <event-count>　　　

　　　　-c:后面接一个或多个类别名，monkey将只允许系统启动这些类别中某个类别列出的Activity，如果不指定任何类别，monkey将选择Intent.CATEGORY_LAUNCHER和Intent.CATEGORY_monkey里的Activity，

　　　　每个-c对应一个类别，指定多个类别时每个类别名前面都需要加上-c

　七，调试类命令　　

　　　　通过调试类命令可以对monkey进行简单的调试，这样可以快速定位monkey运行中的问题　　　　

　　　　1，adb shell monkey --dbg-no-events  <event-count>　　

　　　　--dbg-no-events：设置此项后，monkey将进行初始启动，进入到某个测试Activity中不会进一步生成事件，可以监视应用程序所调用的包之间的转换，为了更好的跟踪，一般该项会与-v(日志）、-p<allowed-package-name> （包约束）

　　　　 和 --throttle<milliseconds> (延迟）等联合使用

　　　　2，adb shell monkey --hprof  <event-count>　　　

　　　　--hprof:设置此项后，将在monkey事件序列前后立即生成profilfing report，将在data/misc中生成5MB左右大小的文件

　　　　3，adb shell monkey --ignore-crashes  <event-count>

　　　　-ignore-crashes:设置此项后，当应用程序崩溃或发生失控异常时，monkey将继续运行直到计数完成。如果不设置此项，monkey遇到上述崩溃或异常将停止运行

　　　　4，adb shell monkey --ignore-timeouts  <event-count>　　　

　　　　--ignore-timeouts:设置此项后，当应用程序发生任何超时错误（如ANR，即Application Not Responding)时，monkey将继续运行直到计数完成。如果不设置此项，monkey 遇到此类超时将停止运行

　　　　5，adb shell monkey --kill-process-after-error  <event-count>　　

　　　　--kill-process-after-error:设置此项后，当monkey因为应用程序发生错误而停止时，将会通知系统停止发生错误的进程。如果不设置此项，monkey停止时发生错误的应用程度将继续处于运行状态

　　　　6，adb shell monkey --ignore-security-exceptions <event-count>

　　　　--ignore-security-exceptions：设置此项后，当应用程序发生任何权限错误（如启动一个需要某些权限的Activity)时，monkey将继续运行直到计数完成。如果不设置此项，monkey遇到此类权限错误将停止运行

　　　　7，adb shell monkey --monitor-native-crashes  <event-count>

　　　　--monitor-native-crashes:设置此项后，monkey运行时native code的崩溃事件将被监视并报告。如果不设置此选项，将不会监视此类事件。

　　　　8，adb shell monkey --wait-dbg  <event-count>

　　　　--wait-dbg:在设置此项后，将暂停执行中的monkey，直到有调试器与它连接

 　　　　

　八，monkey报告的组成

　　　　

　　1.第一部分：包含 seed值，执行次数、包名

　　　　

 　　2，被测设备上的所有应用包名，本次测试使用到哪些包，未使用哪些包（建议测试某app时，杀掉其他应用进程）

　　　　

　　3，各个事件所占百分比，只显示了事件的代号，没有显示具体什么时间，可以查询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组成)

　　--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 ｛+百分比｝

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

　　 --pct -anyevent  ｛+百分比｝

　　指定多个事件的百分比

　　adb shell monkey -p com.htc.Weather--pct-anyevent 50 --pct-appswitch 50 1000

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

　　4，具体事件

　　

　　5，log　　

　　如果Monkey测试顺利执行完成，在log的最后，会打印出当前执行事件的次数和所花费的时间；// Monkey finished代表执行完成。

　　如果Monkey执行中断，在log的最后也能查看到当前已执行的次数。Monkey执行完成的log具体如下：

　　Events injected: 6000

　　:Dropped: keys=0 pointers=9 trackballs=0 flips=0

　　## Network stats: elapsed time=808384ms (0ms mobile, 808384ms wifi, 0msnot connected)

　　// Monkey finished

九，报告分析　

　　测试结束后，需要将手机连接PC，拷贝以下文件：

　　info.txt：此文件在手机上的SDCARD中，主要记录了MONKEY测试时发送的各种事件，如触摸事件的位置等等。

　　error.txt：此文件在手机上的SDCARD中，主要记录了MONKEY测试时产生的一些ANR、强制关闭等异常。

　　LOG文件：此文件在手机上的LOG文件夹中中，主要主要记录程序对MONKEY测试时的响应情况。

　　1.在日志中搜索关键字：

　　1）搜索报告中的关键字“ANR”，看有无应用无响应的事件（Application Not Responding）

　　2）搜索报告中的关键字“crash”,看有无崩溃的事件

　　3）搜索报告中的关键字“exception”，看有无其他异常事件。（如果出现空指针， NullPointerException，需格外重视

　　下面的属于monkey自己的问题。不用管。

　　:Sending Flip keyboardOpen=false

　　Got IOException performing flipjava.io.IOException: write failed: EINVAL (Invalid argument)

　　// Injection Failed

　　4）内存泄露问题搜索"GC"（需进一步分析）

　　2. 初步分析法： monkey出现错误后，一般的分析步骤

　　1）先找到出现错误的位置

　　2）查看出现错误之前2个switch之间的activity

　　3）手动执行事件，复现问题

　　4）若以上步骤还不能找出，产生错误时，有会seed值，输入相同的seed值，重新按照之前命令跑monkey

　　3.详细分析法：

　　1） ANR问题：在日志中搜索“ANR”(“Application Not Responding")，说明有bug，出现ANR，一般是主线程的响应超过5秒，或者BroadcastReceiver没有在10秒内作出响应。这个就是一个比较严重的缺陷。把耗时的操作另起线程来处理就可以了。

　　2）分析log中的具体信息：

　　查看log中第一个Switch，主要是查看Monkey执行的是那一个Activity，譬如下面的log中，执行的是com.tencent.smtt.SplashActivity，在下一个swtich之间的，如果出现了崩溃或其他异常，可以在该Activity中查找问题的所在。

　　:Switch:#Intent;action=android.intent.action.MAIN;category=android.intent.category.LAUNCHER;launchFlags=0x10000000;component=com.tencent.smtt/.SplashActivity;end

 　　 //Allowing start of Intent {act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER]cmp=com.tencent.smtt/.SplashActivity } in package com.tencent.smtt

　　3)内存泄漏

　　1. 内存泄漏弹出out of memory对话框

　　2. 对于有内存泄漏但是没有单出out of memory对话框的情况，可以通过logcat文件GC出信息，(GC:java的垃圾回收机制)

　　GC_FOR_ALLOC: 因为在分配内存时候内存不够引起的

　　GC_EXPLICIT： 表明GC被显式请求触发的，如System.gc调用，

　　GC_CONCCURRENT: 表明GC在内存使用率达到一定的警戒值时候，自动触发

　　GC_BEFORE_OOM： 表明在虚拟机抛出内存不够异常oom之前，执行最后一次回收内存垃圾

　　2.发现内存泄露--内存报告分析（利用hprof参数的内存快照生成内存报告）

　　在发现内存泄露后，可以执行相同的monkey，只需多加一个参数--hprof

　　adb shell monkey -p 包名  --hprof --throttle 100  --pct-touch 50 --pct-motion 50 -v -v -v 1000 >c:monkey.txt

　　如果指定了这个选项，monkey会在发送时间的前后生成ａｐｐ内存快照文件，一般会在手机设备的/data/misc目录下生成hprof的文件。（注：  /data/misc  需要root权限，可

　　以在手机上安装个RE查看或通过手机助手查看）

　　ps：文件转换：配置monkey测试时的sdk-tools下查看是否hprof-conv命令，在命令行输入hprof-conv -help得知文件转化用法，直接转化就行，由.hprof转化成.conv格式。

　　转化后的文件用eclipse的Memory Analyzer tool(MAT)查看（此插件可以下载），可以点击 Reports->Leak Suspects链接来生成报告。