IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Classi di sottoclasse indirette note DeviceManager DeviceManager

---

Interfaccia per la gestione dell'insieme di dispositivi disponibili per i test.

Riepilogo

Classi nidificate
interface	IDeviceManager.IFastbootListener Un ascoltatore 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 ascoltatore è interessato alle modifiche dello stato di fastboot.
abstract void	addMonitoringTcpFastbootDevice(String serial, String fastboot_serial) Aggiungi un dispositivo al monitoraggio di 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) 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.
abstract boolean	disconnectFromTcpDevice(ITestDevice tcpDevice) Scollega un dispositivo connesso tramite adb-over-tcp.
abstract void	displayDevicesInfo(PrintWriter printWriter, 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.
abstract CommandResult	executeCmdOnAvailableDevice(String serial, String command, long timeout, TimeUnit timeUnit) Un metodo di supporto per eseguire il comando shell sul dispositivo disponibile.
abstract ITestDevice	forceAllocateDevice(String serial) Assegnare un dispositivo in modo sgarbato, 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 precedentemente allocato verranno ignorati.
abstract String	getAdbPath() Restituisce il percorso del file adb binario da utilizzare.
abstract String	getAdbVersion() Ottieni la versione di adb attualmente in uso dal gestore del dispositivo.
abstract DeviceDescriptor	getDeviceDescriptor(String serial) Restituisce il 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 dei dispositivi.
abstract void	init() Inizializza il gestore dei dispositivi.
abstract boolean	isEmulator(String serial) Determina se il numero di serie specificato rappresenta un emulatore
default boolean	isFileSystemMountCheckEnabled() Restituisce se dobbiamo o meno controllare in NativeDeviceStateMonitor se il file system è montato correttamente.
abstract boolean	isNullDevice(String serial) Determina se il numero di serie specificato rappresenta un dispositivo null
abstract void	killEmulator(ITestDevice device) Arresta l'emulatore specificato.
abstract void	launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) Metodo di assistenza 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 imposta il dispositivo USB specificato in 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 ascoltatore non è più interessato alle modifiche dello stato di fastboot.
abstract void	restartAdbBridge() Riavvia (se è stata chiamata stopAdbBridge()) il bridge adb e i servizi che dipendono dalle connessioni adb.
abstract void	stopAdbBridge() Interrompi il bridge adb e i servizi che dipendono dalle connessioni adb.
abstract void	terminate() Arresta i servizi di monitoraggio dei dispositivi 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) Ad esempio terminateHard().
abstract void	terminateHard() Come terminate(), ma tenta di arrestare forzatamente anche adb.
abstract boolean	waitForFirstDeviceAdded(long timeout) Attendi che venga collegato 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 ascoltatore è interessato alle modifiche dello stato di fastboot.

Al momento, 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 abstract 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 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: se è necessario creare o meno un 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)

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 abstract 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 abstract void displayDevicesInfo (PrintWriter printWriter, 
                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
printWriter	PrintWriter: il ERROR(/PrintWriter) a cui deve essere inviata la descrizione
includeStub	boolean: indica se mostrare 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 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.

forceAllocateDevice

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

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

Ritorni
String

getAdbVersion

public abstract String getAdbVersion ()

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

Ritorni
String

getDeviceDescriptor

public abstract 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 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 il gestore dei dispositivi. Deve essere chiamato una sola volta prima che vengano chiamati altri metodi.

isEmulator

public abstract 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 abstract boolean isNullDevice (String serial)

Determina se il numero di serie specificato rappresenta un dispositivo null

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

Lanci
DeviceNotAvailableException	if emulator fails to shut down

launchEmulator

public abstract 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	Se l'emulatore non riesce ad avviarsi o a essere online

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

Restituisce un elenco di DeviceDescriptors 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 abstract  listAllDevices ()

Restituisce un elenco di DeviceDescriptors per tutti i dispositivi noti

Ritorni
	un elenco di DeviceDescriptor per tutti i dispositivi noti

reconnectDeviceToTcp

public abstract 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	se la connessione con usbDevice si è interrotta e non è stato possibile recuperarla

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

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

Parametri
mon	IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

restartAdbBridge

public abstract void restartAdbBridge ()

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

stopAdbBridge

public abstract void stopAdbBridge ()

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

terminare

public abstract void terminate ()

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

Deve essere chiamato al termine dell'applicazione.

Vedi anche:

• AndroidDebugBridge.terminate()

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)

Ad esempio terminateHard().

Parametri
reason	String: motivo facoltativo della risoluzione.

terminateHard

public abstract void terminateHard ()

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

waitForFirstDeviceAdded

public abstract 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