說(shuō)明：本系列文章翻譯自Android官方文檔。
分為四篇：
android monkeyrunner 官方文檔
android MonkeyRunner 類接口文檔
android MonkeyDevice 類接口文檔（待翻譯）
android MonkeyImage 類接口文檔（待翻譯）
MonkeyRunner 類包含以下靜態(tài)工具方法：
摘要
| 返回值類型 | 方法定義 |
|---|---|
void |
alert(string message, string title, string okTitle)基于當(dāng)前程序運(yùn)行的進(jìn)程顯示一個(gè)警告對(duì)話框。 |
integer |
choice(string message, iterable choices, string title)基于當(dāng)前程序運(yùn)行的進(jìn)程顯示一個(gè)帶可選項(xiàng)列表的對(duì)話框。 |
void |
help(string format)使用指定的格式顯示 monkeyrunner API 參考，風(fēng)格類似與 Python 的 pydoc工具。 |
string |
input(string message, string initialValue, string title, string okTitle, string cancleTitle)顯示一個(gè)可以接收輸入的對(duì)話框。 |
void |
sleep(float seconds)使當(dāng)前程序暫停指定秒。 |
MonkeyDevice |
waitForConnection(float timeout, string deviceld)嘗試使 monkeyrunner后臺(tái)與指定設(shè)備或模擬器建立連接。 |
公有方法
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ì)話框按鈕的問(wèn)題。默認(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è)備或模擬器，或與之通信。
