Android Monkey测试

Android中的monkey是对app做界面压力测试的一款工具，它可以向模拟器或者真机发送一系列随机的用户操作事件、或者系统事件。

概述

Monkey是android sdk自带的一款命令行工具，适用于任何android模拟器或者真机。它通过向手机发送一系列的随机事件，来测试手机app的稳定性。

Monkey命令包含一些参数，大体可以分为四类：

• 基本参数，如指定随机事件的个数
• 操作约束，如限制随机操作在指定的包内
• 事件类型和频率
• 调试选项

Monkey运行过程中，向android系统发送随机事件。并且，monkey会监视android系统的运行状态，保证下面的三点：

• 如果我们限制了monkey只在一个或几个包中运行。那么monkey在运行过程中会监视产生的随机事件，如果某一事件会跳到其他包中，monkey就会丢弃该事件，确保monkey只在指定的包中运行。
• 如果我们的程序出现crash或者有未被捕获的异常，monkey就会停止运行，并报错。
• 如果我们的程序出现未响应，monkey会停止运行，并报错。

Monkey的基本用法

我们可以在直接在命令行或者脚本中运行monkey，前提是android sdk环境已经ok。

基本语法如下：

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

如果没有其他参数限制，monkey默认以quiet模式运行，它会随机向手机中的包发送请求。一般请求，我们都需要指定包名，下面的命令限制了包名，且指定产生500个随机事件：

    $ adb shell monkey -p com.yeetrack.android.client -v 500

Monkey的参数

下面列出了Monkey可以使用的参数。

基本参数

• --help打印帮助文档
• -v命令行中的每一个-v将增加反馈信息的级别。Level 0（也是默认值）除启动提示、测试完成和最终结果之外，其他的信息很少。Level 1提供较为详细的测试信息，如逐个发送到Activity的事件。Level 2提供更加详细的设置信息，如测试中被选中的或未被选中的Activity，例子adb shell -v -v 500
• -s <seed>伪随机生成器的种子。如果seed值一样，那么产生的monkey事件，序列也是一样的
• --throttle <毫秒>在事件之间加入固定时间延迟，单位毫秒。如果不加，monkey会尽可能快地产生事件
• --pct-touch <percent>调整触摸事件的百分比（触摸就是一个点击事件）
• --pct-motion <percent>调整动作事件的百分比，（动作事件指一个down事件，一系列随机事件，然后一个up事件）
• --pct-trackball <percent>调整轨迹事件的百分比，（轨迹事件由一个或多个移动组成，有时伴随点击事件）
• --pct-nav <percent>调整基本导航事件的百分比，（导航事件就是方向键，上下左右）
• --pct-majornav <percent>调整主要导航事件的百分比（这些导航事件通常引发图形界面中的动作，如5-way键盘的中间按键，回退按键，菜单按键）
• --pct-syskeys <percent>调整系统按键事件的百分比（这些事件由系统保留，如Home、Back、Start、Call、End Call及音量控制键）
• --pct-appswitch <percent>调整启动activity的百分比。在随机间隔里，Monkey将执行一个startActivity()调用，作为最大程度覆盖保重全部Activity的一种方法。
• --pct-anyevent <percent>调整其他类型事件的百分比。包含了所有其他类型的事件，如按键、其他不常使用的设备按键、等。

操作约束

• -p <allowed-package-name>如果使用该参数指定了一个或几个包，monkey将只允许启动这些包中的activity。如果你的程序，需要访问别的activity（如联系人界面），那必须将联系人的包也指定一下，否则无法访问。如果没有指定包名，monkey将允许启动安装在手机上的所有包。如果要指定多个包，需要多个-p选项，每个-p指定一个包。
• -c <main-category>如果使用此参数指定了一个或多个类别，Monkey将只允许系统启动被这些类别中的某个类别列出的Activity，如果不指定任何类别，Monkey将选择下列类别中列出的Activity：

  Intent.CATEGORY_LAUNCHER或Intent.CATEGORY_MONKEY。要指定多个类别，需要多个-c选项。

调试选项

• --dbg-no-event设置此选项，Monkey将执行初始启动，进入到一个测试Activity，然后不再产生事件。为了得到最佳结果，把它与-v，一个或几个包约束，以及一个保持Monkey运行30秒或更长事件的非零值联合起来，从而提供一个环境，可以监视应用程序所调用的包之间的转换。
• --hprof设置此选项，将在Monkey事件序列之前和之后立即生成profiling报告。这将会在data/misc中生成大文件（5M），所以小心使用。
• --ignore-crashes通常，当被测app崩溃或者发生任何失控异常时，Monkey将停止运行。如果设置此选项，Monkey会继续向系统发送事件，直到计数完毕。
• --ignore-timeouts通常，当被测程序出现未响应时，Monkey会停止运行。如果设置此选项，Monkey会继续运行，直到结束。
• --ignore-security-excuptions通常，当被测程序发生可允许错误（如启动一个需要授权的Activity）时，Monkey将停止运行。如果设置此选项，Monkey将继续运行，直到结束。
• --kill-process-after-error通常，当Monkey由于一个错误而停止运行时，出错的应用程序将继续运行。如果设置此选项，将会通知系统停止发送错误的进程。注意：程序正常结束，该程序并没有被停止。设备只是在结束事件后，简单保持在最后的状态。
• --monitor-native-chrashes监视并报告Android系统中本地代码的崩溃事件。如果设置了–kill-process-after-error,系统将停止运行。
• --wait-dbg停止执行中的Monkey，直到有调试器和它相连。

最后一个简单的例子：

每0.5秒发送一个请求，包名com.yeetrack.android.app,总共发送请求2000个。

    adb shell monkey -v 2000 --throttle 500 -p com.yeetrack.android.app