MonkeyRunner

monkeyrunner クラスには static ユーティリティメソッドが含まれています。

概要

メソッド
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）

現在のプログラムを実行しているプロセスの選択肢一覧を含むダイアログを表示します。このダイアログはモーダルであるため、ユーザーがダイアログのボタンの 1 つをクリックするまでプログラムは一時停止します。

引数

message	ダイアログに表示されるプロンプトメッセージ。
choices	文字列として表示される複数のオブジェクトを含む、イテラブル型の Python データ。string 型の配列が推奨されています。
title	ダイアログのタイトル。デフォルトは「Input」です。

戻り値

ユーザーが選択を行って「OK」ボタンをクリックした場合、このメソッドは選択肢のインデックス値を返します。インデックス値は、イテラブル型データの範囲内になります。ユーザーが「キャンセル」ボタンをクリックすると、メソッドは -1 を返します。

void help （string format）

指定された形式を使用して、Python の pydoc ツールと同じスタイルの monkeyrunner API リファレンスを表示します。

引数

format	出力で使用するマークアップ形式。書式なしテキストの場合は「text」、HTML の場合は「html」を値として設定できます。

string input （string message string initialValue、 string title、 string okTitle、 string cancelTitle）

入力を受け取り、それをプログラムに返すダイアログ。このダイアログはモーダルであるため、ユーザーがダイアログのボタンの 1 つをクリックするまでプログラムは一時停止します。

このダイアログには、okTitle の値を表示するボタンと cancelTitle の値を表示するボタンの 2 つのボタンがあります。ユーザーが 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 インスタンス。このオブジェクトを使用して、デバイスやエミュレータを制御し、通信します。