Gestore dispositivi

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Oggetto
↳	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 dal 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 gestore che un listener è interessato alle modifiche allo stato di avvio rapido.
void	addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) Aggiungi un dispositivo al monitor fastboot.
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 alla fine dovrebbe 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) Restituisce una descrizione intuitiva contenente un elenco di dispositivi noti, il relativo 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 della shell sul dispositivo disponibile.
String	executeGlobalAdbCommand (String... cmdArgs) Esegui un comando adb non mirato a un particolare dispositivo, ad es.
ITestDevice	forceAllocateDevice (String serial) Assegnare bruscamente un dispositivo, anche se non è attualmente disponibile.
void	freeDevice ( ITestDevice device, FreeDeviceState deviceState) Restituisci un dispositivo al pool I tentativi di restituzione di un dispositivo che non è stato assegnato in precedenza verranno ignorati.
String	getAdbPath () Restituisce il percorso del binario adb da utilizzare.
String	getAdbVersion () Ottieni la versione adb attualmente in uso dal gestore dispositivi.
DeviceDescriptor	getDeviceDescriptor (String serial) Restituisce il DeviceDescriptor con il dato seriale.
String	getFastbootPath () Restituisce il percorso del file binario fastboot da utilizzare.
void	init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) Inizializza il gestore dispositivi.
void	init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) Inizializza il gestore dispositivi.
void	init () Inizializza il gestore dispositivi.
boolean	isEmulator (String serial) Determina se dato seriale rappresenta un emulatore
boolean	isFileSystemMountCheckEnabled () Restituisce se è necessario verificare o meno in NativeDeviceStateMonitor che il file system sia montato correttamente.
boolean	isNullDevice (String serial) Determina se dato seriale rappresenta un dispositivo nullo
void	killEmulator ( ITestDevice device) Arrestare l'emulatore dato.
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 noti
	listAllDevices () Restituisce un elenco di DeviceDescriptors per tutti i dispositivi noti
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) .
void	removeDeviceMonitor ( IDeviceMonitor mon) Rimuove un IDeviceMonitor aggiunto in precedenza.
void	removeFastbootListener ( IDeviceManager.IFastbootListener listener) Informa il gestore che un listener non è più interessato alle modifiche allo 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 adb e i servizi dipendono dalle connessioni adb.
void	terminate () Arresta i servizi di monitoraggio del dispositivo e termina la libreria ddm.
void	terminateDeviceMonitor () Arrestare i monitor del dispositivo.
void	terminateDeviceRecovery () Arresta 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) Attendere finché non viene connesso un primo dispositivo fisico.

Campi

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Visualizza la stringa per le proprietà sconosciute

mDvcLun

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

Costruttori pubblici

Gestore dispositivi

public DeviceManager ()

Il DeviceManager dovrebbe essere recuperato dal GlobalConfiguration

Metodi pubblici

addAvailableDevice

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

Richiedi un dispositivo fisico per il test

ritorna
ITestDevice	un ITestDevice per il 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 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 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 void displayDevicesInfo (PrintWriter stream, 
                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
stream	PrintWriter : l' ERROR(/PrintWriter) a cui inviare la descrizione
includeStub	boolean : se visualizzare 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 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 .

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

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

ritorna
String	output std se il comando riesce null altrimenti.

forceAllocateDevice

public 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 void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

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

ritorna
String

getAdbVersion

public String getAdbVersion ()

Ottieni la versione adb attualmente in uso dal gestore dispositivi.

ritorna
String

getDeviceDescriptor

public 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 String getFastbootPath ()

Restituisce il percorso del file binario fastboot da utilizzare.

ritorna
String

dentro

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

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

Parametri
globalDeviceFilter	IDeviceSelection
globalDeviceMonitors
deviceFactory	IManagedTestDeviceFactory

dentro

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

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

Parametri
globalDeviceFilter	IDeviceSelection : il filtro del dispositivo
globalDeviceMonitors

dentro

public void init ()

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

isEmulator

public boolean isEmulator (String serial)

Determina se dato seriale rappresenta un emulatore

Parametri
serial	String

ritorna
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

ritorna
boolean

isNullDevice

public boolean isNullDevice (String serial)

Determina se dato seriale rappresenta un dispositivo nullo

Parametri
serial	String

ritorna
boolean

killEmulatore

public void killEmulator (ITestDevice device)

Arrestare l'emulatore dato.

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

launchEmulator

public 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

listTutti i dispositivi

public  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  listAllDevices ()

Restituisce un elenco di DeviceDescriptors per tutti i dispositivi noti

ritorna
	un elenco di DeviceDescriptor per tutti i dispositivi conosciuti

reconnectDeviceToTcp

public 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

removeDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

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

Parametri
mon	IDeviceMonitor

rimuovereFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informa il gestore che un listener non è più interessato alle modifiche allo 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 adb e i servizi dipendono dalle connessioni adb.

terminare

public void terminate ()

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

Questo deve essere chiamato alla chiusura della domanda.

terminateDeviceMonitor

public void terminateDeviceMonitor ()

Arrestare i monitor del dispositivo.

terminateDeviceRecovery

public 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 void terminateHard ()

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

waitForFirstDeviceAdded

public 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