サイトのトップへ戻る

Android Studio ドキュメント 日本語訳

サイト内検索



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バックエンドと指定した端末もしくはエミュレーターとの間で接続を試みます。


Public メソッド

string alert ( string message, string title, string okTitle)

現在のプログラムを実行しているプロセスのアラートダイアログを表示します。 このダイアログはモーダルウィンドウなので、ユーザーがダイアログのボタンをクリックするまでプログラムは一時停止します。

引数
message ダイアログに表示するメッセージ。
title ダイアログのタイトル。既定値は "Alert"です。
okTitle ダイアログボタンに表示されるテキスト。既定値は "OK"です。

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

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

引数
message ダイアログに表示されるプロンプトメッセージ。
choices 文字列として表示される複数のオブジェクトを含んだ、Python のインテラブル型データ。 string型の配列を指定することを推奨します。
title ダイアログのタイトル。既定値は "Input"です。

戻り値
  • ユーザーがどれかを選択して"OK"ボタンをクリックした場合、このメソッドは選択したインデックスの値を戻り値として返します(インデックスが0から始まります)。インデックスの値は、インテラブル型データの範囲内になります。 ユーザーが"Cancel"ボタンをクリックした場合、このメソッドは-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)

入力を受け取り、それをプログラムへ戻り値として返すダイアログ。 このダイアログはモーダルウィンドウなので、ユーザーがダイアログのボタンをクリックするまでプログラムは一時停止します。

ダイアログには二つのボタンがあります。そのうちの一つは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 インスタンス。このオブジェクトを使って、端末やエミュレータの制御と通信を行います。