說(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è)備或模擬器韵洋,或與之通信竿刁。