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 對話方塊的標題,預設值是「Alert」。
okTitle 對話方塊按鈕中顯示的文字,預設值是「OK」。

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

針對執行目前程式的處理程序顯示包含選項清單的對話方塊。這是強制回應對話方塊,因此程式會暫停,直到使用者點選對話方塊按鈕為止。

引數
message 對話方塊中顯示的提示訊息。
choices 含有一或多個物件 (以字串顯示) 的 Python 疊代器。建議格式為字串陣列。
title 對話方塊的標題,預設值為「Input」。
傳回
  • 如果使用者選擇某個選項並按下「OK」按鈕,這個方法會傳回可疊代項目中選項的索引 (從 0 開始)。 如果使用者按一下「Cancel」按鈕,這個方法會傳回 -1。

void help (string format)

使用指定格式,以類似 Python pydoc 工具的樣式顯示 monkeyrunner API 參考資料。

引數
格式 輸出內容使用的標記格式。可能的值包括純文字的「text」或 HTML 的「html」。

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

顯示接受輸入內容並傳回程式的對話方塊。這是強制回應對話方塊,因此程式會暫停,直到使用者點選對話方塊按鈕為止。

對話方塊包含兩個按鈕,其中一個顯示 okTitle 值,另一個顯示 cancelTitle 值。如果使用者按一下 okTitle 按鈕,系統就會傳回目前輸入框中的值。如果使用者點選 cancelTitle 按鈕,則會傳回空字串。

引數
message 對話方塊中顯示的提示訊息。
initialValue 對話方塊中顯示的初始值,預設值為空字串。
title 對話方塊的標題,預設值為「Input」。
okTitle okTitle 按鈕中顯示的文字,預設值為「OK」。
cancelTitle cancelTitle 按鈕中顯示的文字,預設值為「Cancel」。
傳回
  • 如果使用者按一下 okTitle 按鈕,這個方法會傳回目前對話方塊輸入框中的值。如果使用者點選 cancelTitle 按鈕,則會傳回空字串。

void sleep (float seconds)

讓目前程式暫停指定的秒數。

引數
seconds 暫停的秒數。

MonkeyDevice waitForConnection (float timeout, string deviceId)

嘗試在 monkeyrunner 後端與指定裝置或模擬器之間建立連線。

引數
timeout 等待連線的秒數,預設為永久等候。
deviceId 指定裝置或模擬器序號的規則運算式。如需裝置和模擬器序號的說明,請參閱 Android Debug Bridge 主題。
傳回
  • 裝置或模擬器的 MonkeyDevice 例項。請使用這個物件來控管裝置/模擬器,或與裝置/模擬器通訊。