IDDevice Manager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Sottoclassi indirette conosciute Gestore dispositivi Gestore dispositivi

---

Interfaccia per la gestione dell'insieme dei dispositivi disponibili per il test.

Riepilogo

Classi nidificate
interface	IDeviceManager.IFastbootListener Un listener per le modifiche allo stato di avvio rapido.

Metodi pubblici
abstract void	addDeviceMonitor ( IDeviceMonitor mon) Aggiunge un IDeviceMonitor
abstract void	addFastbootListener ( IDeviceManager.IFastbootListener listener) Informa il manager che un listener è interessato alle modifiche allo stato di avvio rapido.
abstract void	addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) Aggiungi un dispositivo al monitoraggio di avvio rapido.
abstract ITestDevice	allocateDevice ( IDeviceSelection options, boolean isTemporary) Richiedi un dispositivo per il test che soddisfi determinati criteri.
abstract ITestDevice	allocateDevice ( IDeviceSelection options) Richiedi un dispositivo per il test che soddisfi determinati criteri.
abstract ITestDevice	allocateDevice () Richiedi un dispositivo fisico per il test
abstract ITestDevice	connectToTcpDevice (String ipAndPort) Connettiti a un dispositivo con adb-over-tcp Questo metodo assegna un nuovo dispositivo, che dovrebbe eventualmente essere liberato tramite disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) L' ITestDevice restituito sarà online, ma potrebbe non essere reattivo.
abstract boolean	disconnectFromTcpDevice ( ITestDevice tcpDevice) Disconnetti da un dispositivo connesso adb-over-tcp.
abstract void	displayDevicesInfo (PrintWriter printWriter, boolean includeStub) Genera una descrizione intuitiva 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 della shell sul dispositivo disponibile.
abstract ITestDevice	forceAllocateDevice (String serial) Assegna in modo scortese un dispositivo, anche se non è attualmente disponibile.
abstract void	freeDevice ( ITestDevice device, FreeDeviceState state) Restituire un dispositivo alla piscina I tentativi di restituire un dispositivo che non è stato precedentemente allocato verranno ignorati.
abstract String	getAdbPath () Restituisce il percorso del binario adb da utilizzare.
abstract String	getAdbVersion () Ottieni la versione adb attualmente in uso da Gestione dispositivi.
abstract DeviceDescriptor	getDeviceDescriptor (String serial) Restituisce DeviceDescriptor con il seriale specificato.
abstract String	getFastbootPath () Restituisce il percorso del binario di avvio rapido da utilizzare.
abstract void	init ( IDeviceSelection globalDeviceFilter, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, deviceMonitors) Inizializza Gestione dispositivi con un filtro dispositivo.
abstract void	init () Inizializza Gestione dispositivi.
abstract boolean	isEmulator (String serial) Determina se un dato seriale rappresenta un emulatore
default boolean	isFileSystemMountCheckEnabled () Restituisce se dobbiamo controllare o meno in NativeDeviceStateMonitor che il file system sia montato correttamente.
abstract boolean	isNullDevice (String serial) Determina se il numero di serie fornito rappresenta un dispositivo nullo
abstract void	killEmulator ( ITestDevice device) Spegni l'emulatore specificato.
abstract void	launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) Metodo di supporto per avviare l'emulatore.
abstract	listAllDevices (boolean shortDescriptor) Restituisce un elenco di DeviceDescriptor per tutti i dispositivi conosciuti
abstract	listAllDevices () Restituisce un elenco di DeviceDescriptor per tutti i dispositivi conosciuti
abstract 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) .
abstract void	removeDeviceMonitor ( IDeviceMonitor mon) Rimuove un IDeviceMonitor precedentemente aggiunto.
abstract void	removeFastbootListener ( IDeviceManager.IFastbootListener listener) Informa il manager che un listener non è più interessato alle modifiche allo stato di avvio rapido.
abstract void	restartAdbBridge () Riavvia (se è stato chiamato stopAdbBridge() ) adb bridge e servizi dipendono dalle connessioni adb.
abstract void	stopAdbBridge () Arresta il bridge adb e i servizi dipendono dalle connessioni adb.
abstract void	terminate () Arresta i servizi di monitoraggio del dispositivo e termina la libreria ddm.
abstract void	terminateDeviceMonitor () Arresta i monitor del dispositivo.
abstract void	terminateDeviceRecovery () Arresta il thread di ripristino del dispositivo.
default void	terminateHard (String reason) Come terminateHard() .
abstract void	terminateHard () Come terminate() , ma tenta anche di chiudere forzatamente adb.
abstract boolean	waitForFirstDeviceAdded (long timeout) Attendi fino a quando non viene 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 manager che un listener è interessato alle modifiche allo stato di avvio rapido.

Attualmente un IDeviceManager monitorerà i dispositivi in ​​avvio rapido solo se sono presenti uno o più listener attivi.

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

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Aggiungi un dispositivo al monitoraggio 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 : il numero di serie della modalità di avvio rapido del dispositivo.

allocateDevice

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

allocateDevice

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

allocateDevice

public abstract ITestDevice allocateDevice ()

Richiedi un dispositivo fisico per il test

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

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Connettiti a un dispositivo con adb-over-tcp

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

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

Si noti che l'esecuzione di azioni come un riavvio su un dispositivo connesso a TCP interromperà la connessione TCP al dispositivo e risulterà in 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 creare una connessione TCP

DisconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Disconnetti 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 abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

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

Parametri
printWriter	PrintWriter : ERROR(/PrintWriter) a cui inviare la descrizione
includeStub	boolean : se visualizzare 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 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 risultato di CommandResult .

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Assegna in modo scortese un dispositivo, anche se non è attualmente disponibile.

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

Parametri
serial	String : il seriale del dispositivo da allocare

ritorna
ITestDevice	ITestDevice o null se non è stato possibile allocare

dispositivo gratuito

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Restituire un dispositivo alla piscina

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

Parametri
device	ITestDevice : l' ITestDevice per liberare
state	FreeDeviceState : il FreeDeviceState . Utilizzato per controllare se il dispositivo viene restituito al pool di dispositivi disponibile.

getAdbPath

public abstract String getAdbPath ()

Restituisce il percorso del binario adb da utilizzare.

ritorna
String

getAdbVersion

public abstract String getAdbVersion ()

Ottieni la versione adb attualmente in uso da Gestione dispositivi.

ritorna
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

Restituisce DeviceDescriptor con il seriale specificato.

Parametri
serial	String : numero di serie che il dispositivo deve ottenere

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

getFastbootPath

public abstract String getFastbootPath ()

Restituisce il percorso del binario di avvio rapido da utilizzare.

ritorna
String

dentro

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Inizializza Gestione dispositivi con un filtro dispositivo. Questo filtro può essere utilizzato per indicare a DeviceManager di ignorare determinati dispositivi collegati.

Parametri
globalDeviceFilter	IDeviceSelection : il filtro del dispositivo
deviceMonitors

dentro

public abstract void init ()

Inizializza Gestione dispositivi. Questo deve essere chiamato una volta e solo una volta prima di chiamare qualsiasi altro metodo.

isEmulator

public abstract boolean isEmulator (String serial)

Determina se un dato seriale rappresenta un emulatore

Parametri
serial	String

ritorna
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

ritorna
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

Determina se il numero di serie fornito rappresenta un dispositivo nullo

Parametri
serial	String

ritorna
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

Spegni l'emulatore specificato.

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 spegnere

Tiri
DeviceNotAvailableException	se l'emulatore non si spegne

launchEmulator

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

Tiri
DeviceNotAvailableException	se l'emulatore non si avvia o non è online

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

Restituisce un elenco di DeviceDescriptor per tutti i dispositivi conosciuti

Parametri
shortDescriptor	boolean : se limitare i descrittori a informazioni minime

ritorna
	un elenco di DeviceDescriptor per tutti i dispositivi conosciuti

listAllDevices

public abstract  listAllDevices ()

Restituisce un elenco di DeviceDescriptor per tutti i dispositivi conosciuti

ritorna
	un elenco di DeviceDescriptor per tutti i dispositivi conosciuti

riconnettiDeviceToTcp

public abstract 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	il nuovo ITestDevice allocato in modalità TCP o null se non è stato possibile creare una connessione TCP

Tiri
DeviceNotAvailableException	se la connessione con usbDevice è stata persa e non è stato possibile ripristinarla

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

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

Parametri
mon	IDeviceMonitor

rimuovi FastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informa il manager che un listener non è più interessato alle modifiche allo stato di avvio rapido.

riavviaAdbBridge

public abstract void restartAdbBridge ()

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

stopAdbBridge

public abstract void stopAdbBridge ()

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

terminare

public abstract void terminate ()

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

Questo deve essere richiamato al termine dell'applicazione.

Guarda anche:

• AndroidDebugBridge.terminate()

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

Arresta i monitor del dispositivo.

terminateDeviceRecovery

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

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

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Attendi fino a quando non viene collegato un primo dispositivo fisico. Se un dispositivo è stato collegato 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