IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


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

Riepilogo

Classi nidificate

interface IDeviceManager.IFastbootListener

Un listener per le modifiche dello stato di fastboot. 

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 dello stato di fastboot.

abstract void addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)

Aggiungi un dispositivo al monitoraggio fastboot.

abstract ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

Richiedi un dispositivo per i test che soddisfi determinati criteri.

abstract ITestDevice allocateDevice(IDeviceSelection options)

Richiedi un dispositivo per i test che soddisfi determinati criteri.

abstract ITestDevice allocateDevice()

Richiedere un dispositivo fisico per i test

abstract ITestDevice connectToTcpDevice(String ipAndPort)

Connettersi 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)

Il ITestDevice restituito sarà online, ma potrebbe non rispondere.

abstract boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

Scollega un dispositivo connesso tramite adb-over-tcp.

abstract void displayDevicesInfo(PrintWriter printWriter, boolean includeStub)

Restituisci una descrizione intuitiva contenente l'elenco dei dispositivi noti, il loro stato e i valori per le opzioni IDeviceSelection utilizzate di frequente.

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

Un metodo helper per eseguire il comando shell sul dispositivo disponibile.

abstract ITestDevice forceAllocateDevice(String serial)

Assegna forzatamente un dispositivo, anche se non è attualmente disponibile.

abstract void freeDevice(ITestDevice device, FreeDeviceState state)

Restituire un dispositivo al pool

I tentativi di restituire un dispositivo che non è stato allocato in precedenza verranno ignorati.

abstract String getAdbPath()

Restituisce il percorso del file binario adb da utilizzare.

abstract String getAdbVersion()

Ottieni la versione di adb attualmente in uso da Device Manager.

abstract DeviceDescriptor getDeviceDescriptor(String serial)

Restituisce DeviceDescriptor con il numero di serie specificato.

abstract String getFastbootPath()

Restituisce il percorso del file binario fastboot da utilizzare.

abstract void init(IDeviceSelection globalDeviceFilter, deviceMonitors)

Inizializza il gestore dei dispositivi con un filtro per i dispositivi.

abstract void init()

Inizializza Device Manager.

abstract boolean isEmulator(String serial)

Determinare se il numero di serie specificato rappresenta un emulatore

default boolean isFileSystemMountCheckEnabled()

Restituisce un valore che indica se dobbiamo eseguire il check-in di NativeDeviceStateMonitor il file system è montato correttamente.

abstract boolean isNullDevice(String serial)

Determina se il numero di serie specificato rappresenta un dispositivo nullo

abstract void killEmulator(ITestDevice device)

Arresta l'emulatore specificato.

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

Metodo helper per avviare l'emulatore.

abstract listAllDevices(boolean shortDescriptor)

Restituisce un elenco di DeviceDescriptor per tutti i dispositivi noti

abstract listAllDevices()

Restituisce un elenco di DeviceDescriptor per tutti i dispositivi noti

abstract ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

Un metodo helper che passa il dispositivo USB specificato alla modalità adb-over-tcp e poi si connette 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 dello stato di fastboot.

default void removeMonitoringTcpFastbootDevice(String serial)
abstract void restartAdbBridge()

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

abstract void stopAdbBridge()

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

abstract void terminate()

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

abstract void terminateDeviceMonitor()

Interrompi i monitor dei dispositivi.

abstract void terminateDeviceRecovery()

Interrompe il thread di recupero del dispositivo.

default void terminateHard(String reason)

Come terminateHard().

abstract void terminateHard()

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

abstract boolean waitForFirstDeviceAdded(long timeout)

Attendi che venga 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 dello stato di fastboot.

Al momento, un IDeviceManager monitorerà i dispositivi in modalità fastboot solo se sono presenti uno o più listener attivi.

TODO: this is a bit of a hack - find a better solution

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Aggiungi un dispositivo al monitoraggio 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.

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Richiedi un dispositivo per i test che soddisfi determinati criteri.

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

isTemporary boolean: indica se creare o meno un dispositivo NullDevice temporaneo.

Ritorni
ITestDevice un ITestDevice per i test o null se non è disponibile

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options)

Richiedi un dispositivo per i test che soddisfi determinati criteri.

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

Ritorni
ITestDevice un ITestDevice per i test o null se non è disponibile

allocateDevice

public abstract ITestDevice allocateDevice ()

Richiedere un dispositivo fisico per i test

Ritorni
ITestDevice un ITestDevice per i test o null se non è disponibile

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Connettersi 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)

Il ITestDevice restituito sarà online, ma potrebbe non rispondere.

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

Parametri
ipAndPort String: l'indirizzo IP e la porta originali del dispositivo a cui connettersi

Ritorni
ITestDevice ITestDevice o null se non è stato possibile stabilire una connessione TCP

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Scollega un dispositivo connesso tramite adb-over-tcp.

Riporta il dispositivo in modalità USB e lo libera.

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

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

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Restituisci una descrizione intuitiva contenente l'elenco dei dispositivi noti, il loro stato e i valori per le opzioni IDeviceSelection utilizzate di frequente.

Parametri
printWriter PrintWriter: il ERROR(/PrintWriter) in cui restituire la descrizione

includeStub boolean: Indica se visualizzare anche i dispositivi stub.

executeCmdOnAvailableDevice

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

Un metodo helper per eseguire il comando shell sul dispositivo disponibile.

Parametri
serial String: il numero di serie del dispositivo.

command String: il comando shell.

timeout long: il tempo necessario per completare il comando.

timeUnit TimeUnit: l'unità per il timeout.

Ritorni
CommandResult A CommandResult.

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Assegna forzatamente un dispositivo, anche se non è attualmente disponibile.

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

Parametri
serial String: il numero di serie del dispositivo da allocare

Ritorni
ITestDevice ITestDevice o null se non è stato possibile allocarlo

freeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Restituire un dispositivo al pool

I tentativi di restituire un dispositivo che non è stato allocato in precedenza verranno ignorati.

Parametri
device ITestDevice: il ITestDevice senza costi

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 file binario adb da utilizzare.

Ritorni
String

getAdbVersion

public abstract String getAdbVersion ()

Ottieni la versione di adb attualmente in uso da Device Manager.

Ritorni
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

Restituisce DeviceDescriptor con il numero di serie specificato.

Parametri
serial String: il numero di serie del dispositivo da recuperare

Ritorni
DeviceDescriptor DeviceDescriptor per il dispositivo selezionato o null se il numero di serie non corrisponde a un dispositivo noto.

getFastbootPath

public abstract String getFastbootPath ()

Restituisce il percorso del file binario fastboot da utilizzare.

Ritorni
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Inizializza il gestore dei dispositivi con un filtro dei dispositivi. Questo filtro può essere utilizzato per indicare a DeviceManager di ignorare determinati dispositivi connessi.

Parametri
globalDeviceFilter IDeviceSelection: il filtro del dispositivo

deviceMonitors

init

public abstract void init ()

Inizializza Device Manager. Questo metodo deve essere chiamato una sola volta prima di qualsiasi altro metodo.

isEmulator

public abstract boolean isEmulator (String serial)

Determinare se il numero di serie specificato rappresenta un emulatore

Parametri
serial String

Ritorni
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Restituisce un valore che indica se dobbiamo eseguire il check-in di NativeDeviceStateMonitor il file system è montato correttamente.

Ritorni
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

Determina se il numero di serie specificato rappresenta un dispositivo nullo

Parametri
serial String

Ritorni
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

Arresta l'emulatore specificato.

Blocca fino a quando l'emulatore non scompare da adb. Non avrà alcun effetto se l'emulatore non è già disponibile.

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

Lanci
DeviceNotAvailableException se l'emulatore non si chiude

launchEmulator

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

Metodo helper per avviare l'emulatore.

Avvia l'emulatore come specificato dal chiamante

Parametri
device ITestDevice: il segnaposto ITestDevice che rappresenta il dispositivo emulatore allocato

bootTimeout long: il tempo in millisecondi da attendere per l'avvio dell'emulatore

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

Lanci
DeviceNotAvailableException se l'emulatore non si avvia o non si connette a internet

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

Restituisce un elenco di DeviceDescriptor per tutti i dispositivi noti

Parametri
shortDescriptor boolean: se limitare i descrittori alle informazioni minime

Ritorni
un elenco di DeviceDescriptor per tutti i dispositivi noti

listAllDevices

public abstract  listAllDevices ()

Restituisce un elenco di DeviceDescriptor per tutti i dispositivi noti

Ritorni
un elenco di DeviceDescriptor per tutti i dispositivi noti

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Un metodo helper che passa il dispositivo USB specificato alla modalità adb-over-tcp e poi si connette tramite connectToTcpDevice(String).

Parametri
usbDevice ITestDevice: il dispositivo attualmente in modalità USB

Ritorni
ITestDevice ITestDevice appena allocato in modalità TCP o null se non è stato possibile stabilire una connessione TCP

Lanci
DeviceNotAvailableException se la connessione con usbDevice è stata interrotta e non è stato possibile recuperarla

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

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

Parametri
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informa il gestore che un listener non è più interessato alle modifiche dello stato di fastboot.

removeMonitoringTcpFastbootDevice

public void removeMonitoringTcpFastbootDevice (String serial)

Parametri
serial String

restartAdbBridge

public abstract void restartAdbBridge ()

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

stopAdbBridge

public abstract void stopAdbBridge ()

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

terminare

public abstract void terminate ()

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

Deve essere chiamato al termine dell'applicazione.

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

Interrompi i monitor dei dispositivi.

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

Interrompe il thread di recupero del dispositivo.

terminateHard

public void terminateHard (String reason)

Come terminateHard().

Parametri
reason String: motivo facoltativo fornito per la chiusura.

terminateHard

public abstract void terminateHard ()

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

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Attendi che venga 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.

Ritorni
boolean