简介
Monkey是一种 command-line 工具, 您可以在任何模拟器或设备上运行它。它将用户事件的伪随机流发送到系统中, 作为对您正在开发的应用程序软件的压力测试。
Monkey包括许多选项, 但它们分成四主要类别:
基本配置选项, 如设置要尝试的事件数。
操作限制, 例如将测试限制为单个包。
事件类型和频率。
调试选项
当Monkey运行时, 它生成事件并将它们发送到系统。它也观察系统在被测试的情况下和寻找三条件, 它特别对待:
如果您限制了Monkey在一个或多个特定的包中运行, 它会监视尝试导航到任何其他包, 并阻止它们。
如果您的应用程序崩溃或收到任何类型的未经处理的异常, Monkey将停止并报告错误。
如果应用程序生成的应用程序没有响应错误, Monkey将停止并报告错误。
根据您选择的详细级别, 您还将看到有关Monkey的进度和正在生成的事件的报告。
存放路径 Monkey程序是Android系统自带的，由Java语言写成，在Android文件系统中的存放路径是： /system/framework/monkey.jar。
大致操作流程 通过名为“monkey”的Shell脚本去启动Monkey.jar程序（shell脚本在Android文件系统中 的存放路径是：/system/bin/monkey），在你指定的APP应用上模拟用户点击，滑动，输入等操作以极快的速度来对设备程序进行压力测试，检测程序是否会发生异常，然后通过日志进行排错。
主要目的 测试app 是否会是否会Crash。
基本格式
您可以从命令行或脚本启动Monkey。因为Monkey在模拟器/设备环境中运行, 所以您必须从该环境中的 shell 启动它。您可以'adb shell'开头 来执行此命令, 或者直接进入 shell 并输入Monkey命令。
基本语法是:
$ adb shell monkey [选项] <event-count>
在没有指定选项的情况下, monkey将以安静 (详细) 模式启动, 并将事件发送到您的目标上安装的任何 (和所有) 软件包。下面是一个更典型的命令行, 它将启动应用程序并向其发送500伪随机事件:
$ adb shell monkey -p com.android.browser -v 500
参数
| Category | Option | Description |
|---|---|---|
| General | –help | 打印简单的用途向导 |
| -v | 命令行中的每个 v 都将增加详细级别。级别 0 (默认值) 除了启动通知、测试完成和最终结果外, 没有提供任何信息。1级在运行时提供了有关测试的更多详细信息, 如向活动发送的单个事件。级别2提供了更详细的设置信息, 如选择的或未选择用于测试的活动。 | |
| Events | -s <seed> | 伪随机数发生器的种子值。如果您重新运行具有相同种子值的monkey, 它将生成相同的事件序列。 |
| –throttle <milliseconds> | 在事件之间插入固定的延迟。你可以使用这个选项来减慢monkey的速度。如果未指定, 则不存在延迟, 并且会尽可能快地生成事件。 | |
| –pct-touch <percent> | 调整触摸事件的百分比。(触摸事件是屏幕上单个位置的 down-up 事件。 | |
| –pct-motion <percent> | 调整运动事件的百分比。(运动事件由屏幕上某处的向下事件、一系列伪随机运动和向上事件组成。 | |
| –pct-trackball <percent> | 调整轨迹球事件的百分比。(轨迹球事件由一个或多个随机动作组成, 有时后跟单击 | |
| –pct-nav <percent> | 调整 “基本” 导航事件的百分比。(导航事件由上/下/左/右, 作为来自定向输入设备的输入。 | |
| –pct-majornav <percent> | 调整 “主要” 导航事件的百分比。(这些导航事件通常会导致用户界面中的操作, 如5-way pad 中心按钮、后退键或菜单键。 | |
| –pct-syskeys <percent> | 调整 “系统” 关键事件的百分比。(这些密钥通常保留供系统使用, 如 “主页”、“后退”、“开始呼叫”、“结束呼叫” 或 “音量控制”。 | |
| –pct-appswitch <percent> | 调整活动启动的百分比。在随机的时间间隔, monkey将发出一个 startActivity () 调用, 作为一种方法, 最大限度地覆盖所有活动在您的包。 | |
| –pct-anyevent <percent> | 调整其他类型事件的百分比。这是所有其他类型的事件 (如按键、设备上其他较少使用的按钮等等) 的全部捕获。 | |
| Constraints | -p <allowed-package-name> | 如果您以这种方式指定一个或多个包, monkey将只允许系统访问这些包中的活动。如果您的应用程序需要访问其他包中的活动 (例如, 选择联系人), 您还需要指定这些包。如果您不指定任何软件包, monkey将允许系统在所有包中启动活动。要指定多个包, 请使用-p 选项多次-每包一-p 选项。 |
| -c <main-category> | 如果您以这种方式指定一个或多个类别, 则monkey将只允许系统访问与指定类别之一一起列出的活动。如果您不指定任何类别, monkey将选择与类别意向列出的活动. CATEGORY_LAUNCHER 或意图. CATEGORY_MONKEY要指定多个类别, 请使用-c 选项多次-每类别一-c 选项。 | |
| Debugging | –dbg-no-events | 如果指定, monkey将执行初始登录到到一个测试活动, 但不会产生任何进一步的事件。为了得到最好的结果, 结合-v, 一个或多个包约束, 和一个非零 –throttle, 以保持monkey运行超过30秒。这提供了一个环境, 您可以在其中监视应用程序调用的包转换。 |
| –hprof | 如果设置, 此选项将在monkey事件序列前后立即生成分析报告。这将产生大 (〜 5 mb) 文件的数据, 所以使用谨慎。有关跟踪文件的详细信息, 请参阅 Traceview。 | |
| –ignore-crashes | 通常情况下, 当应用程序崩溃或遇到任何类型的未经处理的异常时, monkey就会停止。如果指定此选项, 则monkey将继续向系统发送事件, 直到计数完成。 | |
| –ignore-timeouts | 通常情况下, 当应用程序遇到任何类型的超时错误 (如 “应用程序未响应” 对话框) 时, 该monkey就会停止。如果指定此选项, 则monkey将继续向系统发送事件, 直到计数完成。 | |
| –ignore-security-exceptions | 通常情况下, 当应用程序遇到任何类型的权限错误时, 例如, 如果它尝试启动需要某些权限的活动, 则该monkey将停止。如果指定此选项, 则monkey将继续向系统发送事件, 直到计数完成。 | |
| --ignore-native-crashes | 当应用底层发生c/c++崩溃时，monkey就会停止。如果指定此选项, 则monkey将继续向系统发送事件, 直到计数完成 | |
| –kill-process-after-error | 通常情况下, 当monkey由于错误而停止时, 失败的应用程序将被保留运行。设置此选项后, 系统将发出信号, 以停止发生错误的进程。注意, 在正常 (成功) 完成后, 启动的进程 (es) 不会停止, 并且该设备仅在最后一个事件之后的最后一个状态中保留。 | |
| –monitor-native-crashes | 监视和报告在 Android 系统本机代码中发生的崩溃。如果设置了-kill-process-after-error, 系统将停止。 |
例子
1） 常用的例子：
adb shell monkey -p com.vlife.stage -s 500 --throttle 100 --ignore-crashes --ignore-timeouts --monitor-native-crashes -v -v 10000
产生时间序列的种子值：500，事件间延迟 100 忽略程序崩溃 、 忽略超时 、 监视本地程序崩溃 、 详细信息级别为2 ， 产生 10000个事件
2）
adb shell monkey -p com.vlife.stage --throttle 100 --ignore-crashes --ignore-timeouts --kill-process-after-error
--pct-touch 35
--pct-syskeys 30
--pct-appswitch 35 --hprof -v -v -v 50000：
注意：这个命令定义了事件的百分比，但并没有定义种子值，在实际应用中是非常不推荐的，只有同样的种子值才会产生同样的序列，为了方便重现问题一定要加-s，
另外日志的级别建议选择详细级别，三个-v -v -v
日志导出
例如：保存到电脑上并命名为monkey.txt
adb shell monkey -p 包名 -v 1000 > E:/monkey.txt
例如：保存到电脑上标准流与错误流分开保存，分别命名为info.txt，error.txt
adb shell monkey -p 包名 -v 1000 1>E:/info.txt 2>E:/error.txt
快速从monkey.txt日志中看问题
测试结果初步判断
monkey执行时未加
--ignore-crashes参数，就先浏览日志中Events injected: 值，查看当前已执行的次数，就知道有无bug程序无响应的问题：在日志中搜索 “ANR”
崩溃问题：在日志中搜索 “Exception” ，在这里顺便提一下常见的Java异常：
算术异常类：ArithmeticExecption
空指针异常类：NullPointerException
类型强制转换异常：ClassCastException
数组负下标异常：NegativeArrayException
数组下标越界异常：ArrayIndexOutOfBoundsException
违背安全原则异常：SecturityException
文件已结束异常：EOFException
文件未找到异常：FileNotFoundException
字符串转换为数字异常：NumberFormatException
操作数据库异常：SQLException
输入输出异常：IOException
违法访问错误：IllegalAccessError
内存不足错误：OutOfMemoryError
堆栈溢出错误：StackOverflowError 15.其他，请参考：https://www.cnblogs.com/cvst/p/5822373.html
找出问题后的操作步骤：
找到是monkey里面的哪个地方出错
查看Monkey里面出错前的一些事件动作，并手动执行该动作
若以上步骤还不能找出，可以使用之前执行的monkey命令再执行一遍，注意seed值要一样。
Monkey日志讲解
伪随机种子数与事件总数
Monkey: seed=100 count=10000
允许测试包
AllowPackage: com.yulore.yellowpage
Category包含的LAUNCHER
IncludeCategory: android.intent.category.LAUNCHER
Category包含的MONKEY
IncludeCategory: android.intent.category.MONK
查询允许包的activity 结果列表
// Selecting main activities from category android.intent.category.LAUNCHER
这些都不是指定包的activity
// - NOT USING main activity com.android.calendar.AllInOneActivity (from package com.android.calendar)
// - NOT USING main activity com.android.camera.CameraLauncher (from package com.android.camera2)
// - NOT USING main activity com.android.contacts.activities.PeopleActivity (from package com.android.contacts)
从这也可以看出你手机上都安装了哪些应用，下面就是我们指定的包的activity
// + Using main activity com.yulore.yellowpage.activity.SplashActivity (from package com.yulore.yellowpage)
// Selecting main activities from category android.intent.category.MONKEY
种子为100
// Seeded: 100
事件百分比
// Event percentages:
// 0: 15.0%
// 1: 10.0%
// 2: 2.0%
// 3: 15.0%
// 4: -0.0%
// 5: -0.0%
// 6: 25.0%
// 7: 15.0%
// 8: 2.0%
// 9: 2.0%
// 10: 1.0%
// 11: 13.0%
查看log中第一个Switch，主要是查看 Monkey 执行的是那一个 Activity，譬如下面的 log 中，执行的是com.yulore.yellowpage/.activity.SplashActivity，
在下一个swtich之间的，如果出现了崩溃或其他异常，可以在该Activity中查找问题的所在。
:Switch: #Intent;action=android.intent.action.MAIN;category=android.intent.category.LAUNCHER;launchFlags=0x10200000;component=com.yulore.yellowpage/.activity.SplashActivity;end
// Allowing start of Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=com.yulore.yellowpage/.activity.SplashActivity } in package com.yulore.yellowpage
sleeping for 0 milliseconds这句 log 是执行Monkey测试时，throttle设定的间隔时间，每出现一次，就代表一个事件。(这个事件是指从用户角度来说的一个事件，
比如点击：实际包括手指按下与抬起两个动作，monkey日记将被记为2个事件）
Sleeping for 0 milliseconds
:Sending Key (ACTION_DOWN): 82 // KEYCODE_MENU
:Sending Key (ACTION_UP): 82 // KEYCODE_MENU
Sleeping for 0 milliseconds
:Sending Key (ACTION_DOWN): 23 // KEYCODE_DPAD_CENTER
:Sending Key (ACTION_UP): 23 // KEYCODE_DPAD_CENTER
Sleeping for 0 milliseconds
如果 Monkey 测试顺利执行完成，在 log 的最后，会打印出当前执行事件的次数和所花费的时间Monkey finished代表执行完成。Monkey 执行完成的 log 具体如下：
Events injected: 100
:Sending rotation degree=0, persist=false
:Dropped: keys=0 pointers=0 trackballs=0 flips=0 rotations=0
## Network stats: elapsed time=2042ms (0ms mobile, 0ms wifi, 2042ms not connected)
// Monkey finished
Monkey 执行中断，在 log 的最后也能查看到当前大约已执行的次数
:Sending Trackball (ACTION_MOVE): 0:(-3.0,1.0)
:Sending Trackball (ACTION_MOVE): 0:(4.0,0.0)
//[calendar_time:2018-04-02 11:23:50.322 system_uptime:718998]
// Sending event #7500
:Sending Trackball (ACTION_MOVE): 0:(3.0,-2.0)
异常结果crash
Sleeping for 0 milliseconds
:Sending Touch (ACTION_DOWN): 0:(796.0,301.0)
// CRASH: com.lenovo.leos.appstore (pid 27964)
// Short Msg: java.lang.RuntimeException
// Long Msg: java.lang.RuntimeException: Only one Looper may be created per thread
// Build Label: vivo/PD1616/PD1616:7.1.2/N2G47H/compil02262218:user/release-keys
// Build Changelist: eng.compil.20180226.221830
// Build Time: 1519654710000
:Sending Touch (ACTION_UP): 0:(793.6982,299.82098)// java.lang.RuntimeException: Only one Looper may be created per thread
// at android.os.Looper.prepare(Looper.java:89)
// at android.os.Looper.prepare(Looper.java:84)
// at android.os.HandlerThread.run(HandlerThread.java:54)
//
Sleeping for 0 milliseconds
(无需 Root) 基于 Android Monkey 二次开发，实现高速点击的 Android Monkey
https://testerhome.com/topics/11719
MonkeyScript
MonkeyScript 是官方提供的，除了像monkey一样随机乱点之外，还可以通过编写脚本的形式，完成一系列固定的操作。MS 提供一整套完善的API来进行支持，
主要还是基于坐标点的操作，包含常用的：点击、长按、输入、等待等操作。
MonkeyScript虽然需要编写测试脚本，但是实际上它还是属于 Monkey 命令的一部分，需要通过 Monkey 命令进行启动、运行。
adb shell monkey -f <MonkeyScript><EventCount>
可以看到，通过 -f 参数即可用于指定一个 MonkeyScript 脚本进行执行。
需要注意的是，因为 adb shell 的运行环境是在待测试的 Android 设备上，所以需要将MonkeyScript 脚本 pull 到待测试的设备上，然后再进行运行。
下有一段注释规定了monkey script的基本规则，如下
monkey event queue. It takes a script. to produce events
sample script. format:
type= raw events
count= 10
speed= 1.0
start data >>
captureDispatchPointer(5109520,5109520,0,230.75429,458.1814,0.20784314,
0.06666667,0,0.0,0.0,65539,0)
captureDispatchKey(5113146,5113146,0,20,0,0,0,0)
captureDispatchFlip(true)
type指明类型
count说明执行次数，但是这里改成任何值都执行一次，monkey命令可以指定执行次数，这里也就无所谓了
speed命令执行速率。改动无影响，可以通过monkey命令行指定。
以上三个参数改动都没什么影响，一般不做改动。
start data »相当于一个入口，说明脚本从下面开始执行
MonkeyScript常用API
MonkeyScript 其实提供了非常完备的API，具体细节请看源代码
1）点击事件（DispatchPointer） DispatchPointer 命令用于向一个指定的坐标位置，发送单个手势消息，一般用它来模拟点击的操作。
DispatchPointer ( downTime , eventTime , action , x , y , pressure , size , metaState , xPrecision , yPrecision , device , edgeFlags)
其实这么多参数，只需要关注action 、 x 、y 三个参数即可。
action ：事件是按下还是抬起，0 表示按下，1 表示抬起。x、y：表示当前事件触发的X轴和Y轴的坐标。也就是说，两个 DispatchPointer 命令加在一起，分别表示 按下 和 抬起 ，这表示一次点击操作，其余的参数，统一设置为 0 即可。
2）按键消息（DispatchKey）
DispatchKey 主要是用于发送一些 Android 标准的 EventKey 按键消息。但是需要写对应的值。
DispatchKey 消息的方法前面和 DispatchPointer 一样，所以同样也只需要关注 action、x、y 三个参数即可。
3）普通列表项目开启关闭软键盘（DispatchFlip）
DispatchFlip 命令用于打开或者关闭软键盘。DispatchFlip (keyboardOpen)
其中的参数，true 表示打开，false 表示关闭。
4）打开指定的Activity（LaunchActivity） LaunchActivity 命令用于打开任意应用的一个页面，但是前提条件是打开的Activity 需要属性 android:exported 被设定为true，才可以通过 LaunchActivity 打开。
LaunchActivity ( pkg_name , act_name )它的两个参数，分别表示打开的 App 的包名和打开的 Activity 的名称。
5）等待（UserWait） UserWait 命令用于让脚本中断执行一段时间。因为是脚本执行，多个事件之间执行的速度会非常的快，有时候我们需要等待一些事件触发之后的结果返回，需要等待一段时间之后，再继续执行脚本，这个时候就可以使用 UserWait 。
UserWait ( sleepTime )sleepTime 的单位是毫秒。
6） 输入字符串(DispatchString) DispatchString 命令用于向 Shell 输入一个字符串。
DispatchString( input )
input 就是一个字符串即可，但是 MS 对中文的支持并不好，所以尽量输入英文的测试数据。
7）运行 Shell 命令（RunCmd）
RunCmd 命令用于在设备上运行 shell 命令。当然这些 shell 命令必须是当前待测试设备支持的 shell 命令。
RunCmd ( cmd )
参数 cmd 就是需要执行的 shell 命令。
8）键盘事件（DispatchPress）
DispatchPress 命令用于模拟敲击键盘的事件。
DispatchPress( keyName )
还没有评论，来说两句吧...