說明：本系列文章翻譯自Android官方文檔。
分為四篇：
android monkeyrunner 官方文檔
android MonkeyRunner 類接口文檔
android MonkeyDevice 類接口文檔（待翻譯）
android MonkeyImage 類接口文檔（待翻譯）

MonkeyRunner 類包含以下靜態(tài)工具方法：

摘要

公有方法

void alert(string meaage, string title string okTitle)

基于當(dāng)前程序運(yùn)行的進(jìn)程顯示一個(gè)警告對(duì)話框。對(duì)話框是模態(tài)化的，程序直到用戶點(diǎn)擊對(duì)話框按鈕后才會(huì)繼續(xù)執(zhí)行。

參數(shù)

message 在對(duì)話框上展示的信息

title 對(duì)話框標(biāo)題。默認(rèn)值是“Alert”

okTitle 對(duì)話框按鈕的問題。默認(rèn)值是“OK”

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

基于當(dāng)前程序運(yùn)行的進(jìn)程顯示一個(gè)帶可選項(xiàng)列表的對(duì)話框。對(duì)話框是模態(tài)化的，程序直到用戶點(diǎn)擊對(duì)話框按鈕后才會(huì)繼續(xù)執(zhí)行。

參數(shù)

message 對(duì)話框的提示信息。

choices 包含一到多個(gè)元素的 Python 可迭代對(duì)象，以字符串形式標(biāo)識(shí)。推薦使用字符串類型的數(shù)組。

title 對(duì)話框標(biāo)題，默認(rèn)的是“input”。

返回值

如果用戶做了選擇并點(diǎn)擊了“確認(rèn)”按鈕，該方法會(huì)返回已選元素的索引。如果用戶點(diǎn)擊了“取消”按鈕，則返回-1.

void help(string format)

使用指定的格式顯示 monkeyrunner API 參考，風(fēng)格類似與 Python 的pydoc工具。

參數(shù)

format 用于輸出文件的標(biāo)記格式。可選取值是“text”輸出純文本文件或“html”輸出HTML文件。

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

顯示一個(gè)可以接收輸入的對(duì)話框。對(duì)話框是模態(tài)化的，程序直到用戶點(diǎn)擊對(duì)話框按鈕后才會(huì)繼續(xù)執(zhí)行。

對(duì)話框包含兩個(gè)按鈕，一個(gè)顯示okTitle的值，另一個(gè)顯示cancelTitle的值。如果用戶點(diǎn)擊了okTitle按鈕，則返回當(dāng)前輸入框中的值。如果用戶點(diǎn)擊了cancelTitle按鈕，則返回一個(gè)空字符串。

參數(shù)

message 在對(duì)話框里顯示的提示信息。

initialValue 輸入框中的初始值。默認(rèn)值是空字符串。

title 對(duì)話框標(biāo)題。默認(rèn)值是“Input”。

okTitle okTitle按鈕顯示的文本。默認(rèn)值是“OK”。

cancelTitle cancelTitle按鈕顯示的文本。默認(rèn)值是“Cancel”。

返回值

如果用戶點(diǎn)擊okTitle按鈕，則返回輸入框中的值，否則返回空字符串。

void sleep(float seconds)

使當(dāng)前程序暫停指定秒數(shù)。

參數(shù)

seconds 暫停的秒數(shù)

MonkeyDevice waitForConnection(float timeout, string deviceId)

嘗試使monkeyrunner后臺(tái)與指定設(shè)備或模擬器建立連接。

參數(shù)

timeout 等待連接的秒數(shù)。默認(rèn)會(huì)永遠(yuǎn)等待。

deviceId 指定設(shè)備或模擬器串號(hào)的常規(guī)表達(dá)式。設(shè)備和模擬器串號(hào)的描述請(qǐng)參考Android Debug Bridge。

返回值

返回設(shè)備或模擬器的MonkeyDevice對(duì)象。使用該對(duì)象控制設(shè)備或模擬器，或與之通信。