monkey命令详解

Android上压力测试命令monkey详解
一、Monkey 是什么
◆Monkey是Android SDK中附带的一个命令行工具，可以运行在模拟器或者实际设
备中
◆向系统发送伪随机的用户事件流（按键输入、触摸屏输入、手势输入等）
◆实现对正在开发的应用程序进行压力测试
◆Monkey测试是一种为了测试软件的稳定性、健壮性的快速有效的方法
二、Monkey程序介绍
◆Monkey程序由Android系统自带，使用Java语言写成，在Android文件系统中
的存放路径是：/system/framework/monkey.jar
◆Monkey.jar程序是由一个名为“monkey”的Shell脚本来启动执行，shell脚本在
Android文件系统中的存放路径是：/system/bin/monkey
三、Monkey 测试的目的
开发人员结合monkey 打印的日志和系统打印的日志，分析测试中出现的问题
◆ANR问题：在日志中搜索“ANR”
◆崩溃的问题：在日志中搜索“Exception”
说明：
ANR：Application Not Responding，在Android中，如果应该程序有一段时间响应不够灵敏，系统会向用户显示一个对话框，这个对话框称作应用程序无响应对话框，用户可以选择“等待”而让程序继续运行，也可以选择“强制关闭”应用。

好的程序应该能流畅运行，不能出现ANR问题。

四、Monkey 测试的特点
◆测试的对象仅为应用程序包，有一定的局限性（不能对源码进行测试）
◆测试使用的所有事件流数据流都是随机产生的，不能进行自定义，不带任何人的主
观性
◆可对MonkeyTest的对象，事件数量，类型，频率等进行设置
五、Monkey 命令详解
1、标准的monkey 命令
[adb shell] monkey [options] <eventcount>
如果不指定options，Monkey将以无反馈模式启动，并把事件任意发送到安装在目标环境中的全部包
如：adb shell monkey -p -v 500
-p 指定测试程序包名
-v 显示默认程度的信息
500 事件数设定为500
启动指定的应用程序，并向其发送500个伪随机事件，作用在系统中所有activity（其实也不是所有的activity，而是包含Intent.CATEGORY_LAUNCHER 或
Intent.CATEGORY_MONKEY 的activity）
上面只是一个简单的例子，实际情况中通常会有很多的options 选项
2、四大类——常用选项、事件选项、约束选项、调试选项
✧常用选项
--help：打印帮助信息，列出简单的用法
adb shell monkey –help
✧-v：指定打印信息的详细级别（即：日志的详细程度），一个-v增加一个级别
*如：*adb shell monkey -p packagename -v -v – throttle 600 88
-v -v ：Level 1，提供较为详细的测试信息，如：逐个发送到Activity的事件
--throttle 600：每个操作都间隔时间600ms
88：执行的事件数
Monkey报告等级总共3级，默认级别为0
Level 0（缺省值），除启动提示、测试完成和最终结果之外，提供较少信息
adb shellmonkey -p packagename -v 100
Level 1，提供较为详细的测试信息，如：逐个发送到Activity的事件信息
adb shellmonkey -p packagename -v -v 100
Level 2，提供更加详细的设置信息，如：测试中被选中的或未被选中的Activity
adb shellmonkey -p packagename -v -v -v 100
2）事件选项
✧-s<seed>：指定伪随机数生成器的seed值，如果用相同的seed值再次运行Monkey，
则两次Monkey测试所产生的事件序列相同
举例：
Monkey测试1：adb shell monkey -p packagename -s 10 100
Monkey测试2：adb shell monkey -p packagename -s 10 100
两次测试的效果是相同的
说明：
模拟的操作序列（每次操作按照一定的先后顺序所组成的一系列操作，即一个序列）虽然是随机生成的，但是只要我们指定了相同的Seed值，就可以保证两次测试产生的随机操作序列是完全相同的，所以这个操作序列是伪随机的
✧--throttle<milliseconds>：指定每个事件结束后的间隔时间，单位毫秒
举例：
adb shell monkey -p packagename -throttle 100
说明：
指定了固定的延迟时间后，可以减缓Monkey的执行速度，降低系统的压力。

如果不指定，系统会尽可能快的发送事件序列
✧--pct -{+事件类别}{+事件类别百分比}：指定每种类别事件的百分比（在Monkey事件
序列中，该类事件数目占总事件数目的百分比）
a、--pct-touch<percent>：指定触摸事件的百分比，即：设置在整个过程中点击操作
所占的百分比（触摸事件是一个down-up事件，它发生在屏幕上的某单一位置）
示例：adb shell monkey -p packagename --pct-touch 10 1000
b、--pct-motion <percent>：指定滑动事件的百分比（动作事件由屏幕上某处的一个
down事件、一系列的伪随机事件和一个up事件组成）
示例：adb shell monkey -p packagename --pct-motion 20 1000
c、--pct-trackball <percent>：指定轨迹球事件的百分比，即：设置滚轮在所用操作中
的百分比（轨迹事件由一个或几个随机的移动组成，有时还伴随有点击）
示例：adb shell monkey -p packagename --pct-trackball 30 1000
d、--pct-nav <percent>：指定"基本"导航事件的百分比（导航事件由来自方向输入设
备的up/down/left/right组成）
示例：adb shell monkey -p packagename --pct-nav 40 1000
e、--pct-majornav <percent>：指定主要导航事件的百分比（导航事件通常引发图形
界面中的动作，如：5-way键盘的中间按键、回退按键back key、菜单按键menu key）示例：adb shell monkey -p packagename --pct-majornav 50 1000
f、--pct-syskeys <percent> ：指定"系统"按键事件的百分比（这些按键通常被保留，
由系统使用，如：Home、Back、startCall、endCall、volumeControl）
示例：adb shell monkey -p packagename --pct-syskeys 60 1000
g、--pct-appswitch <percent>：指定启动Activity的百分比（在随机间隔里，Monkey
将执行一个startActivity()调用，作为最大程度覆盖包中全部Activity的一种方法）
示例：adb shell monkey -p packagename --pct-appswitch 70 1000
h、--pct-anyevent <percent>：指定其他类型事件的百分比（包罗了所有其它类型的
事件，如：按键、其它不常用的设备按钮等等）
示例：adb shell monkey -p packagename --pct -anyevent 100
说明：指定多个类型事件的百分比，各事件类型的百分比总数不能超过100%
示例：adb shell monkey -p packagename --pct-anyevent 70 --pct-appswitch 30 1000 3）约束选项
✧-p：指定有效的一个或多个package（即：app）
说明：
a、指定包后，Monkey将只允许系统启动指定的app；若不指定任何包，Monkey将允许系统启动设备中的所有app
b、要指定多个包，需要使用多个-p选项，每个-p选项只能对应一个有效的包
指定一个包：adb shell monkey -p packagename 100
指定多个包：adb shell monkey -p packagename -p packagename -p packagename 100 100是事件计数，即：让Monkey程序模拟100次随机用户事件
不指定包：adb shell monkey 100
表示Monkey随机启动APP并发送100个随机事件
c、要查看当前设备中所有的包，可在CMD窗口中执行以下命令：
>adb shell
#cddata/data
#ls
✧-c：指定有效的一个或多个category
说明：
a、activity必须至少包含一个指定的category，才能被启动，否则启动不了
b、指定的category后Monkey将只允许系统启动被这些类别中的某个类别列出的Activity，否则启动不了
c、若不指定任何类别，Monkey将选择下列类别中列出的Activity：
Intent.CATEGORY_LAUNCHER 或Intent.CATEGORY_MONKEY
d、要指定多个类别，需要使用多个-c选项，每个-c选项只能用于一个类别
4）调试选项
✧--dbg-no-events：初始化启动的activity，但是不产生任何事件。

为了得到最佳结果，
把它与-v、一个或几个包约束、以及一个保持Monkey运行30秒或更长时间的非零值联合起来，从而提供一个环境，可以监视应用程序所调用的包之间的转换
✧--hprof：指定该项后在Monkey事件序列发送前后会立即生成profiling分析报告（一般
建议指定该项）
说明：这会在data/misc中生成大文件(~5Mb)，所以要小心使用它
✧--ignore-crashes：忽略崩溃，即：指定当应用程序崩溃或发生任何失控异常时（Force&
Close错误），Monkey是否停止运行，若使用该参数，Monkey会继续向系统发送事件，直到事件计数完成
示例1：adb shellmonkey -p packagename --ignore-crashes 1000
测试过程中即使程序崩溃，Monkey依然会继续发送事件直到事件数目达到1000为止示例1：adb shellmonkey -p packagename 1000
测试过程中，如果程序崩溃，Monkey将会停止运行
✧--ignore-timeouts：忽略超时，即：指定当应用程序发生任何超时错误（如：Application
Not Responding）时，Monkey是否停止运行，若使用该参数，Monkey将继续向系统发送事件，直到事件计数完成
✧--ignore-security-exceptions：忽略安全异常，即：指定当应用程序发生许可错误（如：
启动一个需要证书许可或网络许可的app）时，Monkey是否停止运行，若使用该参数，Monkey将继续向系统发送事件，直到事件计数完成
✧--kill-process-after-error：发生错误后直接杀掉进程，即：指定当应用程序发生错误时，
是否停止其运行，若使用该参数，当前应用程序将停止运行并保持在当前状态
说明：当前应用程序只是静止在发生错误时的状态，系统并不会结束该应用程序的进程
✧--monitor-native-crashes：指定是否监视并报告当前应用程序在Android系统中本地方
法的崩溃事件
✧--wait-dbg：停止执行中的Monkey，直到有调试器和它相连接了才执行monkey测试
综上常用的参数介绍，举一个简单的monkey命令
adb shell monkey -p com.testapp.app -s 500 -v 10000
说明：工作中为了保证测试数量的完整进行，我们一般不会在发生错误时立刻退出压力测试。

monkey 测试命令如下：
adb shell monkey -p com.testapp.app -s 500 --ignore-crashes --ignore-timeouts
--monitor-native-crashes -v -v -v 10000 >
E:\Work_Project\monkey_log\java_monkey_log.txt
monkey作用的包：com.testapp.app
产生时间序列的seed值：500
忽略程序崩溃、忽略超时、监视本地程序崩溃、详细信息级别为2，产生10000个事件。

六、Monkey测试的停止条件
Monkey Test执行过程中在下列三种情况下会自动停止：
1、如果限定了Monkey运行在一个或几个特定的包上，那么它会监测试图转到其它包的操作，并对其进行阻止。

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

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

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

七、Monkey命令结果分析
1、找monkey里出错的地方
2、查看monkey里出错前的一些事件动作，并手动执行该动作
3、若以上步骤还不能找出，使用之前执行的monkey命令再执行一遍，seed值要一样（seed值一样，发送的伪随机事件流也一样）
4、注意第一个switch以及其他信息（seed值和，不同event类型比例）。