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 调试桥。

返回值

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