DeviceManager

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

Stringa di visualizzazione per le proprietà sconosciute

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

Costruttori pubblici

DeviceManager()

DeviceManager deve essere recuperato dal GlobalConfiguration

Metodi pubblici

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

Aggiunge un IDeviceMonitor

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

Informa il gestore che un ascoltatore è interessato alle modifiche dello stato di fastboot.

void addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)

Aggiungi un dispositivo al monitoraggio di Fastboot.

ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

Richiedi un dispositivo per i test che soddisfi determinati criteri.

ITestDevice allocateDevice(IDeviceSelection options)

Richiedi un dispositivo per i test che soddisfi determinati criteri.

ITestDevice allocateDevice()

Richiedere un dispositivo fisico per i test

ITestDevice connectToTcpDevice(String ipAndPort)

Connettiti a un dispositivo con adb-over-tcp

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

Il valore ITestDevice restituito sarà online, ma potrebbe non essere adattabile.

boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

Scollega un dispositivo connesso tramite adb-over-tcp.

void displayDevicesInfo(PrintWriter stream, boolean includeStub)

Mostra una descrizione facile da usare contenente l'elenco dei dispositivi noti, il loro stato e i valori per le opzioni IDeviceSelection di uso comune.

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 indirizzato a un determinato dispositivo, ad esempio

ITestDevice forceAllocateDevice(String serial)

Assegnare un dispositivo in modo sgarbato, anche se non è attualmente disponibile.

void freeDevice(ITestDevice device, FreeDeviceState deviceState)

Restituire un dispositivo al pool

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

String getAdbPath()

Restituisce il percorso del file adb binario da utilizzare.

String getAdbVersion()

Ottieni la versione di adb attualmente in uso dal gestore del dispositivo.

DeviceDescriptor getDeviceDescriptor(String serial)

Restituisce il DeviceDescriptor con il numero di serie specificato.

String getFastbootPath()

Restituisce il percorso del file binario fastboot da utilizzare.

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

Inizializza il gestore dei dispositivi.

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

Inizializza il gestore dei dispositivi.

void init()

Inizializza il gestore dei dispositivi.

boolean isEmulator(String serial)

Determina se il numero di serie specificato rappresenta un emulatore

boolean isFileSystemMountCheckEnabled()

Restituisce se dobbiamo o meno controllare in NativeDeviceStateMonitor se il file system è montato correttamente.

boolean isNullDevice(String serial)

Determina se il numero di serie specificato rappresenta un dispositivo null

void killEmulator(ITestDevice device)

Arresta l'emulatore specificato.

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

Metodo di assistenza per avviare l'emulatore.

listAllDevices(boolean shortDescriptor)

Restituisce un elenco di DeviceDescriptors per tutti i dispositivi noti

listAllDevices()

Restituisce un elenco di DeviceDescriptor per tutti i dispositivi noti

ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

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

void removeDeviceMonitor(IDeviceMonitor mon)

Rimuove un IDeviceMonitor aggiunto in precedenza.

void removeFastbootListener(IDeviceManager.IFastbootListener listener)

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

void restartAdbBridge()

Riavvia (se è stata chiamata stopAdbBridge()) il bridge adb e i servizi che dipendono dalle connessioni adb.

void stopAdbBridge()

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

void terminate()

Arresta i servizi di monitoraggio dei dispositivi e termina la libreria ddm.

void terminateDeviceMonitor()

Interrompi i monitor dei dispositivi.

void terminateDeviceRecovery()

Interrompe il thread di recupero del dispositivo.

void terminateHard(String reason)

Ad esempio terminateHard().

void terminateHard()

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

boolean waitForFirstDeviceAdded(long timeout)

Attendi che venga collegato un primo dispositivo fisico.

Campi

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Stringa di visualizzazione per le proprietà sconosciute

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

Costruttori pubblici

DeviceManager

public DeviceManager ()

DeviceManager deve essere recuperato dal GlobalConfiguration

Metodi pubblici

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

Parametri
stubDevice IDevice

addAvailableNativeDevice

public void addAvailableNativeDevice (IDevice stubDevice)

Parametri
stubDevice IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

Aggiunge un IDeviceMonitor

Parametri
mon IDeviceMonitor

addFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

Parametri
fastbootDevice DeviceManager.FastbootDevice

addFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

Informa il gestore che un ascoltatore è interessato alle modifiche dello stato di fastboot.

Attualmente, un IDeviceManager monitora i dispositivi in fastboot solo se sono presenti uno o più ascoltatori attivi.

DA FARE: questo è un po' un hack, trova una soluzione migliore

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Aggiungi un dispositivo al monitoraggio di 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 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: se è necessario creare o meno un NullDevice temporaneo.
Ritorni
ITestDevice un ITestDevice per i test o null se non è disponibile

allocateDevice

public 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 ITestDevice allocateDevice ()

Richiedere un dispositivo fisico per i test

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

connectToTcpDevice

public ITestDevice connectToTcpDevice (String ipAndPort)

Connettiti a un dispositivo con adb-over-tcp

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

Il valore ITestDevice restituito sarà online, ma potrebbe non essere adattabile.

Tieni presente che l'esecuzione di un'azione come un riavvio su un dispositivo connesso tramite TCP interrompe la connessione TCP al dispositivo e genera 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 creare una connessione TCP

disconnectFromTcpDevice

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Scollega un dispositivo connesso tramite adb-over-tcp.

Ripristina la modalità USB del dispositivo e lo libera.

Parametri
tcpDevice ITestDevice: il dispositivo attualmente in modalità TCP, precedentemente allocato tramite connectToTcpDevice(String)
Ritorni
boolean true se il passaggio alla modalità USB è andato a buon fine

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

Mostra una descrizione facile da usare contenente l'elenco dei dispositivi noti, il loro stato e i valori per le opzioni IDeviceSelection di uso comune.

Parametri
stream PrintWriter: il ERROR(/PrintWriter) a cui deve essere inviata la descrizione
includeStub boolean: indica se mostrare o meno anche i dispositivi stub.

executeCmdOnAvailableDevice

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 numero di serie del dispositivo.
command String: il comando shell.
timeout long: il tempo necessario per completare il comando.
timeUnit TimeUnit: l'unità di misura del timeout.
Ritorni
CommandResult A CommandResult.

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Esegui un comando adb non indirizzato a un determinato dispositivo, ad esempio "adb connect"

Ritorni
String Output standard se il comando ha esito positivo, nullo in caso contrario.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

Assegnare un dispositivo in modo sgarbato, anche se non è attualmente disponibile.

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

Parametri
serial String: il numero di serie del dispositivo da allocare
Ritorni
ITestDevice ITestDevice o null se non è stato possibile allocare

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Restituire un dispositivo al pool

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

Parametri
device ITestDevice: il ITestDevice da liberare
deviceState FreeDeviceState: il FreeDeviceState. Utilizzato per controllare se il dispositivo viene restituito al pool di dispositivi disponibili.

getAdbPath

public String getAdbPath ()

Restituisce il percorso del file adb binario da utilizzare.

Ritorni
String

getAdbVersion

public String getAdbVersion ()

Ottieni la versione di adb attualmente in uso dal gestore del dispositivo.

Ritorni
String

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

Restituisce il DeviceDescriptor con il numero di serie specificato.

Parametri
serial String: numero di serie del dispositivo da ricevere
Ritorni
DeviceDescriptor il DeviceDescriptor per il dispositivo selezionato o null se il numero di serie non corrisponde a un dispositivo noto.

getFastbootPath

public String getFastbootPath ()

Restituisce il percorso del file binario fastboot da utilizzare.

Ritorni
String

init

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

Inizializza il gestore dei dispositivi. Deve essere chiamato una sola volta prima che vengano chiamati altri metodi.

Parametri
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

init

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

Inizializza il gestore dei dispositivi. Deve essere chiamato una sola volta prima che vengano chiamati altri metodi.

Parametri
globalDeviceFilter IDeviceSelection: il filtro del dispositivo
globalDeviceMonitors

init

public void init ()

Inizializza il gestore dei dispositivi. Deve essere chiamato una sola volta prima che vengano chiamati altri metodi.

isEmulator

public boolean isEmulator (String serial)

Determina se il numero di serie specificato rappresenta un emulatore

Parametri
serial String

Ritorni
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Restituisce se dobbiamo o meno controllare in NativeDeviceStateMonitor se il file system è montato correttamente.

Ritorni
boolean

isNullDevice

public boolean isNullDevice (String serial)

Determina se il numero di serie specificato rappresenta un dispositivo null

Parametri
serial String

Ritorni
boolean

killEmulator

public 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: l'ITestDevice che rappresenta l'emulatore da arrestare
Lanci
DeviceNotAvailableException

launchEmulator

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

Metodo di assistenza 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

listAllDevices

public  listAllDevices (boolean shortDescriptor)

Restituisce un elenco di DeviceDescriptor per tutti i dispositivi noti

Parametri
shortDescriptor boolean: indica se limitare i descrittori alle informazioni minime
Ritorni
un elenco di DeviceDescriptor per tutti i dispositivi noti

listAllDevices

public  listAllDevices ()

Restituisce un elenco di DeviceDescriptor per tutti i dispositivi noti

Ritorni
un elenco di DeviceDescriptor per tutti i dispositivi noti

reconnectDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

Parametri
usbDevice ITestDevice: il dispositivo attualmente in modalità USB
Ritorni
ITestDevice il nuovo ITestDevice allocato in modalità TCP o null se non è stato possibile formare una connessione TCP
Lanci
DeviceNotAvailableException

removeDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

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

Parametri
mon IDeviceMonitor

removeFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

restartAdbBridge

public void restartAdbBridge ()

Riavvia (se è stata chiamata stopAdbBridge()) il bridge adb e i servizi che dipendono dalle connessioni adb.

stopAdbBridge

public void stopAdbBridge ()

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

terminare

public void terminate ()

Arresta i servizi di monitoraggio dei dispositivi e termina la libreria ddm.

Deve essere chiamato al termine dell'applicazione.

terminateDeviceMonitor

public void terminateDeviceMonitor ()

Interrompi i monitor dei dispositivi.

terminateDeviceRecovery

public void terminateDeviceRecovery ()

Interrompe il thread di recupero del dispositivo.

terminateHard

public void terminateHard (String reason)

Ad esempio terminateHard().

Parametri
reason String: motivo facoltativo della risoluzione.

terminateHard

public void terminateHard ()

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

waitForFirstDeviceAdded

public boolean waitForFirstDeviceAdded (long timeout)

Attendi che venga collegato un primo dispositivo fisico. Se un dispositivo è stato connesso in precedenza, viene restituito direttamente True. Se non è stato aggiunto alcun dispositivo, restituisce false dopo il timeout.

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