MonkeyDevice

Eine Monkeyrunner-Klasse, die ein Gerät oder einen Emulator darstellt, auf den die ausgeführte Workstation zugreifen kann monkeyrunner

Mit dieser Klasse wird ein Android-Gerät oder Emulator gesteuert. Die Methoden senden UI-Ereignisse, Informationen abzurufen, Anwendungen zu installieren und zu entfernen und Anwendungen auszuführen.

Normalerweise müssen Sie keine Instanz von MonkeyDevice erstellen. Stattdessen müssen Sie nutzen MonkeyRunner.waitForConnection(), um ein neues Objekt aus einer Verbindung zu einem Gerät zu erstellen, oder Emulator. Anstatt beispielsweise mit:

newdevice = MonkeyDevice()

würden Sie Folgendes verwenden: 

newdevice = MonkeyRunner.waitForConnection()

Zusammenfassung

Konstanten
String UNTEN Verwenden Sie dieses Argument mit dem Argument type von press() oder touch() um ein DOWN-Ereignis zu senden.
String NACH OBEN Verwenden Sie dieses Argument mit dem Argument type von press() oder touch() um ein UP-Ereignis zu senden.
String UNTEN_UND_OBEN Verwenden Sie dieses Argument mit dem Argument type von press() oder touch() um ein DOWN-Ereignis unmittelbar gefolgt von einem UP-Ereignis zu senden.
Methoden
<ph type="x-smartling-placeholder"></ph> voidm <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> broadcastIntent (string uri, Aktion string string-Daten MIME-Typ string iterable Kategorien Wörterbücher-Extras Komponente iterable-Flags)
Sendet einen Intent an dieses Gerät, als käme er von einem .
<ph type="x-smartling-placeholder"></ph> voidm <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ziehen (Tupel-Start, Tupel-Ende, die Dauer der Gleitkommazahl, Ganzzahl-Schritte)
Simuliert eine Ziehbewegung (Berühren, halten und verschieben) auf dem Bildschirm dieses Geräts.
<ph type="x-smartling-placeholder"></ph> Objekt <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> getProperty (String-Schlüssel)
Gibt den Namen einer Systemumgebungsvariable zurück und gibt den Wert für dieses Gerät zurück. Die verfügbaren Variablennamen sind im Bereich ausführliche Beschreibung dieser Methode.
<ph type="x-smartling-placeholder"></ph> Objekt <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> getSystemProperty (String-Schlüssel)
. Die API-Entsprechung von adb shell getprop <key>. This is provided for use by platform developers.
<ph type="x-smartling-placeholder"></ph> voidm <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> installPackage (String-Pfad)
Installiert die in der Paketdatei enthaltene Android-Anwendung oder das Testpaket auf dieser . Wenn die Anwendung oder das Testpaket bereits installiert ist, wird es ersetzt.
<ph type="x-smartling-placeholder"></ph> Wörterbuch <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> Instrument (string className, Wörterbuch-Argumente)
Führt die angegebene Komponente unter Android-Instrumentierung aus und gibt die Ergebnisse zurück in einem Wörterbuch, dessen genaues Format durch die auszuführende Komponente vorgegeben wird. Die Komponente muss auf diesem Gerät bereits vorhanden sein.
<ph type="x-smartling-placeholder"></ph> voidm <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> drück (String-Name, Wörterbuch)
Sendet das vom Typ angegebene Schlüsselereignis an den Schlüssel, der durch Keycode ein.
<ph type="x-smartling-placeholder"></ph> voidm <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> Neustart (String in)
Startet dieses Gerät in dem durch "bootloadType" angegebenen Bootloader neu.
<ph type="x-smartling-placeholder"></ph> voidm <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> removePackage (string-Paket)
Löscht das angegebene Paket von diesem Gerät, einschließlich der Daten und des Cache.
<ph type="x-smartling-placeholder"></ph> Objekt <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> Shell (String cmd)
Führt einen adb-Shell-Befehl aus und gibt das Ergebnis zurück, falls vorhanden.
<ph type="x-smartling-placeholder"></ph> voidm <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> startActivity (string uri, Aktion string string-Daten MIME-Typ string iterable Kategorien Wörterbücher-Extras Komponente Flags)
Startet eine Aktivität auf diesem Gerät durch Senden eines aus dem bereitgestellten Argumenten.
MonkeyImage <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> takeSnapshot()
Zeichnet den gesamten Bildschirmpuffer des Geräts auf, was einen MonkeyImage -Objekt, das einen Screenshot des aktuellen Bildschirms enthält.
<ph type="x-smartling-placeholder"></ph> voidm <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> Touchscreen (Ganzzahl x, Ganzzahl y, Ganzzahl)
Sendet ein vom Typ angegebenes Touch-Ereignis an die angegebene Bildschirmposition durch x und y.
<ph type="x-smartling-placeholder"></ph> voidm <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> Typ (String-Nachricht)
Sendet die in der Nachricht enthaltenen Zeichen an dieses Gerät, als über die Gerätetastatur eingegeben wurde. Dies entspricht dem Aufruf press() für jeden Schlüsselcode in message mit dem Schlüsselereignistyp DOWN_AND_UP.
<ph type="x-smartling-placeholder"></ph> voidm <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> aufwachen ()
Aktiviert den Bildschirm dieses Geräts.

Konstanten

<ph type="x-smartling-placeholder"></ph> String NACH UNTEN

press() oder touch()-Wert. Gibt an, dass ein DOWN-Ereignistyp an das Gerät gesendet werden soll, das dem Ereignistyp auf eine Taste drücken oder den Bildschirm berühren.

<ph type="x-smartling-placeholder"></ph> String NACH OBEN

press() oder touch()-Wert. Gibt an, dass ein UP-Ereignistyp an das Gerät gesendet werden soll, das dem Ereignistyp eine Taste loslassen oder vom Bildschirm anheben.

<ph type="x-smartling-placeholder"></ph> String NACH_UNTEN_UND_UP

press(), touch() oder type()-Wert. Gibt an, dass ein DOWN-Ereignistyp gefolgt von einem UP-Ereignistyp an den für die Eingabe einer Taste oder das Klicken auf den Bildschirm.

Öffentliche Methoden

<ph type="x-smartling-placeholder"></ph> voidm broadcastIntent <ph type="x-smartling-placeholder"></ph> ( string-URI, string-Aktion string-Daten MIME-Typ string iterable Kategorien Wörterbuch-Extras, component-Komponente iterable Flags)

Sendet einen Intent an dieses Gerät, als käme er von einem . Unter Intent finden Sie weitere Informationen zu den Argumente.

Argumente
uri Der URI für den Intent. (siehe Intent.setData()).
Aktion Die Aktion für diesen Intent (siehe Intent.setAction()).
Daten Der Daten-URI für diesen Intent (siehe Intent.setData()).
MIME-Typ Der MIME-Typ für den Intent (siehe Intent.setType()).
Kategorien Eine iterierbare Datenstruktur mit Zeichenfolgen, die Kategorien für dieses Absicht (siehe Intent.addCategory().
Extras Ein Wörterbuch mit zusätzlichen Daten für diesen Intent (siehe Intent.putExtra()) .

Der Schlüssel für jedes Wörterbuchelement sollte ein String sein. Der Wert des Elements kann ein beliebiger einfacher oder strukturierter Datentyp sein.

Komponente Die Komponente für diesen Intent (siehe ComponentName). Mit diesem Argument wird der Intent zu einer bestimmten Klasse innerhalb eines bestimmten Android-Paket
Flags Eine iterierbare Datenstruktur mit Flags, die steuern, wie der Intent verarbeitet wird (siehe Intent.setFlags()).

<ph type="x-smartling-placeholder"></ph> voidm ziehen <ph type="x-smartling-placeholder"></ph> ( Tupel-Start, Tupel-Ende Gleitkommadauer, Ganzzahl Schritte)

Simuliert eine Ziehbewegung (Berühren, halten und bewegen) auf dem Bildschirm dieses Geräts.

Argumente
start Der Startpunkt der Ziehbewegung in Form eines Tupels (x,y), wobei x und y Ganzzahlen sind.
Ende Der Endpunkt der Ziehbewegung in Form eines Tupels (x, y) wobei x und y Ganzzahlen sind.
dauer Die Dauer der Ziehbewegung in Sekunden. Der Standardwert ist 1,0 Sekunden.
Schritte Die Anzahl der Schritte, die beim Interpolieren von Punkten ausgeführt werden sollen. Der Standardwert ist 10.

<ph type="x-smartling-placeholder"></ph> Objekt getProperty <ph type="x-smartling-placeholder"></ph> (string-Schlüssel)

Gibt den Namen einer Systemumgebungsvariable zurück und gibt den Wert für dieses Gerät zurück.

Argumente
Schlüssel Der Name der Systemumgebungsvariable. Die verfügbaren Variablennamen sind Tabelle 1. Namen von Property-Variablen.
Returns
  • Der Wert der Variablen. Das Datenformat variiert je nach angeforderter Variable.

<ph type="x-smartling-placeholder"></ph> Objekt getSystemProperty <ph type="x-smartling-placeholder"></ph> (string-Schlüssel)

Synonym für getProperty().

Argumente
Schlüssel Der Name der Systemumgebungsvariable. Die verfügbaren Variablennamen sind Tabelle 1. Namen von Property-Variablen:
Returns
  • Der Wert der Variablen. Das Datenformat variiert je nach angeforderter Variable.

<ph type="x-smartling-placeholder"></ph> voidm installPackage <ph type="x-smartling-placeholder"></ph> (String-Pfad)

Installiert die in der Datei "packageFile" enthaltene Android-Anwendung oder das Testpaket. auf diesem Gerät. Wenn die Anwendung oder das Testpaket bereits installiert ist, ersetzt.

Argumente
Pfad Der voll qualifizierte Pfad und Dateiname der zu installierenden .apk-Datei.

<ph type="x-smartling-placeholder"></ph> Wörterbuch Instrument <ph type="x-smartling-placeholder"></ph> ( string className, divityary-Argumente)

Führt die angegebene Komponente mit Android-Instrumentierung aus und gibt die Ergebnisse zurück in einem Wörterbuch, dessen genaues Format durch die auszuführende Komponente vorgegeben wird. Die Komponente muss auf diesem Gerät bereits vorhanden sein.

Verwenden Sie diese Methode, um einen Testlauf zu starten, der eine der Testlaufklassen von Android verwendet. Siehe Tests Grundlagen, um mehr über Unittests mit Android-Tests zu erfahren Framework.

Argumente
Klassenname Der Name einer Android-Komponente, die bereits auf diesem Gerät installiert ist, in der Paketname/Klassenname in Standardform, wobei „packagename“ der Wert für Android-Paketname einer .apk-Datei auf diesem Gerät und "classname" ist der Klassenname einer Android-Komponente (Activity, ContentProvider, Service oder BroadcastReceiver) in dieser Datei gespeichert werden. Beide packagename und classname müssen voll qualifiziert sein. Weitere Informationen finden Sie unter ComponentName.
Argumente Ein Wörterbuch mit Flags und ihren Werten. Diese werden an die Komponente übergeben, gestartet wird. Wenn das Flag keinen Wert annimmt, legen Sie für seinen Wörterbuchwert einen leeren Wert fest. .
Returns

  • Ein Wörterbuch mit der Ausgabe der Komponente. Inhalt des Wörterbuchs von der Komponente selbst definiert werden.

    Wenn Sie InstrumentationTestRunner als Klassennamen in das Argument "ComponentName", dann enthält das Ergebniswörterbuch den einzelnen Schlüssel „stream“. Der Wert von „stream“ ist ein String, der die Testausgabe, als ob InstrumentationTestRunner über die Befehlszeile. Das Format dieser Ausgabe wird unter <ph type="x-smartling-placeholder"></ph> Tests in anderen IDEs

<ph type="x-smartling-placeholder"></ph> voidm drück <ph type="x-smartling-placeholder"></ph> (Stringname, Ganzzahl)

Sendet das in type angegebene Schlüsselereignis an den in keycode.

Argumente
Name Der Name des zu sendenden Keycodes. Unter KeyEvent finden Sie eine Liste der Keycode-Namen. Verwenden Sie den Schlüsselcodenamen, nicht seinen ganzzahligen Wert.
type Der Typ des Schlüsselereignisses, das gesendet werden soll. Die zulässigen Werte sind DOWN, UP und DOWN_AND_UP

<ph type="x-smartling-placeholder"></ph> voidm Neustart <ph type="x-smartling-placeholder"></ph> (string bootloadType)

Startet dieses Gerät in dem von bootloadType angegebenen Bootloader neu.

Argumente
in Der Bootloader-Typ, in dem ein Neustart durchgeführt werden soll. Die zulässigen Werte sind „bootloader“, „recovery“ oder „none“.

<ph type="x-smartling-placeholder"></ph> voidm removePackage <ph type="x-smartling-placeholder"></ph> (string-Paket)

Löscht das angegebene Paket von diesem Gerät, einschließlich der Daten und des Cache.

Argumente
Paket Der Android-Paketname einer .apk-Datei auf diesem Gerät.

<ph type="x-smartling-placeholder"></ph> Objekt Shell <ph type="x-smartling-placeholder"></ph> (string cmd)

Führt einen adb-Shell-Befehl aus und gibt das Ergebnis zurück, falls vorhanden.

Argumente
cmd Der Befehl, der in der adb-Shell ausgeführt werden soll. Die Form dieser Befehle ist im Thema Android-Apps und Debugging Bridge
Returns
  • Die Ergebnisse des Befehls, falls vorhanden. Das Format der Ergebnisse wird durch die .

<ph type="x-smartling-placeholder"></ph> voidm startActivity <ph type="x-smartling-placeholder"></ph> ( string-URI, string-Aktion string-Daten MIME-Typ string iterable Kategorien Wörterbuch-Extras, component-Komponente iterable Flags)

Startet eine Aktivität auf diesem Gerät durch Senden eines aus dem bereitgestellten Argumenten.

Argumente
uri Der URI für den Intent. (siehe Intent.setData()).
Aktion Die Aktion für den Intent (siehe Intent.setAction()).
Daten Der Daten-URI für den Intent (siehe Intent.setData()).
MIME-Typ Der MIME-Typ für den Intent (siehe Intent.setType()).
Kategorien Eine iterierbare Datenstruktur mit Zeichenfolgen, die Kategorien für die Absicht (siehe Intent.addCategory().
Extras Ein Wörterbuch mit zusätzlichen Daten für den Intent (siehe Intent.putExtra() .

Der Schlüssel für jedes Wörterbuchelement sollte ein String sein. Der Wert des Elements kann ein beliebiger einfacher oder strukturierter Datentyp sein.

Komponente Komponente für den Intent (siehe ComponentName). Mit diesem Argument wird der Intent für eine bestimmte Klasse in einem bestimmten Android-Paket.
Flags Eine iterierbare Datenstruktur mit Flags, die steuern, wie der Intent verarbeitet wird (siehe Intent.setFlags()).

<ph type="x-smartling-placeholder"></ph> MonkeyImage takeSnapshot <ph type="x-smartling-placeholder"></ph> ()

Zeichnet den gesamten Bildschirmpuffer des Geräts auf, was einen Screenshot des aktuellen Bildschirms.

Returns
  • Ein MonkeyImage-Objekt, das das Bild der aktuellen Anzeige enthält.

<ph type="x-smartling-placeholder"></ph> voidm Touchscreen <ph type="x-smartling-placeholder"></ph> ( integer x integer y, string)

Sendet ein vom Typ angegebenes Touch-Ereignis an die angegebene Bildschirmposition durch x und y.

Argumente
x Die horizontale Position der Berührung in tatsächlichen Gerätepixeln, beginnend links Bildschirm in der aktuellen Ausrichtung.
y Die vertikale Position der Berührung in tatsächlichen Gerätepixeln, beginnend mit dem oberen Rand des Bildschirm in der aktuellen Ausrichtung.
type Der Typ des Schlüsselereignisses, das gesendet werden soll. Die zulässigen Werte sind DOWN, UP und DOWN_AND_UP

<ph type="x-smartling-placeholder"></ph> voidm Typ <ph type="x-smartling-placeholder"></ph> (String-Nachricht)

Sendet die in der Nachricht enthaltenen Zeichen an dieses Gerät, als über die Gerätetastatur eingegeben wurde. Dies entspricht dem Aufruf press() für jeden Schlüsselcode in message mit dem Schlüsselereignistyp DOWN_AND_UP.

Argumente
Nachricht Ein String mit den Zeichen, die gesendet werden sollen.

<ph type="x-smartling-placeholder"></ph> voidm aufwachen <ph type="x-smartling-placeholder"></ph> ()

Aktiviert den Bildschirm dieses Geräts.

Anhang

Tabelle 1: Namen von Property-Variablen in Verwendung mit getProperty() und getSystemProperty()

Property-Gruppe Attribut Beschreibung Hinweise
build board Codename für die Systemplatine des Geräts Build ansehen
brand Der Mobilfunkanbieter oder Anbieter, für den das Betriebssystem angepasst wurde.
device Der Name des Gerätedesigns.
fingerprint Eine eindeutige Kennung für den derzeit ausgeführten Build.
host
ID Eine Nummer oder ein Label der Änderungsliste.
model Der für den Endnutzer sichtbare Name des Geräts.
product Der allgemeine Produktname.
tags Durch Kommas getrennte Tags zur Beschreibung des Builds, z. B. „nicht signiert“ und „debug“.
type Den Build-Typ, z. B. „user“ oder „eng“.
user
CPU_ABI Der Name des nativen Code-Befehlssatzes im Format CPU-Typ plus der ABI-Konvention.
manufacturer Der Produkt-/Hardwarehersteller.
version.incremental Der interne Code, der vom Versionsverwaltungssystem zur Darstellung dieser Version verwendet wird der Software.
version.release Der für den Nutzer sichtbare Name dieser Softwareversion.
version.sdk Die für den Nutzer sichtbare SDK-Version, die dieser Version des Betriebssystems zugeordnet ist.
version.codename Der aktuelle Entwicklungscodename oder „REL“ ob diese Softwareversion veröffentlicht.
display width Die Displaybreite des Geräts in Pixeln. Weitere Informationen finden Sie unter DisplayMetrics.
height Die Displayhöhe des Geräts in Pixeln.
density Die logische Dichte des Bildschirms. Dies ist ein Faktor, der DIP-Einheiten (Density-Independent Pixel) zur Auflösung des Geräts hinzufügen. Der Dip wird so angepasst, dass 1 DIP entspricht einem Pixel auf einem 160 Pixel-pro-Zoll-Display. Beispiel: bei einem 160-dpi-Bildschirm mit einer Dichte von 1, 0, bei einem 120-dpi-Bildschirm eine Dichte von 0, 75.

Der Wert entspricht nicht genau der tatsächlichen Bildschirmgröße, sondern wird auf großen Veränderungen im Display-DPI-Wert entsprechen. Weitere Informationen finden Sie unter density.

am.current package Der Android-Paketname des derzeit ausgeführten Pakets. Die am.current-Schlüssel geben Informationen zur aktuell ausgeführten Aktivität.
action Die Aktion der aktuellen Aktivität. Das Format entspricht dem von name. des action-Elements in einem Paketmanifest.
comp.class Der Klassenname der Komponente, die die aktuelle Aktivität gestartet hat. Weitere Informationen finden Sie unter comp.package.
comp.package Der Paketname der Komponente, die die aktuelle Aktivität gestartet hat. Eine Komponente wird durch einen Paketnamen und den Namen der Klasse angegeben, die das Paket enthält.
data Die Daten (falls vorhanden), die im Intent enthalten sind, mit dem die aktuelle Aktivität gestartet wurde.
categories Die Kategorien, die durch den Intent angegeben wurden, der die aktuelle Aktivität gestartet hat.
clock realtime Die Anzahl der Millisekunden seit dem Neustart des Geräts, einschließlich Tiefschlafmodus . Weitere Informationen findest du unter SystemClock.
uptime Die Anzahl der Millisekunden seit dem Neustart des Geräts, ohne Tiefschlaf
millis Aktuelle Zeit seit der UNIX-Epoche in Millisekunden.