Monkey

一个命令行测试工具，通过adb连接并运行在模拟器或者Android设备上，可以产生类似用户点击、触摸、手势以及一些系统级的伪随机事件流的程序。主要用于测试应用在随机、重复的操作下是否出现运行异常。

概述

Monkey主要分为四类选项:

• 基本配置选项，例如设置要尝试的事件的数量。
• 操作限制，例如将测试限制到单个应用包。
• 事件类型和频率。
• 调试选项。

当Monkey运行时，它会生成事件并将它们发送给系统。它观察被测试系统并寻找三个条件，并特别处理：

• 如果您已经限制Monkey在一个或多个特定包中运行，那么它将监视导航到任何其他包的尝试并阻止它们。
• 如果您的应用程序崩溃或接收任何未处理的异常，则Monkey将停止并报告错误。
• 如果您的应用程序生成一个ANR错误的应用程序，则Monkey将停止并报告错误。

根据您选择的日志详细级别，您还将看到关于Monkey的进展和正在生成的事件的报告。

Monkey的基本用法

您可以在开发的机器上使用命令行或脚本来启动Monkey。因为Monkey在模拟器/设备环境中运行，所以必须在该环境中使用shell启动它。

基本语法是：

$ adb shell monkey [options] <event-count>

没有指定任何选项，Monkey将以安静(非详细)模式启动，并将事件发送到目标设备上安装的任何(和所有)包。
这里有一个更典型的命令行，它将启动你的应用程序并发送500个伪随机事件给它：

$ adb shell monkey -p your.package.name -v 500

命令选项参考

• --help 打印一个简单的用法指南。

• -v 命令行上的每个V将增加详细级别。级别0（默认值）在启动通知、测试完成和最终结果之外提供的信息很少。级别1提供了测试运行时的详细信息，例如发送给您的activity的单个事件。级别2提供了更详细的设置信息，例如选择或未选择的测试activity。

• -s <seed> 伪随机数发生器的seed值。如果使用相同的seed值重新运行Monkey，它将生成相同的事件序列。

• --throttle <milliseconds> 在事件之间插入固定的延迟。你可以使用这个选项来减慢Monkey的速度。如果没有指定，则不会有延迟，并且事件会尽可能快地生成。

• --pct-touch <percent> 调整触摸事件的百分比。

• --pct-motion <percent> 调整运动事件的百分比。（运动事件由屏幕上某处的向下事件、一系列伪随机运动和一个向上事件组成）。

• --pct-trackball <percent> 调整跟踪球事件的百分比。（轨迹球事件由一个或多个随机运动组成，有时是单击）。

• --pct-nav <percent> 调整“基本”导航事件的百分比。（导航事件包括向上/向下/向左/向右，作为方向输入设备的输入）。

• --pct-majornav <percent> 调整“主要”导航事件的百分比。（这些导航事件通常会在UI中导致操作，例如5向垫中的中心按钮（确认键）、后键或菜单键）。

• --pct-syskeys <percent> 调整“系统”关键事件的百分比。（这些键通常是供系统使用的，例如Home键（主页键）、返回键、开始呼叫、结束呼叫或音量控制）。

• --pct-appswitch <percent> 调整activity的启动的百分比。Monkey会以随机的间隔调用startActivity()，作为最大化覆盖包中所有activity的方法。

• --pct-anyevent <percent> 调整其他类型事件的百分比。对于所有其他类型的事件，如按键、设备上其他使用较少的按钮，这是一个捕捉。

• -p <allowed-package-name> 如果用这种方式指定一个或多个包，则Monkey只允许系统访问这些包中的Activity。

• -c <main-category> 如果以这种方式指定一个或多个类别，Monkey将只允许系统访问列出了指定类别之一的Activity。如果没有指定任何类别，Monkey将选择Intent.CATEGORY_LAUNCHER或Intent.CATEGORY_MONKEY类别列出的Activity。若要指定多个类别，请使用-C选项多次，每个类别使用一个C选项。

• --dbg-no-events 当指定时，Monkey将执行初始启动到测试Activity，但不会生成任何其他事件。为了获得最佳效果，结合使用-v、一个或多个包约束和一个非零节流阀来保持Monkey运行30秒或更多。这提供了一种环境，在该环境中，您可以监视应用程序调用的包转换。

• --ignore-crashes 通常，当应用程序崩溃或遇到任何类型的未处理异常时，Monkey将停止。如果指定此选项，则Monkey将继续向系统发送事件，直到计数完成。

• --ignore-timeouts 通常，应用经历任何类型的超时错误如“应用程序没有响应”对话框时，Monkey将停止。如果指定此选项，则Monkey将继续向系统发送事件，直到计数完成。

• --ignore-security-exceptions 通常，Monkey会在应用程序遇到任何类型的权限错误时停止，例如，如果它试图启动需要某些权限的Activity。如果指定此选项，则Monkey将继续向系统发送事件，直到计数完成。

• --kill-process-after-error 正常情况下，当Monkey由于错误而停止时，应用程序将不能继续运行。当设置此选项时，它将通知系统停止发生错误的进程。注意，在正常（成功）完成时，所启动的进程不会停止，并且设备在最终事件之后仅处于最后状态。

• --monitor-native-crashes 监视和报告Android系统原生代码中发生的崩溃。如果设置了错误后的杀戮进程，系统将停止。

• --wait-dbg 阻止Monkey执行，直到调试器附加到它为止。

保存日志到文件

使用 > C:\xxx\xxx.txt 保存到指定文件如下：

$ adb shell monkey -p your.package.name -v 500 > C:\xxx\xxx.txt