Monkey Android API 翻译

此篇笔记，记录了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 <脚本文件>。

前两个命令很容易理解，可通过文档来记录黑名单或白名单包，第三个命令可执行用户自定义的脚本文件。