内容发布更新时间 : 2024/6/26 20:20:18星期一 下面是文章的全部内容请认真阅读。

MonkeyRunner

string alert ( string message, string title, string okTitle)

当前程序运行过程中显示一个警告对话框。对话框是模态，因此该计划将暂停，直到用户点击对话框的按钮。 参数

message 在对话框中显示的消息。

title 对话框的标题。默认值是“Alert(警报)”。

okTitle 在对话框中的按钮显示的文本。默认值是“OK”。

integer choice (string message, iterable choices, string title)

显示当前程序运行过程的选项列表“对话框 对话框是模态，使程序暂停，直到用户点击对话框的按钮之一。 参数

message 显示在对话框的提示消息。

choices 一个Python迭代包含一个或多个显示为字符串的对象。建议的形式是一个字符串数组。

title 对话框的标题。默认的是“输入”。 返回

如果用户选择，并单击“确定”按钮，该方法返回的迭代器内的选择基于0的索引。如果用户点击“取消”按钮，该方法返回-1。

void help (string format)

显示在Python的风格类似的monkeyrunner API参考 pydoc工具，使用指定的格式。 参数

format 在输出中使用标记格式。可能的值是“txt”为纯文本或“html”为HTML。

string input (string message string initialValue, string title, string okTitle, string cancelTitle)

显示一个对话框，接受输入并返回到程序。对话框是模态，使程序暂停，直到用户点击对话框的按钮之一。

该对话框包含两个按钮，其中一个显示的okTitle的价值和其他cancelTitle价值。如果的用户点击okTitle的按钮，输入框的当前值返回。如果的用户点击cancelTitle的按钮，则返回一个空字符串。

参数

message 显示在对话框的提示消息。

initialValue 初始值显示在对话框中。默认是一个空字符串。 title 对话框的标题。默认的是“输入”。

okTitle 在okTitle按钮显示的文本。默认的是“OK”。

cancelTitle 在cancelTitle按钮显示的文本。默认是“cancel”。 返回

如果用户点击okTitle按钮，则该方法返回当前值对话框的输入框中。如果的用户点击cancelTitle的按钮，该方法返回一个空字符串。

void sleep ( float seconds )

暂停当前程序中指定的秒数。 参数

seconds 暂停的秒数。

MonkeyDevice waitForConnection (float timeout, string deviceId) 试图使之间的连接monkeyrunner后端和指定的设备或模拟器。 参数

timeout 等待连接的秒数。默认情况下是永远等待。

deviceId 一个正则表达式指定的设备或仿真器的序列号。请参阅主题 Android调试桥 的设备描述和仿真器的序列号。 返回

一个MonkeyDevice 设备或模拟器的实例。使用这个对象来控制和通信设备或模拟器。

MonkeyImage

使用 MonkeyDevice.takeSnapshot（）创建一个新实例

string convertToBytes ( string format)

当前图像转换成特定的格式，并返回一个字符串 ，然后可以访问作为一个迭代的二进制字节。 参数

format 所需的输出格式。支持所有常见的栅格输出格式。默认值是“PNG（便携式网络图形）。

tuple getRawPixel (integer x, integer y)

返回单个像素在图像的位置（X，Y），作为一个元组整数的形式，（A，R，G，B）。 参数

x 像素的水平位置，在左边方向的屏幕截图时0开始。 y 像素的垂直位置，方向的屏幕截图时顶部0开始。 返回

一个元组代表像素的整数形式（A，R，G，B），其中a是alpha通道值，R，G和B是红色，绿色和蓝色值，分别为。

tuple getRawPixelInt (integer x, integer y)

单个像素，在图像的位置（X，Y）返回一个整数。使用这种方法，以节约内存。 参数

x 像素的水平位置，在左边方向的屏幕截图时0开始。 y 像素的垂直位置，方向的屏幕截图时顶部0开始。 返回

A，R，g和b值的像素为8位值组合成一个32位的整数，最左边的8位，R的最右边，等等。

MonkeyImage getSubImage (tuple rect) 创建一个新的MonkeyImage从当前图像的矩形选择的对象。 参数

RECT 一个元组（X，Y，W，H）指定选择。x和y指定0的像素位置，选择左上角的角落。w指定区域的宽度，h指定的高度，像素为单位。 图像的方向是在截图时屏幕方向相同。 返回

一个新MonkeyImage的对象，包含选择。

boolean sameAs ( MonkeyImage otherImage, float percent ) 比较这MonkeyImage对象到另一个对象，并返回比较的结果。％的参数指定两个图像是“平等”的百分比差异。 参数 other 另一个MonkeyImage对象这一个比较。

percent 在范围内的浮动0.0到1.0，包容，表示真正的需要，是该方法返回相同的像素的百分比 。默认为1.0，表明所有的像素必须匹配。 返回

布尔如果图像匹配，或者布尔值，否则返回false。

void writeToFile (string filename, string format)

当前图像写入指定的文件名 ，在指定的格式格式。 参数

path 完全合格的文件名和输出文件的扩展。

format 使用的文件输出格式。如果没有提供的格式，则该方法试图猜测文件名的扩展名的格式。如果没有扩展，并没有指定格式，然后使用“PNG（便携式网络图形）的默认格式。

MonkeyDevice

使用newdevice = MonkeyRunner .waitForConnection()来创建一个对象

void broadcastIntent ( string uri, string action, string data, string mimetype, iterable categories dictionary extras, component component, iterable flags)

广播这个装置的目的，如果意图从应用程序。有关参数的更多信息见意向书。 参数

uri 为意向的URI。（见Intent.setData（ ） ） 。 action 这一意图的行动（见Intent.setAction（） ）。 data 这种意图的数据URI（见Intent.setData（） ）。 mimetype 意图的MIME类型（见Intent.setType（） ）。 categories 一个可迭代的数据结构，包含字符串定义为这一意图的类别（见 Intent.addCategory（） ）。

extras 一个额外的数据字典的这种意图（见Intent.putExtra（） 的一个例子）。

每个字典项目的关键应该是一个字符串。该项目的值可以是任何简单或结构化数据类型。 component 用于此目的的的组件（见ComponentName）。使用此参数将直接意图在一个特定的Android包到一个特定的类。

flags 一个可迭代的数据结构，包含标志，控制的意图是如何处理（见Intent.setFlags（） ）。

void drag ( tuple start, tuple end, float duration, integer steps)

模拟设备的屏幕上拖动动作（触摸，持有和移动）。 参数

start 拖动动作的起点，在一个形式的元组 （X，Y），其中x和y都是整数。 end 拖动动作的终点，在一个形式的元组（X，Y），其中x和y都是整数。 duration 拖动动作在几秒钟的时间。默认为1.0秒。 steps 插值点时要采取的步骤。默认为10。

object getProperty (string key)

鉴于系统环境变量的名称，返回此设备的价值。 参数

key 系统环境变量的名称。表1中列出了可用的变量名称 。属性变量的名称在本主题的结尾。 返回

变量的值。根据请求的变量的数据格式。

object getSystemProperty (string key)

同义词getProperty（）方法。 参数

key 系统环境变量的名称。表1中列出了可用的变量名 物业变量名。 返回

变量的值。根据请求的变量的数据格式。

void installPackage (string path)

安装到这个设备packageFile中的Android应用程序或测试包。如果已安装的应用程序或测试包，它会被替换。 参数

path 完全合格的路径和文件名 的。apk文件安装。

dictionary instrument ( string className, dictionary args)

运行指定的组件与Android仪器，在字典中的确切格式取决于正在运行的组件，并返回结果。组件必须已经是目前此设备上。

使用此方法来启动一个测试案例，使用Android的测试用例类之一。查看学习与Android的测试框架进行单元测试的测试基础。 参数

className 一个Android组件已安装此设备上的标准格式软件包名/类名，其中packageName是一个Android包名称，名称。APK在此设备上的文件，classname是一个Android组件的类名（活动ContentProvider的服务，或BroadcastReceiver）在该文件中。软件包名和类名都必须完全符合。ComponentName看到 更多细节。

args 字典包含国旗和他们的价值观。这些都传递给组件，因为它是开始。如果标志不采取一个值，设置它的字典值一个空字符串。 返回