MonkeyRunner API使用说明-------------附录

该文章的原创pdf文档下载地址为：链接: http://pan.baidu.com/s/1qYhC3ik 密码: 7buf

Monkey综述

简述

        monkey是一个命令行工具，可以在任何模拟器或设备上运行。它发送用户事件的伪随机流进入系统，用以充当正在开发的应用软件的压力测试。monkey包括许多选择，但它们分解为四个主要的类别：

• 基本配置选项，如设置事件尝试的数量

• 业务限制，如限制测试到单个封装中

• 事件的类型和频率

• 调试选项

当monkey运行时，它生成事件并将其发送到系统。它也监视被测系统，并查找三个条件，其中特别对待：

• 如果限制了monkey在一个或多个特定的软件包运行时，它监视那些尝试导航到其他包的软件包，并阻止他们。

• 如果应用程序崩溃或收到任何形式的未处理的异常，Monkey将停止运行并报告错误。

• 如果应用程序产生不响应错误的应用程序，Monkey将停止运行并报告错误。

根据所选择的详细程度，可以看到monkey的进度报告和正在生成的事件。

基本使用

        可以使用开发机或从脚本命令行启动monkey。因为monkey在模拟器/设备环境下运行，必须在shell环境中启动。也可以通过adb shell每一个命令去实现，或通过输入shell和直接输入monkey命令做到这一点。基本语法是：

  

 

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

 

        如果不指定任何选项，Monkey将在一个安静的（非冗余）模式下启动，并会发送事件的任何（所有）到设备上安装的包中。这里有一个更典型的命令行，这将启动应用程序，并送500的伪随机事件：

  

 

 

 

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

命令选项参考

        下表列出了所有选项，这些选项可以使用在monkey命令行中：

类别

选项

描述

General

--help

打印简单的使用指南

-v

在命令行上的每一个-v将增加详细级别。级别0（默认值）提供的信息有点出乎启动通知，测试完成和最终结果。 Level 1提供更多细节的测试，因为它运行时，如单个事件被发送到你的活动。 2级提供了诸如评选活动或未选中测试更详细的设置信息。

Events

-s <seed>

为伪随机数发生器的seed值。如果重新运行使用相同的seed值的monkey，它会产生相同的事件序列

--throttle <milliseconds>

插入事件之间的固定的延迟。可以使用此选项将monkey放缓。如果未指定，没有延迟和事件被尽可能快地产生。

--pct-touch <percent>

调整触摸事件的百分比。（触摸事件是在屏幕上的一个位置的down_up事件）。

--pct-motion <percent>

调整动作事件的百分比。（运动事件某处包括一个点击事件的屏幕，一系列伪随机运动的上，并且一个事件）。

--pct-trackball <percent>

调整轨迹球事件的百分比。（轨迹球事件由一个或多个随机的动作，有时后跟一个点击。）

--pct-nav <percent>

调整“基本”导航事件的百分比。（导航事件包括上/下/左/右，如从一个方向输入装置输入）。

--pct-majornav <percent>

调整“主要”导航事件的百分比。（这些导航事件通常引发图形界面中的动作，如在5个方向按键中间键，返回键，菜单按键）。

--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将选择类别Intent.CATEGORY_LAUNCHER或Intent.CATEGORY_MONKEY上市活动。要指定多个类别，使用-c选项多次 - 每个分类一-c选项。

Debugging

--dbg-no-events

当指定，Monkey将执行初始启动到测试活动，但不会产生任何进一步的事件。为获得最佳效果，结合-v，一个或多个包的限制，和非零油门保持monkey运行30秒以上。这就提供了可以监视应用程序所调用包过渡的环境。

--hprof

如果设置，此选项将产生紧接monkey事件序列后，分析报告。这将在数据/秒（〜5Mb的）文件，因此要谨慎使用。见Traceview关于跟踪文件的详细信息。

--ignore-crashes

通常情况下，当应用程序崩溃或发生任何未处理的异常的Monkey将停止运行。如果指定了此选项，Monkey将继续发送事件到系统中，直到计数完成。

--ignore-timeouts

通常情况下，当应用程序发生任何超时错误的Monkey将停止运行，如“应用程序没有响应”对话框。如果指定了此选项，Monkey将继续发送事件到系统中，直到计数完成

--ignore-security-exceptions

通常情况下，当应用程序发生任何权限错误，例如，如果尝试启动需要一定权限的活动Monkey将停止运行。如果指定了此选项，Monkey将继续发送事件到系统中，直到计数完成。

--kill-process-after-error

通常情况下，当Monkey停止由于错误，失败的应用程序将保持运行。当这个选项被设置时，它会发出信号系统停止在错误发生的过程。注意，一个普通（成功）完成下，所述启动的过程（一个或多个）不停止，该装置简单地留在最后的状态的最后的事件之后。

--monitor-native-crashes

在Android系统原生代码为发生监视和报告崩溃。如果--kill-过程后，错误设置时，系统将停止运行。

--wait-dbg

从执行，直到调试器附加到它停止monkey