Gestione dispositivi
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 Fastboot mode. |
Campi | |
---|---|
public
static
final
String |
UNKNOWN_DISPLAY_STRING
Stringa visualizzata per proprietà sconosciute |
protected
DeviceMonitorMultiplexer |
mDvcMon
|
protected
boolean |
mFastbootEnabled
|
Costruttori pubblici | |
---|---|
DeviceManager()
È necessario recuperare DeviceManager da |
Metodi pubblici | |
---|---|
void
|
addAvailableDevice(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 fastboot. |
void
|
addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)
Aggiungi un dispositivo a fastboot monitor. |
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 i 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
L'oggetto |
boolean
|
disconnectFromTcpDevice(ITestDevice tcpDevice)
Disconnettiti da un dispositivo connesso adb-over-tcp. |
void
|
displayDevicesInfo(PrintWriter stream, boolean includeStub)
Genera una descrizione facile da usare 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)
Eseguire un comando adb non indirizzato a un particolare dispositivo, ad es. |
ITestDevice
|
forceAllocateDevice(String serial)
Alloca un dispositivo in modo scortese, anche se al momento non è disponibile. |
void
|
freeDevice(ITestDevice device, FreeDeviceState deviceState)
Restituire un dispositivo nel pool I tentativi di restituire un dispositivo che non è stato allocato in precedenza verranno ignorati. |
String
|
getAdbPath()
Restituisce il percorso del programma binario adb da utilizzare. |
String
|
getAdbVersion()
Ottieni la versione adb attualmente in uso da parte del gestore dispositivi. |
DeviceDescriptor
|
getDeviceDescriptor(String serial)
Restituisce il valore DeviceDescriptor con il numero di serie specificato. |
String
|
getFastbootPath()
Restituisce il percorso del programma binario fastboot da utilizzare. |
void
|
init(IDeviceSelection globalDeviceFilter,
Inizializza Gestione dispositivi. |
void
|
init(IDeviceSelection globalDeviceFilter,
Inizializza Gestione dispositivi. |
void
|
init()
Inizializza Gestione dispositivi. |
boolean
|
isEmulator(String serial)
Determinare se la serie fornita rappresenta un emulatore |
boolean
|
isFileSystemMountCheckEnabled()
Restituisce se dobbiamo controllare o meno |
boolean
|
isNullDevice(String serial)
Determinare se il numero seriale rappresenta un dispositivo nullo |
void
|
killEmulator(ITestDevice device)
Arresta l'emulatore specificato. |
void
|
launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil,
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 helper che commuta il dispositivo USB in modalità adb-over-tcp e poi si connette a
tramite |
void
|
removeDeviceMonitor(IDeviceMonitor mon)
Rimuove un elemento |
void
|
removeFastbootListener(IDeviceManager.IFastbootListener listener)
Informa il gestore che un listener non è più interessato alle modifiche dello stato fastboot. |
void
|
restartAdbBridge()
Riavvia (se è stato chiamato |
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()
Interrompi il monitoraggio dei dispositivi. |
void
|
terminateDeviceRecovery()
Interrompe il thread di recupero del dispositivo. |
void
|
terminateHard(String reason)
Ad esempio |
void
|
terminateHard()
Come |
boolean
|
waitForFirstDeviceAdded(long timeout)
Attendi finché non viene connesso il primo dispositivo fisico. |
Campi
SCONOSCIUTO_DISPLAY_STRING
public static final String UNKNOWN_DISPLAY_STRING
Stringa visualizzata per proprietà sconosciute
mFastbootEnabled
protected boolean mFastbootEnabled
Costruttori pubblici
Gestione dispositivi
public DeviceManager ()
È necessario recuperare DeviceManager da 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 dello stato fastboot.
Attualmente, IDeviceManager
monitora i dispositivi in fastboot solo se sono presenti uno o
listener più attivi.
DA FARE: questa è una specie di compromissione; trova una soluzione migliore
addMonitoringTcpFastbootDevice
public void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)
Aggiungi un dispositivo a fastboot monitor. Il monitoraggio di fastboot utilizzerà il valore "fastboot_serial" a comunicare con il dispositivo.
Parametri | |
---|---|
serial |
String : numero di serie del dispositivo. |
fastboot_serial |
String : numero di serie del dispositivo in modalità di avvio rapido. |
allocaDispositivo
public ITestDevice allocateDevice (IDeviceSelection options, boolean isTemporary)
Richiedi un dispositivo per il test che soddisfi determinati criteri.
Parametri | |
---|---|
options |
IDeviceSelection : il IDeviceSelection che il dispositivo dovrebbe soddisfare. |
isTemporary |
boolean : indica se creare o meno un NullDevice temporaneo. |
Ritorni | |
---|---|
ITestDevice |
ITestDevice per i test o null se non è disponibile |
allocaDispositivo
public ITestDevice allocateDevice (IDeviceSelection options)
Richiedi un dispositivo per il test che soddisfi determinati criteri.
Parametri | |
---|---|
options |
IDeviceSelection : il IDeviceSelection che il dispositivo dovrebbe soddisfare. |
Ritorni | |
---|---|
ITestDevice |
ITestDevice per i test o null se
non è disponibile |
allocaDispositivo
public ITestDevice allocateDevice ()
Richiedi un dispositivo fisico per i test
Ritorni | |
---|---|
ITestDevice |
ITestDevice per i test o null se non è disponibile |
connettiToTcpDevice
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'oggetto ITestDevice
restituito sarà online, ma potrebbe non essere adattabile.
Tieni presente che l'esecuzione di un'azione come il riavvio su un dispositivo connesso tramite TLS
una connessione tcp al dispositivo e viene restituito 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 formare una connessione tcp |
disconnettiFromTcpDevice
public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)
Disconnettiti da un dispositivo connesso adb-over-tcp.
Ripristina la modalità USB sul 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 è riuscito |
displayDispositiviInfo
public void displayDevicesInfo (PrintWriter stream, boolean includeStub)
Genera 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 | |
---|---|
stream |
PrintWriter : il valore ERROR(/PrintWriter) a cui inviare la descrizione |
includeStub |
boolean : se visualizzare o meno anche i dispositivi stub. |
runCmdOnAvailableDevice
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 : tempo necessario per il completamento del comando. |
timeUnit |
TimeUnit : l'unità per il timeout. |
Ritorni | |
---|---|
CommandResult |
Un CommandResult . |
EseguiAdBComandoGlobale
public String executeGlobalAdbCommand (String... cmdArgs)
Eseguire un comando adb non indirizzato a un particolare dispositivo, ad es. "adb connect"
Ritorni | |
---|---|
String |
l'output std se il comando riesce, altrimenti è nullo. |
forceAllocateDevice
public ITestDevice forceAllocateDevice (String serial)
Alloca un dispositivo in modo scortese, anche se al momento non è 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 assegnarla |
Dispositivo senza costi
public void freeDevice (ITestDevice device, FreeDeviceState deviceState)
Restituire un dispositivo nel pool
I tentativi di restituire un dispositivo che non è stato allocato in precedenza verranno ignorati.
Parametri | |
---|---|
device |
ITestDevice : i ITestDevice da liberare |
deviceState |
FreeDeviceState : FreeDeviceState . Utilizzato per controllare se
il dispositivo venga restituito al pool di dispositivi disponibile. |
getAdbPath
public String getAdbPath ()
Restituisce il percorso del programma binario adb da utilizzare.
Ritorni | |
---|---|
String |
getAdbVersion
public String getAdbVersion ()
Ottieni la versione adb attualmente in uso da parte del gestore dispositivi.
Ritorni | |
---|---|
String |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (String serial)
Restituisce il valore DeviceDescriptor con il numero di serie specificato.
Parametri | |
---|---|
serial |
String : numero di serie del dispositivo da ricevere |
Ritorni | |
---|---|
DeviceDescriptor |
DeviceDescriptor per il dispositivo selezionato o null se il numero di serie non è
che corrispondono a un dispositivo noto. |
getFastbootPath
public String getFastbootPath ()
Restituisce il percorso del programma binario fastboot da utilizzare.
Ritorni | |
---|---|
String |
Inizia
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)
Inizializza Gestione dispositivi. Deve essere chiamata una volta e solo una volta prima di qualsiasi altra vengono chiamati metodi.
Parametri | |
---|---|
globalDeviceFilter |
IDeviceSelection |
globalDeviceMonitors |
|
deviceFactory |
IManagedTestDeviceFactory |
Inizia
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors)
Inizializza Gestione dispositivi. Deve essere chiamata una volta e solo una volta prima di qualsiasi altra vengono chiamati metodi.
Parametri | |
---|---|
globalDeviceFilter |
IDeviceSelection : il filtro dei dispositivi |
globalDeviceMonitors |
|
Inizia
public void init ()
Inizializza Gestione dispositivi. Deve essere chiamata una volta e solo una volta prima di qualsiasi altra vengono chiamati metodi.
isEmulator
public boolean isEmulator (String serial)
Determinare se la serie fornita rappresenta un emulatore
Parametri | |
---|---|
serial |
String |
Ritorni | |
---|---|
boolean |
isFileSystemMountCheckEnabled
public boolean isFileSystemMountCheckEnabled ()
Restituisce se dobbiamo controllare o meno NativeDeviceStateMonitor
che il file system è
montato correttamente.
Ritorni | |
---|---|
boolean |
isNullDevice
public boolean isNullDevice (String serial)
Determinare se il numero seriale rappresenta un dispositivo nullo
Parametri | |
---|---|
serial |
String |
Ritorni | |
---|---|
boolean |
killEmulator
public void killEmulator (ITestDevice device)
Arresta l'emulatore specificato.
Si blocca finché l'emulatore scompare da ADB. Non avrà alcun effetto se l'emulatore non è già attivo disponibili.
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 di supporto per avviare l'emulatore.
Avvierà l'emulatore come specificato dal chiamante
Parametri | |
---|---|
device |
ITestDevice : il segnaposto ITestDevice che rappresenta il dispositivo emulatore allocato |
bootTimeout |
long : il tempo di attesa in ms per l'avvio dell'emulatore |
emulatorArgs |
: argomenti della riga di comando per avviare l'emulatore |
Lanci | |
---|---|
DeviceNotAvailableException |
listaTuttiDispositivi
publiclistAllDevices (boolean shortDescriptor)
Restituisce un elenco di DeviceDescriptors per tutti i dispositivi noti
Parametri | |
---|---|
shortDescriptor |
boolean : se limitare i descrittori al numero minimo di informazioni |
Ritorni | |
---|---|
|
un elenco di DeviceDescriptor per tutti i dispositivi noti |
listaTuttiDispositivi
publiclistAllDevices ()
Restituisce un elenco di DeviceDescriptors per tutti i dispositivi noti
Ritorni | |
---|---|
|
un elenco di DeviceDescriptor per tutti i dispositivi noti |
riconnettiDeviceToTcp
public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)
Un metodo helper che commuta il dispositivo USB in modalità adb-over-tcp e poi si connette a
tramite connectToTcpDevice(String)
.
Parametri | |
---|---|
usbDevice |
ITestDevice : il dispositivo attualmente in modalità USB |
Ritorni | |
---|---|
ITestDevice |
il nuovo allocato ITestDevice in modalità tcp o null se tcp
impossibile creare la connessione |
Lanci | |
---|---|
DeviceNotAvailableException |
removeDeviceMonitor
public void removeDeviceMonitor (IDeviceMonitor mon)
Rimuove un elemento IDeviceMonitor
aggiunto in precedenza. Non ha effetto se non è stato aggiunto mon.
Parametri | |
---|---|
mon |
IDeviceMonitor |
rimuovereFastbootListener
public void removeFastbootListener (IDeviceManager.IFastbootListener listener)
Informa il gestore che un listener non è più interessato alle modifiche dello stato fastboot.
riavviaAdbBridge
public void restartAdbBridge ()
Riavvia (se è stato chiamato stopAdbBridge()
) il bridge adb e i servizi dipendono da adb
e connessioni a Internet.
stopAdbBridge
public void stopAdbBridge ()
Arresta il bridge ADB e i servizi dipendono dalle connessioni ADB.
chiudere
public void terminate ()
Arresta i servizi di monitoraggio del dispositivo e termina la libreria DDm.
Questo deve essere richiesto al momento della chiusura dell'applicazione.
terminaDeviceMonitor
public void terminateDeviceMonitor ()
Interrompi il monitoraggio dei dispositivi.
terminareDeviceRecovery
public void terminateDeviceRecovery ()
Interrompe il thread di recupero del dispositivo.
terminaHard
public void terminateHard (String reason)
Ad esempio terminateHard()
.
Parametri | |
---|---|
reason |
String : motivo facoltativo indicato per la chiusura. |
terminaHard
public void terminateHard ()
Come terminate()
, ma tenta anche di chiudere con forza adb.
attesaPerPrimoDispositivoAggiunto
public boolean waitForFirstDeviceAdded (long timeout)
Attendi finché non viene connesso il primo dispositivo fisico. Se un dispositivo era connesso in precedenza, restituisce direttamente True. Se non è stato aggiunto alcun dispositivo, dopo il timeout viene restituito il valore false.
Parametri | |
---|---|
timeout |
long : tempo di attesa in millisecondi prima di restituire false. |
Ritorni | |
---|---|
boolean |