IDeviceManager
public
interface
IDeviceManager
| com.android.tradefed.device.IDeviceManager |
Interfaccia per la gestione del set di dispositivi disponibili per i test.
Riepilogo
Classi nidificate | |
|---|---|
interface |
IDeviceManager.IFastbootListener
Un listener per le modifiche dello stato di fastboot. |
Metodi pubblici | |
|---|---|
abstract
void
|
addDeviceMonitor(IDeviceMonitor mon)
Aggiunge un |
abstract
void
|
addFastbootListener(IDeviceManager.IFastbootListener listener)
Informa il gestore che un listener è interessato alle modifiche dello stato di fastboot. |
abstract
void
|
addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)
Aggiungi un dispositivo al monitoraggio 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)
Connettersi a un dispositivo con adb-over-tcp
Questo metodo alloca un nuovo dispositivo, che alla fine dovrebbe essere liberato tramite
Il |
abstract
boolean
|
disconnectFromTcpDevice(ITestDevice tcpDevice)
Scollega un dispositivo connesso tramite adb-over-tcp. |
abstract
void
|
displayDevicesInfo(PrintWriter printWriter, boolean includeStub)
Restituisci una descrizione intuitiva contenente l'elenco dei dispositivi noti, il loro stato e i valori
per le opzioni |
abstract
CommandResult
|
executeCmdOnAvailableDevice(String serial, String command, long timeout, TimeUnit timeUnit)
Un metodo helper per eseguire il comando shell sul dispositivo disponibile. |
abstract
ITestDevice
|
forceAllocateDevice(String serial)
Assegna forzatamente un dispositivo, 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 allocato in precedenza verranno ignorati. |
abstract
String
|
getAdbPath()
Restituisce il percorso del file binario adb da utilizzare. |
abstract
String
|
getAdbVersion()
Ottieni la versione di adb attualmente in uso da Device Manager. |
abstract
DeviceDescriptor
|
getDeviceDescriptor(String serial)
Restituisce DeviceDescriptor con il numero di serie specificato. |
abstract
String
|
getFastbootPath()
Restituisce il percorso del file binario fastboot da utilizzare. |
abstract
void
|
init(IDeviceSelection globalDeviceFilter,
Inizializza il gestore dei dispositivi con un filtro per i dispositivi. |
abstract
void
|
init()
Inizializza Device Manager. |
abstract
boolean
|
isEmulator(String serial)
Determinare se il numero di serie specificato rappresenta un emulatore |
default
boolean
|
isFileSystemMountCheckEnabled()
Restituisce un valore che indica se dobbiamo eseguire il check-in di |
abstract
boolean
|
isNullDevice(String serial)
Determina se il numero di serie specificato rappresenta un dispositivo nullo |
abstract
void
|
killEmulator(ITestDevice device)
Arresta l'emulatore specificato. |
abstract
void
|
launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil,
Metodo helper per avviare l'emulatore. |
abstract
|
listAllDevices(boolean shortDescriptor)
Restituisce un elenco di DeviceDescriptor per tutti i dispositivi noti |
abstract
|
listAllDevices()
Restituisce un elenco di DeviceDescriptor per tutti i dispositivi noti |
abstract
ITestDevice
|
reconnectDeviceToTcp(ITestDevice usbDevice)
Un metodo helper che passa il dispositivo USB specificato alla modalità adb-over-tcp e poi si connette
tramite |
abstract
void
|
removeDeviceMonitor(IDeviceMonitor mon)
Rimuove un |
abstract
void
|
removeFastbootListener(IDeviceManager.IFastbootListener listener)
Informa il gestore che un listener non è più interessato alle modifiche dello stato di fastboot. |
default
void
|
removeMonitoringTcpFastbootDevice(String serial)
|
abstract
void
|
restartAdbBridge()
Riavvia (se è stato chiamato |
abstract
void
|
stopAdbBridge()
Interrompi il bridge adb e i servizi dipendono dalle connessioni adb. |
abstract
void
|
terminate()
Interrompe i servizi di monitoraggio del dispositivo 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)
Come |
abstract
void
|
terminateHard()
Come |
abstract
boolean
|
waitForFirstDeviceAdded(long timeout)
Attendi che venga connesso 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 listener è interessato alle modifiche dello stato di fastboot.
Al momento, un IDeviceManager monitorerà i dispositivi in modalità fastboot solo se sono presenti uno o
più listener attivi.
TODO: this is a bit of a hack - find a better solution
addMonitoringTcpFastbootDevice
public abstract void addMonitoringTcpFastbootDevice (String serial,
String fastboot_serial)Aggiungi un dispositivo al monitoraggio 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: indica se creare o meno un dispositivo 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)
Connettersi 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)
Il ITestDevice restituito sarà online, ma potrebbe non rispondere.
Tieni presente che l'esecuzione di un'azione come il riavvio su un dispositivo connesso tramite TCP interromperà la
connessione TCP al dispositivo e genererà 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 stabilire una connessione TCP |
disconnectFromTcpDevice
public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)
Scollega un dispositivo connesso tramite adb-over-tcp.
Riporta il dispositivo in modalità USB e lo libera.
| Parametri | |
|---|---|
tcpDevice |
ITestDevice: il dispositivo attualmente in modalità TCP, allocato in precedenza tramite
connectToTcpDevice(String) |
| Ritorni | |
|---|---|
boolean |
true se il passaggio alla modalità USB è riuscito |
displayDevicesInfo
public abstract void displayDevicesInfo (PrintWriter printWriter,
boolean includeStub)Restituisci una descrizione intuitiva contenente l'elenco dei dispositivi noti, il loro stato e i valori
per le opzioni IDeviceSelection utilizzate di frequente.
| Parametri | |
|---|---|
printWriter |
PrintWriter: il ERROR(/PrintWriter) in cui restituire la descrizione |
includeStub |
boolean: Indica se visualizzare anche i dispositivi stub. |
executeCmdOnAvailableDevice
public abstract CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)
Un metodo helper 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à per il timeout. |
| Ritorni | |
|---|---|
CommandResult |
A CommandResult. |
forceAllocateDevice
public abstract ITestDevice forceAllocateDevice (String serial)
Assegna forzatamente un dispositivo, anche se non è attualmente disponibile.
Non avrà alcun effetto se il dispositivo è già assegnato.
| Parametri | |
|---|---|
serial |
String: il numero di serie del dispositivo da allocare |
| Ritorni | |
|---|---|
ITestDevice |
ITestDevice o null se non è stato possibile allocarlo |
freeDevice
public abstract void freeDevice (ITestDevice device, FreeDeviceState state)
Restituire un dispositivo al pool
I tentativi di restituire un dispositivo che non è stato allocato in precedenza verranno ignorati.
| Parametri | |
|---|---|
device |
ITestDevice: il ITestDevice senza costi |
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 binario adb da utilizzare.
| Ritorni | |
|---|---|
String |
|
getAdbVersion
public abstract String getAdbVersion ()
Ottieni la versione di adb attualmente in uso da Device Manager.
| Ritorni | |
|---|---|
String |
|
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (String serial)
Restituisce DeviceDescriptor con il numero di serie specificato.
| Parametri | |
|---|---|
serial |
String: il numero di serie del dispositivo da recuperare |
| Ritorni | |
|---|---|
DeviceDescriptor |
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 Device Manager. Questo metodo deve essere chiamato una sola volta prima di qualsiasi altro metodo.
isEmulator
public abstract boolean isEmulator (String serial)
Determinare se il numero di serie specificato rappresenta un emulatore
| Parametri | |
|---|---|
serial |
String |
| Ritorni | |
|---|---|
boolean |
|
isFileSystemMountCheckEnabled
public boolean isFileSystemMountCheckEnabled ()
Restituisce un valore che indica se dobbiamo eseguire il check-in di NativeDeviceStateMonitor il file system è
montato correttamente.
| Ritorni | |
|---|---|
boolean |
|
isNullDevice
public abstract boolean isNullDevice (String serial)
Determina se il numero di serie specificato rappresenta un dispositivo nullo
| 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: il ITestDevice che rappresenta l'emulatore da arrestare |
| Lanci | |
|---|---|
DeviceNotAvailableException |
se l'emulatore non si chiude |
launchEmulator
public abstract void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil,emulatorArgs)
Metodo helper 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 si avvia o non si connette a internet |
listAllDevices
public abstractlistAllDevices (boolean shortDescriptor)
Restituisce un elenco di DeviceDescriptor per tutti i dispositivi noti
| Parametri | |
|---|---|
shortDescriptor |
boolean: se limitare i descrittori alle informazioni minime |
| Ritorni | |
|---|---|
|
un elenco di DeviceDescriptor per tutti i dispositivi noti |
listAllDevices
public abstractlistAllDevices ()
Restituisce un elenco di DeviceDescriptor per tutti i dispositivi noti
| Ritorni | |
|---|---|
|
un elenco di DeviceDescriptor per tutti i dispositivi noti |
reconnectDeviceToTcp
public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)
Un metodo helper che passa il dispositivo USB specificato alla modalità adb-over-tcp e poi si connette
tramite connectToTcpDevice(String).
| Parametri | |
|---|---|
usbDevice |
ITestDevice: il dispositivo attualmente in modalità USB |
| Ritorni | |
|---|---|
ITestDevice |
ITestDevice appena allocato in modalità TCP o null se non è stato possibile stabilire una connessione TCP |
| Lanci | |
|---|---|
DeviceNotAvailableException |
se la connessione con usbDevice è stata interrotta e non è stato possibile recuperarla |
removeDeviceMonitor
public abstract void removeDeviceMonitor (IDeviceMonitor mon)
Rimuove un IDeviceMonitor aggiunto in precedenza. Non ha effetto se non è stato aggiunto un monitor.
| Parametri | |
|---|---|
mon |
IDeviceMonitor |
removeFastbootListener
public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)
Informa il gestore che un listener non è più interessato alle modifiche dello stato di fastboot.
removeMonitoringTcpFastbootDevice
public void removeMonitoringTcpFastbootDevice (String serial)
| Parametri | |
|---|---|
serial |
String |
restartAdbBridge
public abstract void restartAdbBridge ()
Riavvia (se è stato chiamato stopAdbBridge()) il bridge e i servizi adb dipendono dalle connessioni adb.
stopAdbBridge
public abstract void stopAdbBridge ()
Interrompi il bridge adb e i servizi dipendono dalle connessioni adb.
terminare
public abstract void terminate ()
Interrompe i servizi di monitoraggio del dispositivo e termina la libreria ddm.
Deve essere chiamato al termine dell'applicazione.
Vedi anche:
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)
Come terminateHard().
| Parametri | |
|---|---|
reason |
String: motivo facoltativo fornito per la chiusura. |
terminateHard
public abstract void terminateHard ()
Come terminate(), ma tenta anche di arrestare forzatamente adb.
waitForFirstDeviceAdded
public abstract boolean waitForFirstDeviceAdded (long timeout)
Attendi che venga 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. |
| Ritorni | |
|---|---|
boolean |
|