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. |
Costanti | |
|---|---|
String |
UNKNOWN_DISPLAY_STRING
Stringa di visualizzazione per le proprietà sconosciute |
Campi | |
|---|---|
protected
DeviceMonitorMultiplexer |
mDvcMon
|
protected
boolean |
mFastbootEnabled
|
Costruttori pubblici | |
|---|---|
DeviceManager()
DeviceManager deve essere recuperato da |
|
Metodi pubblici | |
|---|---|
void
|
addAvailableDevice(IDevice stubDevice)
|
void
|
addAvailableNativeDevice(IDevice stubDevice)
|
void
|
addDeviceMonitor(IDeviceMonitor mon)
Aggiunge un |
void
|
addFastbootDevice(DeviceManager.FastbootDevice fastbootDevice)
|
void
|
addFastbootListener(IDeviceManager.IFastbootListener listener)
Informa il gestore che un listener è interessato alle modifiche dello stato di fastboot. |
void
|
addMonitoringTcpFastbootDevice(String serial, String fastbootSerial)
Aggiungi un dispositivo al monitoraggio 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)
Connettersi a un dispositivo con adb-over-tcp
Questo metodo alloca un nuovo dispositivo, che alla fine dovrebbe essere liberato tramite
Il |
boolean
|
disconnectFromTcpDevice(ITestDevice tcpDevice)
Scollega un dispositivo connesso tramite adb-over-tcp. |
void
|
displayDevicesInfo(PrintWriter stream, boolean includeStub)
Restituisci una descrizione intuitiva contenente l'elenco dei dispositivi noti, il loro stato e i valori
per le opzioni |
CommandResult
|
executeCmdOnAvailableDevice(String serial, String command, long timeout, TimeUnit timeUnit)
Un metodo helper per eseguire il comando shell sul dispositivo disponibile. |
String
|
executeGlobalAdbCommand(String... cmdArgs)
Esegui un comando adb non destinato a un dispositivo specifico, ad es. |
ITestDevice
|
forceAllocateDevice(String serial)
Assegna forzatamente un dispositivo, 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 allocato in precedenza verranno ignorati. |
String
|
getAdbPath()
Restituisce il percorso del file binario adb da utilizzare. |
String
|
getAdbVersion()
Ottieni la versione di adb attualmente in uso da Device Manager. |
DeviceDescriptor
|
getDeviceDescriptor(String serial)
Restituisce DeviceDescriptor con il numero di serie specificato. |
String
|
getFastbootPath()
Restituisce il percorso del file binario fastboot da utilizzare. |
void
|
init(IDeviceSelection globalDeviceFilter,
Inizializza Device Manager. |
void
|
init(IDeviceSelection globalDeviceFilter,
Inizializza Device Manager. |
void
|
init()
Inizializza Device Manager. |
boolean
|
isEmulator(String serial)
Determinare se il numero di serie specificato rappresenta un emulatore |
boolean
|
isFileSystemMountCheckEnabled()
Restituisce un valore che indica se dobbiamo eseguire il check-in di |
boolean
|
isNullDevice(String serial)
Determina se il numero di serie specificato rappresenta un dispositivo nullo |
void
|
killEmulator(ITestDevice device)
Arresta l'emulatore specificato. |
void
|
launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil,
Metodo helper per avviare l'emulatore. |
|
listAllDevices(boolean shortDescriptor)
Restituisce un elenco di DeviceDescriptor per tutti i dispositivi noti |
|
listAllDevices()
Restituisce un elenco di DeviceDescriptor per tutti i dispositivi noti |
ITestDevice
|
reconnectDeviceToTcp(ITestDevice usbDevice)
Un metodo helper che passa il dispositivo USB specificato alla modalità adb-over-tcp e poi si connette
tramite |
void
|
removeDeviceMonitor(IDeviceMonitor mon)
Rimuove un |
void
|
removeFastbootListener(IDeviceManager.IFastbootListener listener)
Informa il gestore che un listener non è più interessato alle modifiche dello stato di fastboot. |
void
|
removeMonitoringTcpFastbootDevice(String serial)
|
void
|
restartAdbBridge()
Riavvia (se è stato chiamato |
void
|
stopAdbBridge()
Interrompi il bridge adb e i servizi dipendono dalle connessioni adb. |
void
|
terminate()
Interrompe i servizi di monitoraggio del dispositivo 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)
Come |
void
|
terminateHard()
Come |
boolean
|
waitForFirstDeviceAdded(long timeout)
Attendi che venga connesso un primo dispositivo fisico. |
Costanti
UNKNOWN_DISPLAY_STRING
public static final String UNKNOWN_DISPLAY_STRING
Stringa di visualizzazione per le proprietà sconosciute
Constant Value: "unknown"
Campi
mFastbootEnabled
protected boolean mFastbootEnabled
Costruttori pubblici
Metodi pubblici
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 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 void addMonitoringTcpFastbootDevice (String serial,
String fastbootSerial)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. |
fastbootSerial |
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: indica se creare o meno un dispositivo 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)
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 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 void displayDevicesInfo (PrintWriter stream,
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 | |
|---|---|
stream |
PrintWriter: il ERROR(/PrintWriter) in cui restituire la descrizione |
includeStub |
boolean: Indica se visualizzare anche i dispositivi stub. |
executeCmdOnAvailableDevice
public 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. |
executeGlobalAdbCommand
public String executeGlobalAdbCommand (String... cmdArgs)
Esegui un comando adb non destinato a un dispositivo specifico, ad es. 'adb connect'
| Ritorni | |
|---|---|
String |
std output if the command succeedm null otherwise. |
forceAllocateDevice
public 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 void freeDevice (ITestDevice device, FreeDeviceState deviceState)
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 |
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 binario adb da utilizzare.
| Ritorni | |
|---|---|
String |
|
getAdbVersion
public String getAdbVersion ()
Ottieni la versione di adb attualmente in uso da Device Manager.
| Ritorni | |
|---|---|
String |
|
getDeviceDescriptor
public 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 String getFastbootPath ()
Restituisce il percorso del file binario fastboot da utilizzare.
| Ritorni | |
|---|---|
String |
|
init
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)
Inizializza Device Manager. Questo metodo deve essere chiamato una sola volta prima di qualsiasi altro metodo.
| Parametri | |
|---|---|
globalDeviceFilter |
IDeviceSelection |
globalDeviceMonitors |
|
deviceFactory |
IManagedTestDeviceFactory |
init
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors)
Inizializza Device Manager. Questo metodo deve essere chiamato una sola volta prima di qualsiasi altro metodo.
| Parametri | |
|---|---|
globalDeviceFilter |
IDeviceSelection: il filtro del dispositivo |
globalDeviceMonitors |
|
init
public void init ()
Inizializza Device Manager. Questo metodo deve essere chiamato una sola volta prima di qualsiasi altro metodo.
isEmulator
public 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 boolean isNullDevice (String serial)
Determina se il numero di serie specificato rappresenta un dispositivo nullo
| 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: il ITestDevice che rappresenta l'emulatore da arrestare |
| Lanci | |
|---|---|
DeviceNotAvailableException |
|
launchEmulator
public 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 |
|
listAllDevices
publiclistAllDevices (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
publiclistAllDevices ()
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 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 |
|
removeDeviceMonitor
public void removeDeviceMonitor (IDeviceMonitor mon)
Rimuove un IDeviceMonitor aggiunto in precedenza. Non ha effetto se non è stato aggiunto un monitor.
| Parametri | |
|---|---|
mon |
IDeviceMonitor |
removeFastbootListener
public 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 void restartAdbBridge ()
Riavvia (se è stato chiamato stopAdbBridge()) il bridge e i servizi adb dipendono dalle connessioni adb.
stopAdbBridge
public void stopAdbBridge ()
Interrompi il bridge adb e i servizi dipendono dalle connessioni adb.
terminare
public void terminate ()
Interrompe i servizi di monitoraggio del dispositivo 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)
Come terminateHard().
| Parametri | |
|---|---|
reason |
String: motivo facoltativo fornito per la chiusura. |
terminateHard
public void terminateHard ()
Come terminate(), ma tenta anche di arrestare forzatamente adb.
waitForFirstDeviceAdded
public 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 |
|