MonkeyRunner

Eine monkeyrunner-Klasse, die statische Dienstprogrammmethoden enthält.

Zusammenfassung

Methoden
void	alert (string message, string title, string okTitle) Zeigt einen Benachrichtigungsdialog für den Prozess an, der das aktuelle Programm ausführt.
Ganzzahl	choice (String-Nachricht, iterable-Optionen, String-Titel) Zeigt ein Dialogfeld mit einer Liste von Auswahlmöglichkeiten für den Prozess an, der das aktuelle Programm ausführt.
void	help (string-Format) Zeigt die monkeyrunner API-Referenz in einem ähnlichen Stil wie das pydoc-Tool von Python unter Verwendung des angegebenen Formats an.
String	input (string-Nachricht, string initialValue, string title, string okTitle, string cancelTitle) Zeigt ein Dialogfeld an, das Eingabe akzeptiert.
void	sleep (Gleitkommazahl Sekunden) Hält das aktuelle Programm für die angegebene Anzahl von Sekunden an.
MonkeyDevice	waitForConnection (Float-Zeitlimit, String-Geräte-ID) Versucht, eine Verbindung zwischen dem monkeyrunner-Back-End und dem angegebenen Gerät oder Emulator herzustellen.

Öffentliche Methoden

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

Zeigt einen Benachrichtigungsdialog für den Prozess an, der das aktuelle Programm ausführt. Das Dialogfeld ist modales Dialogfeld, sodass das Programm pausiert wird, bis der Nutzer auf die Schaltfläche des Dialogfelds klickt.

Argumente

Nachricht	Die Meldung, die im Dialogfeld angezeigt werden soll.
title	Der Titel des Dialogfelds. Der Standardwert ist „Alert“.
Titel	Der Text, der auf der Dialogfeldschaltfläche angezeigt wird. Der Standardwert ist „OK“.

integer choice (string-Meldung, iterable-Optionen, string-Titel)

Zeigt ein Dialogfeld mit einer Liste von Auswahlmöglichkeiten für den Prozess an, der das aktuelle Programm ausführt. Das Dialogfeld ist modales Dialogfeld, das heißt, das Programm wird angehalten, bis der Nutzer auf eine der Schaltflächen des Dialogfelds klickt.

Argumente

Nachricht	Die im Dialogfeld angezeigte Meldung.
Auswahlmöglichkeiten	Eine Python-Iteration, die ein oder mehrere Objekte enthält, die als Strings angezeigt werden. Die empfohlene Form ist ein Array von Strings.
title	Der Titel des Dialogfelds. Die Standardeinstellung ist „Eingabe“.

Returns

• Wenn der Nutzer eine Auswahl trifft und auf die Schaltfläche "OK" klickt, gibt die Methode den 0-basierten Index der Auswahl innerhalb des iterierbaren Elements zurück. Wenn der Nutzer auf die Schaltfläche „Abbrechen“ klickt, gibt die Methode „-1“ zurück.

void help (string-Format)

Zeigt die monkeyrunner API-Referenz in einem ähnlichen Stil wie das pydoc-Tool von Python unter Verwendung des angegebenen Formats an.

Argumente

Format	Das in der Ausgabe zu verwendende Markup-Format. Mögliche Werte sind „text“ für Nur-Text und „html“ für HTML.

string input (string-Nachricht string initialValue, string title, string okTitle, string cancelTitle)

Zeigt ein Dialogfeld an, das Eingaben annimmt und an das Programm zurückgibt. Das Dialogfeld ist modales Dialogfeld, d. h. das Programm wird angehalten, bis der Nutzer auf eine der Schaltflächen des Dialogfelds klickt.

Das Dialogfeld enthält zwei Schaltflächen, von denen eine den Wert "okTitle" und die andere den Wert "cancelTitle" anzeigt. Wenn der Nutzer auf die Schaltfläche „okTitle“ klickt, wird der aktuelle Wert des Eingabefelds zurückgegeben. Wenn der Nutzer auf die Schaltfläche „cancelTitle“ klickt, wird ein leerer String zurückgegeben.

Argumente

Nachricht	Die im Dialogfeld angezeigte Meldung.
InitialValue	Anfangswert, der im Dialogfeld angezeigt wird. Der Standardwert ist ein leerer String.
title	Der Titel des Dialogfelds. Die Standardeinstellung ist „Eingabe“.
Titel	Der in der Schaltfläche okTitle angezeigte Text. Der Standardwert ist „OK“.
Titel abbrechen	Der auf der Schaltfläche „cancelTitle“ angezeigte Text. Die Standardeinstellung ist „Abbrechen“.

Returns

• Wenn der Nutzer auf die Schaltfläche „okTitle“ klickt, gibt die Methode den aktuellen Wert des Eingabefelds im Dialogfeld zurück. Wenn der Nutzer auf die Schaltfläche "cancelTitle" klickt, gibt die Methode einen leeren String zurück.

void sleep ( float Sekunden )

Hält das aktuelle Programm für die angegebene Anzahl von Sekunden an.

Argumente

Sekunden	Die Anzahl der Sekunden, die pausiert werden soll.

MonkeyDevice waitForConnection (Float-Zeitlimit, String-Geräte-ID)

Versucht, eine Verbindung zwischen dem monkeyrunner-Back-End und dem angegebenen Gerät oder Emulator herzustellen.

Argumente

Time-out	Die Anzahl der Sekunden, die auf eine Verbindung gewartet werden soll. Standardmäßig wird unbegrenzt gewartet.
Geräte-ID	Ein regulärer Ausdruck, der die Seriennummer des Geräts oder Emulators angibt. Eine Beschreibung der Seriennummern von Geräten und Emulatoren finden Sie im Thema Android Debug Bridge.

Returns

• Eine MonkeyDevice-Instanz für das Gerät oder den Emulator. Verwenden Sie dieses Objekt, um das Gerät oder den Emulator zu steuern und mit ihm zu kommunizieren.