DispositivoScimmia

Una classe monkeyrunner che rappresenta un dispositivo o un emulatore accessibile dalla workstation in esecuzione monkeyrunner.

Questa classe viene utilizzata per controllare un emulatore o un dispositivo Android. I metodi inviano eventi UI, recuperare informazioni, installare e rimuovere applicazioni ed eseguire applicazioni.

In genere non è necessario creare un'istanza di MonkeyDevice. Invece, utilizzare MonkeyRunner.waitForConnection() per creare un nuovo oggetto da una connessione a un dispositivo oppure un emulatore. Ad esempio, invece di con:

newdevice = MonkeyDevice()

puoi usare: 

newdevice = MonkeyRunner.waitForConnection()

Riepilogo

Costanti
stringa GIÙ Usa questo valore con l'argomento type di press() o touch() per inviare un evento DOWN.
stringa SU Usa questo valore con l'argomento type di press() o touch() per inviare un evento UP.
stringa GIÙ_E_SU Usa questo valore con l'argomento type di press() o touch() per inviare un evento GIÙ, immediatamente seguito da un evento UP.
Metodi
null . broadcastIntent (URI stringa, l'azione string, dati stringa, tipo MIME string, Categorie iterabili extra del dizionario, del componente componente, flag iterabili)
Trasmette un intent su questo dispositivo, come se provenisse da un un'applicazione.
null . trascina (inizio tuple, la tupla, durata float, passaggi di numero intero)
Simula un gesto di trascinamento (tocco, premuto e spostamento) sullo schermo di questo dispositivo.
oggetto getProperty (chiave stringa)
Dato il nome di una variabile di ambiente di sistema, restituisce il valore per questo dispositivo. I nomi delle variabili disponibili sono elencati nella sezione descrizione dettagliata di questo metodo.
oggetto getSystemProperty (chiave stringa)
. L'equivalente API di adb shell getprop <key>. This is provided for use by platform developers.
null . installPackage (percorso stringa)
Installa l'applicazione Android o il pacchetto di test contenuto in packageFile su questo dispositivo. Se l'applicazione o il pacchetto di test è già installato, viene sostituito.
dizionario strumento (className stringa, argomenti dizionario)
Esegue il componente specificato in strumentazione Android e restituisce i risultati in un dizionario il cui formato esatto è dettato dal componente in esecuzione. La deve essere già presente sul dispositivo.
null . premi (nome stringa, tipo dizionario)
Invia l'evento chiave specificato per tipo alla chiave specificata da e il codice chiave.
null . riavvio (stringa in)
Riavvia questo dispositivo nel bootloader specificato da bootloadType.
null . removePackage (pacchetto string)
Elimina il pacchetto specificato da questo dispositivo, inclusi i dati e la cache.
oggetto conchiglia (string cmd)
Esegue un comando shell adb e restituisce l'eventuale risultato.
null . startActivity (URI stringa, l'azione string, dati stringa, tipo MIME string, Categorie iterabili extra del dizionario, del componente componente, segnalazioni)
Avvia un'attività su questo dispositivo inviando un intent creato dal forniti dagli argomenti forniti.
MonkeyImage takeSnapshot()
Acquisisce l'intero buffer dello schermo di questo dispositivo, ottenendo un MonkeyImage oggetto contenente un'acquisizione schermo della visualizzazione corrente.
null . tocco (numero intero x, numero intero y, tipo numero intero)
Invia un evento tocco specificato per tipo alla posizione dello schermo specificata per x e y.
null . tipo (messaggio stringa)
Invia a questo dispositivo i caratteri contenuti nel messaggio, come se era stato digitato sulla tastiera del dispositivo. Equivale a chiamare press() per ogni codice chiave in message utilizzando il tipo di evento chiave DOWN_AND_UP.
null . sveglio ()
Consente di riattivare lo schermo di questo dispositivo.

Costanti

stringa GIÙ

press() o Valore touch(). Specifica che deve essere inviato al dispositivo un tipo di evento GIÙ, corrispondente a premendo un tasto o toccando lo schermo.

stringa SU

press() o Valore touch(). Specifica che deve essere inviato al dispositivo un tipo di evento UP, corrispondente a per rilasciare un tasto o sollevarlo dallo schermo.

stringa GIÙ_E_SU

press(), touch() o type() valore. Specifica che un tipo di evento GIÙ seguito da un tipo di evento UP deve essere inviato al dispositivo, corrispondente alla digitazione di un tasto o al clic sullo schermo.

Metodi pubblici

null . broadcastIntent ( URI string, string, string, tipo MIME string, Categorie iterabili extra di dizionari, componente del componente, flag iterable) .

Trasmette un intent su questo dispositivo, come se provenisse da un un'applicazione. Consulta Intent per ulteriori informazioni sul argomenti.

Argomenti
URI L'URI dell'intent. (vedi Intent.setData()).
azione L'azione per questo intent (vedi Intent.setAction()).
dati L'URI dei dati per questo intent (vedi Intent.setData()).
tipo MIME Il tipo MIME per l'intent (vedi Intent.setType()).
categorie Una struttura di dati iterabile contenente stringhe che definiscono le categorie per questo Intenzione (vedi Intent.addCategory()).
extra Un dizionario di dati aggiuntivi per questo intent (vedi Intent.putExtra() per vedere un esempio).

La chiave per ogni elemento del dizionario deve essere una stringa. Il valore dell'elemento può essere qualsiasi tipo di dati semplice o strutturato.

componente Il componente di questo intent (vedi ComponentName). L'utilizzo di questo argomento indirizzerà l'intent a una classe specifica all'interno di un pacchetto Android.
flag Una struttura di dati iterabile contenente flag che controllano il modo in cui viene gestito l'intent (vedi Intent.setFlags()).

null . trascina ( tuple, tuple, durata in virgola mobile, passi numero intero) .

Simula un gesto di trascinamento (tocco, premuto e spostamento) sullo schermo di questo dispositivo.

Argomenti
partenza Il punto iniziale del gesto di trascinamento, sotto forma di tupla. (x,y) dove x e y sono numeri interi.
fine Il punto finale del gesto di trascinamento, sotto forma di tupla (x,y) dove x e y sono numeri interi.
media La durata del gesto di trascinamento in secondi. Il valore predefinito è 1,0 secondi.
passi Il numero di passaggi da compiere durante l'interpolazione dei punti. Il valore predefinito è 10.

oggetto getProperty (chiave string)

Dato il nome di una variabile di ambiente di sistema, restituisce il valore per questo dispositivo.

Argomenti
chiave Il nome della variabile di ambiente di sistema. I nomi delle variabili disponibili sono elencati in Tabella 1. Nomi delle variabili della proprietà alla fine di questo argomento.
Ritorni
  • Il valore della variabile. Il formato dei dati varia in base alla variabile richiesta.

oggetto getSystemProperty (chiave string)

Sinonimo di getProperty().

Argomenti
chiave Il nome della variabile di ambiente di sistema. I nomi delle variabili disponibili sono elencati in Tabella 1. Nomi delle variabili della proprietà.
Ritorni
  • Il valore della variabile. Il formato dei dati varia in base alla variabile richiesta.

null . installPackage (percorso stringa) .

Installa l'applicazione Android o il pacchetto di test contenuto in packageFile su questo dispositivo. Se l'applicazione o il pacchetto di test è già installato, sostituite.

Argomenti
percorso Il percorso completo e il nome file del file .apk da installare.

dizionario strumento ( string className, argomenti dictionary)

Esegue il componente specificato con la strumentazione Android e restituisce i risultati in un dizionario il cui formato esatto è dettato dal componente in esecuzione. La deve essere già presente sul dispositivo.

Utilizza questo metodo per avviare uno scenario di test che utilizza una delle classi di scenari di test di Android. Consulta la sezione Test Concetti fondamentali per scoprire di più sui test delle unità con Android Testing il modello di machine learning.

Argomenti
nomeclasse Il nome di un componente Android già installato su questo dispositivo, nell' il formato standard nomepacchetto/nome classe, dove nomepacchetto è il nome del pacchetto Android di un file .apk su questo dispositivo e classname è il nome della classe di un componente Android (Activity, ContentProvider, Service o BroadcastReceiver) nel file. Entrambi nome pacchetto e nome classe devono essere completi. Consulta ComponentName per avere ulteriori informazioni.
argomenti Un dizionario contenente flag e relativi valori. Questi vengono passati al componente mentre . Se il flag non accetta un valore, imposta il valore del dizionario su un valore vuoto stringa.
Ritorni

  • Un dizionario contenente l'output del componente. Contenuto del dizionario sono definite dal componente stesso.

    Se utilizzi InstrumentationTestRunner come nome del corso in l'argomento componenteName, il dizionario dei risultati contiene la singola chiave "stream". Il valore di "stream" è una stringa che contiene l'output di test, come se InstrumentationTestRunner venisse eseguito dall'interfaccia a riga di comando. Il formato di questo output è descritto in Test in altri IDE.

null . premi (nome della stringa, tipo numero intero) .

Invia l'evento chiave specificato da type alla chiave specificata da keycode.

Argomenti
nome Il nome del codice chiave da inviare. Consulta KeyEvent per un elenco di i nomi dei keycode. Utilizza il nome del codice chiave, non il suo valore intero.
digita Il tipo di evento chiave da inviare. I valori consentiti sono DOWN, UP e DOWN_AND_UP.

null . riavvio (stringa bootloadType) .

Riavvia questo dispositivo nel bootloader specificato da bootloadType.

Argomenti
in Il tipo di bootloader in cui riavviare. I valori consentiti sono "bootloader", "recovery" o "None".

null . removePackage (pacchetto string) .

Elimina il pacchetto specificato da questo dispositivo, inclusi i dati e la cache.

Argomenti
Pacco Il nome del pacchetto Android di un file .apk su questo dispositivo.

oggetto conchiglia (string cmd)

Esegue un comando shell adb e restituisce l'eventuale risultato.

Argomenti
cmd Il comando da eseguire nella shell adb. La forma di questi comandi descritto nell'argomento Android Bridge di debug.
Ritorni
  • I risultati dell'eventuale comando. Il formato dei risultati è determinato dal .

null . startActivity ( URI string, string, string, tipo MIME string, Categorie iterabili extra di dizionari, componente del componente, flag iterable) .

Avvia un'attività su questo dispositivo inviando un intent creato dal forniti dagli argomenti forniti.

Argomenti
URI L'URI dell'intent. (vedi Intent.setData()).
azione L'azione per l'intent (vedi Intent.setAction()).
dati L'URI dei dati per l'intent (vedi Intent.setData()).
tipo MIME Il tipo MIME per l'intent (vedi Intent.setType()).
categorie Una struttura di dati iterabile contenente stringhe che definiscono le categorie per il Intenzione (vedi Intent.addCategory()).
extra Un dizionario di dati aggiuntivi per l'intent (vedi Intent.putExtra() per vedere un esempio).

La chiave per ogni elemento del dizionario deve essere una stringa. Il valore dell'elemento può essere qualsiasi tipo di dati semplice o strutturato.

componente Il componente per l'intent (vedi ComponentName). L'utilizzo di questo argomento indirizzerà Intento a una classe specifica all'interno di un pacchetto Android specifico.
flag Una struttura di dati iterabile contenente flag che controllano il modo in cui viene gestito l'intent (vedi Intent.setFlags()).

MonkeyImage takeSnapshot ()

Acquisisce l'intero buffer dello schermo di questo dispositivo, ottenendo un acquisizione dello schermo del display corrente.

Ritorni
  • Un MonkeyImage contenente l'immagine del display corrente.

null . tocco ( numero intero x, numero intero y, stringa) .

Invia un evento tocco specificato per tipo alla posizione dello schermo specificata per x e y.

Argomenti
x La posizione orizzontale del tocco in pixel effettivi del dispositivo, a partire dal lato sinistro di dello schermo nell'orientamento corrente.
y La posizione verticale del tocco in pixel effettivi del dispositivo, a partire dalla parte superiore di dello schermo nell'orientamento corrente.
digita Il tipo di evento chiave da inviare. I valori consentiti sono DOWN, UP e DOWN_AND_UP.

null . tipo (messaggio stringa) .

Invia a questo dispositivo i caratteri contenuti nel messaggio, come se era stato digitato sulla tastiera del dispositivo. Equivale a chiamare press() per ogni codice chiave in message utilizzando il tipo di evento chiave DOWN_AND_UP.

Argomenti
messaggio Una stringa contenente i caratteri da inviare.

null . sveglio () .

Consente di riattivare lo schermo di questo dispositivo.

Appendice

Tabella 1.Nomi delle variabili delle proprietà utilizzati con getProperty() e getSystemProperty().

Gruppo proprietà Proprietà Descrizione Note
build board Nome del codice della scheda di sistema del dispositivo Visualizza Build
brand L'operatore o il provider per cui il sistema operativo è personalizzato.
device Il nome del design del dispositivo.
fingerprint Un identificatore univoco per la build attualmente in esecuzione.
host
ID Un numero o un'etichetta dell'elenco modifiche.
model Il nome visibile all'utente finale del dispositivo.
product Il nome complessivo del prodotto.
tags Tag separati da virgole che descrivono la build, ad esempio "unfirmato" e "debug".
type Il tipo di build, ad esempio "utente" o "eng".
user
CPU_ABI Il nome del set di istruzioni del codice nativo, nel formato tipo di CPU più convenzione ABI.
manufacturer Il produttore del prodotto/hardware.
version.incremental Il codice interno utilizzato dal sistema di controllo del codice sorgente per rappresentare questa versione del software.
version.release Il nome visibile all'utente di questa versione del software.
version.sdk La versione dell'SDK visibile all'utente associata a questa versione del sistema operativo.
version.codename Il nome in codice di sviluppo corrente, o "REL" se questa versione del software è stata rilasciate.
display width La larghezza del display del dispositivo in pixel. Consulta DisplayMetrics per i dettagli.
height L'altezza del display del dispositivo in pixel.
density La densità logica del display. È un fattore che può scalare Unità DIP (Density-Independent Pixel) alla risoluzione del dispositivo. DIP è regolato in modo che 1 DIP equivale a un pixel su un display da 160 pixel per pollice. Ad esempio: su uno schermo da 160 dpi, densità = 1,0, mentre su uno schermo da 120 dpi, densità = 0,75.

Il valore non segue esattamente le dimensioni reali dello schermo, ma è regolato su sono conformi alle grandi variazioni del DPI del display. Consulta density per avere ulteriori informazioni.

am.current package Il nome del pacchetto Android attualmente in esecuzione. Le chiavi am.current restituiscono informazioni sull'elemento attualmente in esecuzione Attività.
action L'azione dell'attività corrente. Ha lo stesso formato di name dell'elemento action nel file manifest di un pacchetto.
comp.class Il nome della classe del componente che ha avviato l'attività corrente. Consulta comp.package per avere ulteriori informazioni.
comp.package Il nome del pacchetto del componente che ha avviato l'attività corrente. Un componente è specificato dal nome del pacchetto e dal nome della classe contenuta nel pacchetto.
data Gli eventuali dati contenuti nell'intent che ha avviato l'attività corrente.
categories Le categorie specificate dall'intent che ha avviato l'attività corrente.
clock realtime Il numero di millisecondi dal riavvio del dispositivo, inclusa la modalità di sospensione profonda nel tempo. Consulta SystemClock per saperne di più.
uptime Il numero di millisecondi dal riavvio del dispositivo, escluso durata del sonno profondo
millis tempo corrente dall'epoca UNIX, in millisecondi.