MonkeyRunner

一个包含静态实用程序方法的 monkeyrunner 类。

摘要

方法
void	alert (string message, string title, string okTitle) 向运行当前程序的进程显示一个警报对话框。
integer	choice (string message, iterable choices, string title) 向运行当前程序的进程显示一个带有选项列表的对话框。
void	help (string format) 以类似于 Python 的 `pydoc` 工具的风格显示 monkeyrunner API 参考，使用指定的格式。
string	input (string message, string initialValue, string title, string okTitle, string cancelTitle) 显示一个接受输入的对话框。
void	sleep (float seconds) 将当前程序暂停指定的秒数。
`MonkeyDevice`	waitForConnection (float timeout, string deviceId) 尝试在 `monkeyrunner` 后端和指定的设备或模拟器之间建立连接。

公共方法

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

向运行当前程序的进程显示一个警报对话框。该对话框是模态的，因此程序将在用户点击对话框的按钮之前暂停。

参数

message	要在对话框中显示的消息。
title	对话框的标题。默认值为“警报”。
okTitle	对话框按钮中显示的文本。默认值为“确定”。

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

向运行当前程序的进程显示一个带有选项列表的对话框。该对话框是模态的，因此程序将在用户点击对话框的其中一个按钮之前暂停。

参数

message	在对话框中显示的提示消息。
choices	一个 Python 可迭代对象，包含一个或多个以字符串形式显示的对象。推荐的形式是字符串数组。
title	对话框的标题。默认值为“输入”。

返回值

如果用户选择了项目并点击了“确定”按钮，则该方法将返回所选项目在可迭代对象中的 0 索引位置。如果用户点击了“取消”按钮，则该方法将返回 -1。

void help (string format)

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

参数

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

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

显示一个接受输入并将输入返回给程序的对话框。该对话框是模态的，因此程序将在用户点击对话框的其中一个按钮之前暂停。

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

参数

message	在对话框中显示的提示消息。
initialValue	要在对话框中显示的初始值。默认值为一个空字符串。
title	对话框的标题。默认值为“输入”。
okTitle	在 okTitle 按钮中显示的文本。默认值为“确定”。
cancelTitle	在 cancelTitle 按钮中显示的文本。默认值为“取消”。

返回值

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

void sleep ( float seconds )

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

参数

seconds	要暂停的秒数。

`MonkeyDevice` waitForConnection (float timeout, string deviceId)

尝试在 monkeyrunner 后端和指定的设备或模拟器之间建立连接。

参数

timeout	等待连接的秒数。默认值为无限期等待。
deviceId	指定设备或模拟器序列号的正则表达式。有关设备和模拟器序列号的说明，请参见主题 Android Debug Bridge。

返回值

设备或模拟器的 MonkeyDevice 实例。使用此对象控制和与设备或模拟器进行通信。