Android开发者指南(5) —— monkeyrunner

正文

monkeyrunner工具提供了一个API，使用此API写出的程序可以在Android代码之外控制Android设备和模拟器。通过monkeyrunner，您可以写出一个Python程序去安装一个Android应用程序或测试包，运行它，向它发送模拟击键，截取它的用户界面图片，并将截图存储于工作站上。monkeyrunner工具的主要设计目的是用于测试功能/框架水平上的应用程序和设备，或用于运行单元测试套件，但您当然也可以将其用于其它目的。

monkeyrunner工具为Android测试提供了以下特性：

* 多设备控制：monkeyrunner    API可以跨多个设备或模拟器实施测试套件。您可以在同一时间接上所有的设备或一次启动全部模拟器（或统统一起），依据程序依次连接到每一个，然后运行一个或多个测试。您也可以用程序启动一个配置好的模拟器，运行一个或多个测试，然后关闭模拟器。

* 功能测试：    monkeyrunner可以为一个应用自动贯彻一次功能测试。您提供按键或触摸事件的输入数值，然后观察输出结果的截屏。

* 回归测试：monkeyrunner可以运行某个应用，并将其结果截屏与既定已知正确的结果截屏相比较，以此测试应用的稳定性。 

         monkeyrunner工具使用Jython（使用Java编程语言的一种Python实现）。Jython允许monkeyrunnerAPI与Android框架轻松的进行交互。使用Jython，您可以使用Python语法来获取API中的常量、类以及方法。

一个简单的monkeyrunner程序实例(A Simple monkeyrunner Program)

         以下为一个简单的monkeyrunner程序，它将会连接到一个设备，创建一个MonkeyDevice对象。使用MonkeyDevice对象，程序将安装一个Android应用包，运行其中一个活动，并向其发送按键事件。程序接下来会将结果截图，创建一个MonkeyImage对象，并使用这个对象截图将保存至.png文件。

　　　　 

The monkeyrunner API

monkeyrunnerAPI于com.android.monkeyrunner包中包含三个模块：

在python程序中，您将以Python模块的形式使用这些类。monkeyrunner工具不会自动导入这些模块。您必须使用类似如下的from语句：

　　

其中，为您想要导入的类名。您可以在一个from语句中导入超过一个模块，其间以逗号分隔。

Running monkeyrunner

您可以直接使用一个代码文件运行monkeyrunner，抑或在交互式对话中输入monkeyrunner语句。不论使用哪种方式，您都需要调用SDK目录的tools子目录下的monkeyrunner命令。如果您提供一个文件名作为运行参数，则monkeyrunner将视文件内容为Python程序，并加以运行；否则，它将提供一个交互对话环境。

monkeyrunner命令的语法为：

　　 

表 1阐释了命令的标志和参数。

参数

说明

<code>-plugin &lt;plugin_jar&gt;</code>

<code>&lt;program_filename&gt;</code>

如果您指定此参数，monkeyrunner将视文件内容为Python程序并予以执行。如果此参数未予指定，则开启一个交互式会话。

<code>&lt;program_options&gt;</code>

（可选）&lt;程序文件名&gt; 所指定的程序所需的参数

monkeyrunner内建帮助(monkeyrunner Built-in Help)

您可以用以下命令来生成monkeyrunner的API参考：

         参数说明：

* 可以为<code>text</code>或<code>html</code>，分别代表纯文本和HTML输出。

* 指定了输出文件的全路经名称。

使用插件扩展monkeyrunner(Extending monkeyrunner with Plugins)

您可以用Java语言创建新的类，并打包成一个或多个<code>.jar</code>文件，以此来扩展monkeyrunnerAPI。您可以使用您自己写的类或者继承现有的类来扩展monkeyrunnerAPI。您还可以使用此功能来初始化monkeyrunner环境。

         请注意，插件无法让你访问Android的SDK。您不能导入com.android.app等包。这是因为monkeyrunner是在框架API层次之下与设备或模拟器进行交互的。

插件启动类(The plugin startup class)

         用于插件的.jar文件可以指定一个类，使其在脚本执行之前就实例化。如欲指定这个类，您需要在.jar文件的manifest中添加键MonkeyRunnerStartupRunner。其值为启动时运行的类的名称。以下代码段显示了如何在一个ant构建脚本达到这样的目的：

如欲访问monkeyrunner的运行时环境，启动类可以实现com.google.common.base.Predicate&lt;PythonInterpreter&gt;。例如，用这个类在默认的命名空间中设置一些变量：

　　　

本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582283，如需转载请自行联系原作者