IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Interfaccia per la gestione del set di dispositivi disponibili per il test.

Riepilogo

Classi nidificate

interface IDeviceManager.IFastbootListener

Un listener per le modifiche allo stato di avvio rapido.

Metodi pubblici

abstract void addDeviceMonitor ( IDeviceMonitor mon)

Aggiunge un IDeviceMonitor

abstract void addFastbootListener ( IDeviceManager.IFastbootListener listener)

Informa il gestore che un listener è interessato alle modifiche allo stato di avvio rapido.

abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

Aggiungi un dispositivo al monitor fastboot.

abstract ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

Richiedi un dispositivo per il test che soddisfi determinati criteri.

abstract ITestDevice allocateDevice ( IDeviceSelection options)

Richiedi un dispositivo per il test che soddisfi determinati criteri.

abstract ITestDevice allocateDevice ()

Richiedi un dispositivo fisico per il test

abstract ITestDevice connectToTcpDevice (String ipAndPort)

Connettiti a un dispositivo con adb-over-tcp

Questo metodo alloca un nuovo dispositivo, che alla fine dovrebbe essere liberato tramite disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

L' ITestDevice restituito sarà online, ma potrebbe non rispondere.

abstract boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

Disconnettersi da un dispositivo connesso adb-over-tcp.

abstract void displayDevicesInfo (PrintWriter printWriter, boolean includeStub)

Restituisce una descrizione intuitiva contenente un elenco di dispositivi noti, il relativo stato e i valori per le opzioni IDeviceSelection comunemente utilizzate.

abstract CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)

Un metodo di supporto per eseguire il comando della shell sul dispositivo disponibile.

abstract ITestDevice forceAllocateDevice (String serial)

Assegnare bruscamente un dispositivo, anche se non è attualmente disponibile.

abstract void freeDevice ( ITestDevice device, FreeDeviceState state)

Restituisci un dispositivo al pool

I tentativi di restituzione di un dispositivo che non è stato assegnato in precedenza verranno ignorati.

abstract String getAdbPath ()

Restituisce il percorso del binario adb da utilizzare.

abstract String getAdbVersion ()

Ottieni la versione adb attualmente in uso dal gestore dispositivi.

abstract DeviceDescriptor getDeviceDescriptor (String serial)

Restituisce il DeviceDescriptor con il dato seriale.

abstract String getFastbootPath ()

Restituisce il percorso del file binario fastboot da utilizzare.

abstract void init ( IDeviceSelection globalDeviceFilter, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, deviceMonitors)

Inizializza Gestione dispositivi con un filtro dispositivi.

abstract void init ()

Inizializza il gestore dispositivi.

abstract boolean isEmulator (String serial)

Determina se dato seriale rappresenta un emulatore

default boolean isFileSystemMountCheckEnabled ()

Restituisce se è necessario verificare o meno in NativeDeviceStateMonitor che il file system sia montato correttamente.

abstract boolean isNullDevice (String serial)

Determina se dato seriale rappresenta un dispositivo nullo

abstract void killEmulator ( ITestDevice device)

Arrestare l'emulatore dato.

abstract void launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs)

Metodo di supporto per avviare l'emulatore.

abstract listAllDevices (boolean shortDescriptor)

Restituisce un elenco di DeviceDescriptors per tutti i dispositivi noti

abstract listAllDevices ()

Restituisce un elenco di DeviceDescriptors per tutti i dispositivi noti

abstract ITestDevice reconnectDeviceToTcp ( ITestDevice usbDevice)

Un metodo di supporto che commuta il dispositivo USB specificato in modalità adb-over-tcp e quindi si connette ad esso tramite connectToTcpDevice(String) .

abstract void removeDeviceMonitor ( IDeviceMonitor mon)

Rimuove un IDeviceMonitor aggiunto in precedenza.

abstract void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

Informa il gestore che un listener non è più interessato alle modifiche allo stato di avvio rapido.

abstract void restartAdbBridge ()

Riavvia (se è stato chiamato stopAdbBridge() ) adb bridge e i servizi dipendono dalle connessioni adb.

abstract void stopAdbBridge ()

Arresta il bridge adb e i servizi dipendono dalle connessioni adb.

abstract void terminate ()

Arresta i servizi di monitoraggio del dispositivo e termina la libreria ddm.

abstract void terminateDeviceMonitor ()

Arrestare i monitor del dispositivo.

abstract void terminateDeviceRecovery ()

Arresta il thread di ripristino del dispositivo.

default void terminateHard (String reason)

Come terminateHard() .

abstract void terminateHard ()

Come terminate() , ma tenta anche di chiudere forzatamente adb.

abstract boolean waitForFirstDeviceAdded (long timeout)

Attendere finché non viene connesso un primo dispositivo fisico.

Metodi pubblici

addDeviceMonitor

public abstract void addDeviceMonitor (IDeviceMonitor mon)

Aggiunge un IDeviceMonitor

Parametri
mon IDeviceMonitor

addFastbootListener

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

Informa il gestore che un listener è interessato alle modifiche allo stato di avvio rapido.

Attualmente un IDeviceManager monitorerà solo i dispositivi in ​​fastboot se ci sono uno o più ascoltatori attivi.

TODO: questo è un po' un trucco: trova una soluzione migliore

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Aggiungi un dispositivo al monitor fastboot. Il monitor fastboot utilizzerà 'fastboot_serial' per comunicare con il dispositivo.

Parametri
serial String : il numero di serie del dispositivo.

fastboot_serial String : il numero di serie della modalità fastboot del dispositivo.

allocareDispositivo

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Richiedi un dispositivo per il test che soddisfi determinati criteri.

Parametri
options IDeviceSelection : l' IDeviceSelection che il dispositivo deve soddisfare.

isTemporary boolean : se deve essere creato o meno un NullDevice temporaneo.

ritorna
ITestDevice un ITestDevice per il test o null se non è disponibile

allocareDispositivo

public abstract ITestDevice allocateDevice (IDeviceSelection options)

Richiedi un dispositivo per il test che soddisfi determinati criteri.

Parametri
options IDeviceSelection : l' IDeviceSelection che il dispositivo deve soddisfare.

ritorna
ITestDevice un ITestDevice per il test o null se non è disponibile

allocareDispositivo

public abstract ITestDevice allocateDevice ()

Richiedi un dispositivo fisico per il test

ritorna
ITestDevice un ITestDevice per il test o null se non è disponibile

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Connettiti a un dispositivo con adb-over-tcp

Questo metodo alloca un nuovo dispositivo, che alla fine dovrebbe essere liberato tramite disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

L' ITestDevice restituito sarà online, ma potrebbe non rispondere.

Tieni presente che l'esecuzione di un'azione come il riavvio su un dispositivo connesso a tcp interromperà la connessione tcp al dispositivo e genererà un'eccezione DeviceNotAvailableException

Parametri
ipAndPort String : l'indirizzo ip originale e la porta del dispositivo a cui connettersi

ritorna
ITestDevice ITestDevice o null se non è stato possibile formare una connessione tcp

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Disconnettersi da un dispositivo connesso adb-over-tcp.

Riporta il dispositivo in modalità USB e lo libera.

Parametri
tcpDevice ITestDevice : il dispositivo attualmente in modalità tcp, precedentemente allocato tramite connectToTcpDevice(String)

ritorna
boolean true se il passaggio alla modalità USB è riuscito

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Restituisce una descrizione intuitiva contenente un elenco di dispositivi noti, il relativo stato e i valori per le opzioni IDeviceSelection comunemente utilizzate.

Parametri
printWriter PrintWriter : l' ERROR(/PrintWriter) a cui inviare la descrizione

includeStub boolean : se visualizzare o meno anche i dispositivi stub.

executeCmdOnAvailableDevice

public abstract CommandResult executeCmdOnAvailableDevice (String serial, 
                String command, 
                long timeout, 
                TimeUnit timeUnit)

Un metodo di supporto per eseguire il comando della shell sul dispositivo disponibile.

Parametri
serial String : il seriale del dispositivo.

command String : il comando della shell.

timeout long : la quantità di tempo per il completamento del comando.

timeUnit TimeUnit : l'unità per il timeout.

ritorna
CommandResult Un CommandResult .

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Assegnare bruscamente un dispositivo, anche se non è attualmente disponibile.

Non avrà effetto se il dispositivo è già assegnato.

Parametri
serial String : il seriale del dispositivo da allocare

ritorna
ITestDevice ITestDevice o null se non è stato possibile allocarlo

freeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Restituisci un dispositivo al pool

I tentativi di restituzione di un dispositivo che non è stato assegnato in precedenza verranno ignorati.

Parametri
device ITestDevice : l' ITestDevice da liberare

state FreeDeviceState : il FreeDeviceState . Utilizzato per controllare se il dispositivo viene restituito al pool di dispositivi disponibili.

getAdbPath

public abstract String getAdbPath ()

Restituisce il percorso del binario adb da utilizzare.

ritorna
String

getAdbVersion

public abstract String getAdbVersion ()

Ottieni la versione adb attualmente in uso dal gestore dispositivi.

ritorna
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

Restituisce il DeviceDescriptor con il dato seriale.

Parametri
serial String : numero di serie che deve essere ottenuto dal dispositivo

ritorna
DeviceDescriptor il DeviceDescriptor per il dispositivo selezionato o null se il seriale non corrisponde a un dispositivo noto.

getFastbootPath

public abstract String getFastbootPath ()

Restituisce il percorso del file binario fastboot da utilizzare.

ritorna
String

dentro

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Inizializza Gestione dispositivi con un filtro dispositivi. Questo filtro può essere utilizzato per indicare a DeviceManager di ignorare determinati dispositivi collegati.

Parametri
globalDeviceFilter IDeviceSelection : il filtro del dispositivo

deviceMonitors

dentro

public abstract void init ()

Inizializza il gestore dispositivi. Questo deve essere chiamato una volta e solo una volta prima che vengano chiamati altri metodi.

isEmulator

public abstract boolean isEmulator (String serial)

Determina se dato seriale rappresenta un emulatore

Parametri
serial String

ritorna
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Restituisce se è necessario controllare o meno in NativeDeviceStateMonitor che il file system sia montato correttamente.

ritorna
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

Determina se dato seriale rappresenta un dispositivo nullo

Parametri
serial String

ritorna
boolean

killEmulatore

public abstract void killEmulator (ITestDevice device)

Arrestare l'emulatore specificato.

Si blocca finché l'emulatore non scompare da adb. Non avrà effetto se l'emulatore non è già disponibile.

Parametri
device ITestDevice : l' ITestDevice che rappresenta l'emulatore da arrestare

Getta
DeviceNotAvailableException se l'emulatore non si spegne

launchEmulator

public abstract void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                 emulatorArgs)

Metodo di supporto per avviare l'emulatore.

Avvia l'emulatore come specificato dal chiamante

Parametri
device ITestDevice : il segnaposto ITestDevice che rappresenta il dispositivo di emulazione allocato

bootTimeout long : il tempo in ms di attesa per l'avvio dell'emulatore

emulatorArgs : argomenti della riga di comando per avviare l'emulatore

Getta
DeviceNotAvailableException se l'emulatore non si avvia o non va online

listTutti i dispositivi

public abstract  listAllDevices (boolean shortDescriptor)

Restituisce un elenco di DeviceDescriptors per tutti i dispositivi noti

Parametri
shortDescriptor boolean : se limitare i descrittori alle informazioni minime

ritorna
un elenco di DeviceDescriptor per tutti i dispositivi conosciuti

listTutti i dispositivi

public abstract  listAllDevices ()

Restituisce un elenco di DeviceDescriptors per tutti i dispositivi noti

ritorna
un elenco di DeviceDescriptor per tutti i dispositivi conosciuti

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Un metodo di supporto che commuta il dispositivo USB specificato in modalità adb-over-tcp e quindi si connette ad esso tramite connectToTcpDevice(String) .

Parametri
usbDevice ITestDevice : il dispositivo attualmente in modalità USB

ritorna
ITestDevice l' ITestDevice appena allocato in modalità tcp o null se non è stato possibile formare una connessione tcp

Getta
DeviceNotAvailableException se la connessione con usbDevice è stata persa e non può essere recuperata

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

Rimuove un IDeviceMonitor aggiunto in precedenza. Non ha effetto se mon non è stato aggiunto.

Parametri
mon IDeviceMonitor

rimuovereFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informa il gestore che un listener non è più interessato alle modifiche allo stato di avvio rapido.

riavviaAdbBridge

public abstract void restartAdbBridge ()

Riavvia (se è stato chiamato stopAdbBridge() ) adb bridge e i servizi dipendono dalle connessioni adb.

stopAdbBridge

public abstract void stopAdbBridge ()

Arresta il bridge adb e i servizi dipendono dalle connessioni adb.

terminare

public abstract void terminate ()

Arresta i servizi di monitoraggio del dispositivo e termina la libreria ddm.

Questo deve essere chiamato alla chiusura della domanda.

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

Arrestare i monitor del dispositivo.

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

Arresta il thread di ripristino del dispositivo.

terminateHard

public void terminateHard (String reason)

Come terminateHard() .

Parametri
reason String : motivo facoltativo fornito per la risoluzione.

terminateHard

public abstract void terminateHard ()

Come terminate() , ma tenta anche di chiudere forzatamente adb.

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Attendere finché non viene connesso un primo dispositivo fisico. Se un dispositivo è stato connesso in precedenza, restituisce direttamente True. Se non è stato aggiunto alcun dispositivo, restituisce false dopo il timeout.

Parametri
timeout long : tempo di attesa in millisecondi prima di restituire false.

ritorna
boolean