此篇笔记，记录了API中，对monkey用法的说明，基于Android Studio 2.2.3。
Monkey是一个运行在Android模拟器或者Android设备上的程序，通过使用monkey，应用程序可以模拟一系列的用户操作，例如点击、触摸、手势等等，同时也可以进行系统层面的操作。我们可以使用Monkey进行对app的压力测试，通过一种随机的但易于重复的方式。
综述：
Monkey是一个命令行工具，因此使用Monkey需要借助adb shell。
Monkey的使用需要输入许多的参数和选项，它们主要可以分为以下4种类型：
- 基本配置选项，例如：设置尝试操作事件的数量
- 约束配置参数，例如：用于测试的特定的包名
- 事件的类型和频率
- 调试选项
当Monkey运行时，它会生成事件并发送给系统。同时它也会观察系统在测试下的表现，并且侧重于检测以下三种情况的发生：
- 如果你限制了Monkey在一个或多个特定的包中运行，那么它会监测所有导向其他包的尝试，并阻止这些尝试。
- 如果你的应用崩溃了，或者捕获了任何没有处理的异常，Monkey会停止并报告这些错误。
- 如果你的应用失去响应，Monkey会停止并报告这些错误。
Monkey的基本用法：
Monkey使用时需要连接模拟器或者设备，相关的命令行可以通过脚本或命令行工具执行，基础的用例如下：
$ adb shell monkey [options]<event-count>
如果不输入任何特定参数的话，Monkey会进入quiet mode，这是会发送操作到目标设备上的所有已安装app。
标准的命令行用法如下，以下代码会打开特定的应用并发送500个伪随机事件：
$ adb shell monkey -p your.package.name -v 500
命令参数列表：
下面的表格列出了你可以在Monkey中使用的所有参数：
| 目录 | 选项 | 描述 |
|---|---|---|
| 通用 | –help | 打印简单的参考用法（表格中可能会将双横线显示为长横线，使用时需注意） |
| -v | 命令中的每个 -v 将增加报告的详细程度。 级别0（默认值）提供了除测试启动、完成和最终结果之外的很少信息； 级别1提供了测试运行时的更多详细信息，例如发送到活动的各个事件； 级别2提供了更详细的设置信息，例如选中或未被选中的用于测试的活动。 |
|
| 事件 | -s <seed> | 种子可以标记伪随机数生成器。如果使用相同的种子值重新运行Monkey，它将生成相同的伪随机事件序列。 |
| –throttle <ms> | 用于在事件之间插入延迟 | |
| –pct-touch <percent> |
调整触摸时间的百分比，相应的，可以将touch改为motion：滑动事件；pinchzoom：二指缩放事件； trackball：轨迹时间，随机移动和点击；rotation:屏幕旋转事件； nav：基本导航事件，例如上下左右的方向输入；majornav：主要导航事件，包括菜单键，返回键等； syskeys：系统按建； appweitch：启动activity的百分比，在随机间隔后，调用startactivity方法尽可能启动该package下所有activity； anyevent：其他类型的事件 |
|
| 约束 | -p <allowed-package> |
指定包名，需要注意，每个p选项只能指定一个包名，如果需要测试多个包，需要使用多个p选项 |
| -c <main-category> |
||
| 调试 | –dbg-no-events | 设置此选项，Monkey将执行初始启动，进入一个测试Activity，不会再进一步生成事件。 为了得到最佳结果，可以把它与-v、一个或几个包约束，以及一个保持Monkey运行30秒或更长时间的 非零值结合起来，从而提供一个监控应用程序所调用的包之间的转换的环境。 |
| –hprof | 设置此选项，将会生成Monkey执行前后的内存快照，存放于data/misc目录， 可以用来监控内存泄漏，但由于内存快照文件较大，需小心使用 |
|
| –ignore-crashes | 出现crash暂不退出 | |
| –ignore-timeouts | 出现timeout暂不退出，例如application not responding | |
| –ignore-security -exceptions |
出现许可错误暂不退出，例如启动一个需要某些许可的Activity | |
| –kill-process -after-error |
通常，当Monkey由于错误而停止时，出错的应用汇继续运行。 设置此选项，会通知系统停止发生错误的进程 |
|
| –monitor-native -crashes |
监视并报告Android系统中本地代码的崩溃事件 | |
| –wait-dbg | 停止执行Monkey，直到有调试器和它相连接 |
以上为Android官方文档中给出的Monkey命令介绍，部分命令由于自己使用较少，翻译时参考了《腾讯Android自动化测试实战》一书中的内容，今后随着自己对Android测试的深入了解会继续补充修改。在该书中，还给出了三个隐藏类参数，分别为–pkg-blacklist-file<黑名单包>；–pkg-whitelist-file<白名单包>；-f <脚本文件>。
前两个命令很容易理解，可通过文档来记录黑名单或白名单包，第三个命令可执行用户自定义的脚本文件。