Gestore dispositivi

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Object
com.android.tradefed.device.DeviceManager


Riepilogo

Classi nidificate

class DeviceManager.FastbootDevice

Rappresentazione di un dispositivo in modalità Fastboot.

Campi

public static final String UNKNOWN_DISPLAY_STRING

Visualizza la stringa per le proprietà sconosciute

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

Costruttori pubblici

DeviceManager ()

Il DeviceManager dovrebbe essere recuperato da GlobalConfiguration

Metodi pubblici

void addAvailableDevice (IDevice stubDevice)
void addDeviceMonitor ( IDeviceMonitor mon)

Aggiunge un IDeviceMonitor

void addFastbootDevice ( DeviceManager.FastbootDevice fastbootDevice)
void addFastbootListener ( IDeviceManager.IFastbootListener listener)

Informa il manager che un ascoltatore è interessato ai cambiamenti dello stato di avvio rapido.

void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

Aggiungi un dispositivo al monitor di avvio rapido.

ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

Richiedi un dispositivo per il test che soddisfi determinati criteri.

ITestDevice allocateDevice ( IDeviceSelection options)

Richiedi un dispositivo per il test che soddisfi determinati criteri.

ITestDevice allocateDevice ()

Richiedi un dispositivo fisico per il test

ITestDevice connectToTcpDevice (String ipAndPort)

Connettiti a un dispositivo con adb-over-tcp

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

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

boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

Disconnettersi da un dispositivo connesso adb-over-tcp.

void displayDevicesInfo (PrintWriter stream, boolean includeStub)

Genera una descrizione intuitiva contenente l'elenco dei dispositivi conosciuti, il loro stato e i valori per le opzioni IDeviceSelection comunemente utilizzate.

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

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

String executeGlobalAdbCommand (String... cmdArgs)

Esegui un comando adb non mirato a un particolare dispositivo, ad es.

ITestDevice forceAllocateDevice (String serial)

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

void freeDevice ( ITestDevice device, FreeDeviceState deviceState)

Restituisci un dispositivo al pool

I tentativi di restituire un dispositivo che non è stato precedentemente assegnato verranno ignorati.

String getAdbPath ()

Restituisce il percorso del file binario adb da utilizzare.

String getAdbVersion ()

Ottieni la versione adb attualmente utilizzata da Gestione dispositivi.

DeviceDescriptor getDeviceDescriptor (String serial)

Restituisce il DeviceDescriptor con il seriale specificato.

String getFastbootPath ()

Restituisce il percorso del binario fastboot da utilizzare.

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

Inizializza la gestione dispositivi.

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

Inizializza la gestione dispositivi.

void init ()

Inizializza la gestione dispositivi.

boolean isEmulator (String serial)

Determina se il seriale dato rappresenta un emulatore

boolean isFileSystemMountCheckEnabled ()

Indica se verificare o meno in NativeDeviceStateMonitor che il file system sia montato correttamente.

boolean isNullDevice (String serial)

Determina se il seriale indicato rappresenta un dispositivo nullo

void killEmulator ( ITestDevice device)

Arrestare l'emulatore fornito.

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

Metodo di supporto per avviare l'emulatore.

listAllDevices (boolean shortDescriptor)

Restituisce un elenco di DeviceDescriptors per tutti i dispositivi conosciuti

listAllDevices ()

Restituisce un elenco di DeviceDescriptors per tutti i dispositivi conosciuti

ITestDevice reconnectDeviceToTcp ( ITestDevice usbDevice)

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

void removeDeviceMonitor ( IDeviceMonitor mon)

Rimuove un IDeviceMonitor aggiunto in precedenza.

void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

Informa il manager che un ascoltatore non è più interessato ai cambiamenti dello stato di avvio rapido.

void restartAdbBridge ()

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

void stopAdbBridge ()

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

void terminate ()

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

void terminateDeviceMonitor ()

Interrompere i monitoraggi del dispositivo.

void terminateDeviceRecovery ()

Interrompe il thread di ripristino del dispositivo.

void terminateHard (String reason)

Come terminateHard() .

void terminateHard ()

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

boolean waitForFirstDeviceAdded (long timeout)

Attendi fino al collegamento del primo dispositivo fisico.

Campi

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Visualizza la stringa per le proprietà sconosciute

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootAbilitato

protected boolean mFastbootEnabled

Costruttori pubblici

Gestore dispositivi

public DeviceManager ()

Il DeviceManager dovrebbe essere recuperato da GlobalConfiguration

Metodi pubblici

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

Parametri
stubDevice IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

Aggiunge un IDeviceMonitor

Parametri
mon IDeviceMonitor

aggiungiFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

Parametri
fastbootDevice DeviceManager.FastbootDevice

aggiungiFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

Informa il manager che un ascoltatore è interessato ai cambiamenti dello stato di avvio rapido.

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

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

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Aggiungi un dispositivo al monitor di avvio rapido. Il monitor di avvio rapido utilizzerà "fastboot_serial" per comunicare con il dispositivo.

Parametri
serial String : il numero di serie del dispositivo.

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

allocateDevice

public 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 ne è disponibile uno

allocateDevice

public 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 ne è disponibile uno

allocateDevice

public ITestDevice allocateDevice ()

Richiedi un dispositivo fisico per il test

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

connectToTcpDevice

public ITestDevice connectToTcpDevice (String ipAndPort)

Connettiti a un dispositivo con adb-over-tcp

Questo metodo alloca un nuovo dispositivo, che dovrebbe eventualmente 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 un riavvio su un dispositivo connesso tramite 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 stabilire una connessione TCP

disconnesso da TcpDevice

public 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 ha avuto esito positivo

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

Genera una descrizione intuitiva contenente l'elenco dei dispositivi conosciuti, il loro stato e i valori per le opzioni IDeviceSelection comunemente utilizzate.

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

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

eseguireCmdOnAvailableDevice

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

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

Parametri
serial String : il seriale del dispositivo.

command String : il comando della shell.

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

timeUnit TimeUnit : l'unità per il timeout.

ritorna
CommandResult Un CommandResult .

eseguireGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Esegui un comando adb non mirato a un particolare dispositivo, ad es. 'adb connetti'

ritorna
String output std se il comando ha successo null altrimenti.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

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

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

Parametri
serial String : la seriale del dispositivo da allocare

ritorna
ITestDevice ITestDevice o null se non è stato possibile allocarlo

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Restituisci un dispositivo al pool

I tentativi di restituire un dispositivo che non è stato precedentemente assegnato verranno ignorati.

Parametri
device ITestDevice : l' ITestDevice da liberare

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

getAdbPath

public String getAdbPath ()

Restituisce il percorso del file binario adb da utilizzare.

ritorna
String

getAdbVersion

public String getAdbVersion ()

Ottieni la versione adb attualmente utilizzata da Gestione dispositivi.

ritorna
String

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

Restituisce il DeviceDescriptor con il seriale specificato.

Parametri
serial String : numero di serie del dispositivo da ottenere

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

getFastbootPath

public String getFastbootPath ()

Restituisce il percorso del binario fastboot da utilizzare.

ritorna
String

dentro

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

Inizializza la gestione dispositivi. Questo deve essere chiamato una e una sola volta prima che venga chiamato qualsiasi altro metodo.

Parametri
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

dentro

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

Inizializza la gestione dispositivi. Questo deve essere chiamato una e una sola volta prima che venga chiamato qualsiasi altro metodo.

Parametri
globalDeviceFilter IDeviceSelection : il filtro del dispositivo

globalDeviceMonitors

dentro

public void init ()

Inizializza la gestione dispositivi. Questo deve essere chiamato una e una sola volta prima che venga chiamato qualsiasi altro metodo.

isEmulator

public boolean isEmulator (String serial)

Determina se il seriale dato rappresenta un emulatore

Parametri
serial String

ritorna
boolean

èFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Indica se verificare o meno in NativeDeviceStateMonitor che il file system sia montato correttamente.

ritorna
boolean

isNullDevice

public boolean isNullDevice (String serial)

Determina se il seriale indicato rappresenta un dispositivo nullo

Parametri
serial String

ritorna
boolean

killEmulator

public void killEmulator (ITestDevice device)

Arrestare l'emulatore fornito.

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

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

Lancia
DeviceNotAvailableException

launchEmulator

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

Metodo di supporto per avviare l'emulatore.

Lancerà l'emulatore come specificato dal chiamante

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

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

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

Lancia
DeviceNotAvailableException

listAllDevices

public  listAllDevices (boolean shortDescriptor)

Restituisce un elenco di DeviceDescriptors per tutti i dispositivi conosciuti

Parametri
shortDescriptor boolean : se limitare i descrittori alle informazioni minime

ritorna
un elenco di DeviceDescriptor per tutti i dispositivi conosciuti

listAllDevices

public  listAllDevices ()

Restituisce un elenco di DeviceDescriptors per tutti i dispositivi conosciuti

ritorna
un elenco di DeviceDescriptor per tutti i dispositivi conosciuti

ricollegareDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Un metodo di supporto che commuta il dispositivo USB fornito 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 il ITestDevice appena allocato in modalità TCP o null se non è stato possibile stabilire una connessione TCP

Lancia
DeviceNotAvailableException

rimuoviDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

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

Parametri
mon IDeviceMonitor

rimuovereFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informa il manager che un ascoltatore non è più interessato ai cambiamenti dello stato di avvio rapido.

riavviaAdbBridge

public void restartAdbBridge ()

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

stopAdbBridge

public void stopAdbBridge ()

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

terminare

public void terminate ()

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

Questo deve essere richiesto al momento della chiusura dell'applicazione.

terminateDeviceMonitor

public void terminateDeviceMonitor ()

Interrompere i monitoraggi del dispositivo.

terminateDeviceRecovery

public void terminateDeviceRecovery ()

Interrompe il thread di ripristino del dispositivo.

terminaHard

public void terminateHard (String reason)

Come terminateHard() .

Parametri
reason String : motivo facoltativo fornito per la terminazione.

terminaHard

public void terminateHard ()

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

waitForFirstDeviceAggiunto

public boolean waitForFirstDeviceAdded (long timeout)

Attendi fino al collegamento del primo dispositivo fisico. Se un dispositivo era 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