[译]Android MonkeyRunner 类接口文档

说明：本系列文章翻译自Android官方文档。
分为四篇：
android monkeyrunner 官方文档
android MonkeyRunner 类接口文档
android MonkeyDevice 类接口文档（待翻译）
android MonkeyImage 类接口文档（待翻译）

MonkeyRunner 类包含以下静态工具方法：

摘要

返回值类型	方法定义
void	alert(string message, string title, string okTitle) 基于当前程序运行的进程显示一个警告对话框。
integer	choice(string message, iterable choices, string title) 基于当前程序运行的进程显示一个带可选项列表的对话框。
void	help(string format) 使用指定的格式显示 monkeyrunner API 参考，风格类似与 Python 的pydoc工具。
string	input(string message, string initialValue, string title, string okTitle, string cancleTitle) 显示一个可以接收输入的对话框。
void	sleep(float seconds) 使当前程序暂停指定秒。
MonkeyDevice	waitForConnection(float timeout, string deviceld) 尝试使monkeyrunner后台与指定设备或模拟器建立连接。

公有方法

void alert(string meaage, string title string okTitle)

基于当前程序运行的进程显示一个警告对话框。对话框是模态化的，程序直到用户点击对话框按钮后才会继续执行。

参数

message 在对话框上展示的信息

title 对话框标题。默认值是“Alert”

okTitle 对话框按钮的问题。默认值是“OK”

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

基于当前程序运行的进程显示一个带可选项列表的对话框。对话框是模态化的，程序直到用户点击对话框按钮后才会继续执行。

参数

message 对话框的提示信息。

choices 包含一到多个元素的 Python 可迭代对象，以字符串形式标识。推荐使用字符串类型的数组。

title 对话框标题，默认的是“input”。

返回值

如果用户做了选择并点击了“确认”按钮，该方法会返回已选元素的索引。如果用户点击了“取消”按钮，则返回-1.

void help(string format)

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

参数

format 用于输出文件的标记格式。可选取值是“text”输出纯文本文件或“html”输出HTML文件。

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

显示一个可以接收输入的对话框。对话框是模态化的，程序直到用户点击对话框按钮后才会继续执行。

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

参数

message 在对话框里显示的提示信息。

initialValue 输入框中的初始值。默认值是空字符串。

title 对话框标题。默认值是“Input”。

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

cancelTitle cancelTitle按钮显示的文本。默认值是“Cancel”。

返回值

如果用户点击okTitle按钮，则返回输入框中的值，否则返回空字符串。

void sleep(float seconds)

使当前程序暂停指定秒数。

参数

seconds 暂停的秒数

MonkeyDevice waitForConnection(float timeout, string deviceId)

尝试使monkeyrunner后台与指定设备或模拟器建立连接。

参数

timeout 等待连接的秒数。默认会永远等待。

deviceId 指定设备或模拟器串号的常规表达式。设备和模拟器串号的描述请参考Android Debug Bridge。

返回值

返回设备或模拟器的MonkeyDevice对象。使用该对象控制设备或模拟器，或与之通信。