Gestore 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 modalità Fastboot. |
Campi | |
---|---|
public static final String | UNKNOWN_DISPLAY_STRING Visualizza la stringa per le proprietà sconosciute |
protected DeviceMonitorMultiplexer | mDvcMon |
protected boolean | mFastbootEnabled
|
Costruttori pubblici | |
---|---|
DeviceManager () Il DeviceManager dovrebbe essere recuperato 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 manager che un ascoltatore è interessato ai cambiamenti dello stato di avvio rapido. |
void | addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) Aggiungi un dispositivo al monitor di avvio rapido. |
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 il test |
ITestDevice | connectToTcpDevice (String ipAndPort) Connettiti a un dispositivo con adb-over-tcp Questo metodo alloca un nuovo dispositivo, che dovrebbe eventualmente essere liberato tramitedisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) L' ITestDevice restituito sarà online, ma potrebbe non rispondere. |
boolean | disconnectFromTcpDevice ( ITestDevice tcpDevice) Disconnettersi da un dispositivo connesso adb-over-tcp. |
void | displayDevicesInfo (PrintWriter stream, boolean includeStub) Genera una descrizione intuitiva contenente l'elenco dei dispositivi conosciuti, il loro stato e i valori per le opzioni |
CommandResult | executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit) Un metodo di supporto per eseguire il comando shell sul dispositivo disponibile. |
String | executeGlobalAdbCommand (String... cmdArgs) Esegui un comando adb non mirato a un particolare dispositivo, ad es. |
ITestDevice | forceAllocateDevice (String serial) Assegna bruscamente un dispositivo, anche se non è attualmente disponibile. |
void | freeDevice ( ITestDevice device, FreeDeviceState deviceState) Restituisci un dispositivo al pool I tentativi di restituire un dispositivo che non è stato precedentemente assegnato verranno ignorati. |
String | getAdbPath () Restituisce il percorso del file binario adb da utilizzare. |
String | getAdbVersion () Ottieni la versione adb attualmente utilizzata da Gestione dispositivi. |
DeviceDescriptor | getDeviceDescriptor (String serial) Restituisce il DeviceDescriptor con il seriale specificato. |
String | getFastbootPath () Restituisce il percorso del binario fastboot da utilizzare. |
void | init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) Inizializza la gestione dispositivi. |
void | init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) Inizializza la gestione dispositivi. |
void | init () Inizializza la gestione dispositivi. |
boolean | isEmulator (String serial) Determina se il seriale dato rappresenta un emulatore |
boolean | isFileSystemMountCheckEnabled () Indica se verificare o meno in |
boolean | isNullDevice (String serial) Determina se il seriale indicato rappresenta un dispositivo nullo |
void | killEmulator ( ITestDevice device) Arrestare l'emulatore fornito. |
void | launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) Metodo di supporto per avviare l'emulatore. |
listAllDevices (boolean shortDescriptor) Restituisce un elenco di DeviceDescriptors per tutti i dispositivi conosciuti | |
listAllDevices () Restituisce un elenco di DeviceDescriptors per tutti i dispositivi conosciuti | |
ITestDevice | reconnectDeviceToTcp ( ITestDevice usbDevice) Un metodo di supporto che commuta il dispositivo USB fornito in modalità adb-over-tcp e quindi si connette ad esso tramite |
void | removeDeviceMonitor ( IDeviceMonitor mon) Rimuove un |
void | removeFastbootListener ( IDeviceManager.IFastbootListener listener) Informa il manager che un ascoltatore non è più interessato ai cambiamenti dello stato di avvio rapido. |
void | restartAdbBridge () Riavvia (se è stato chiamato |
void | stopAdbBridge () Arresta il bridge e i servizi adb dipendono dalle connessioni adb. |
void | terminate () Interrompe i servizi di monitoraggio del dispositivo e termina la libreria ddm. |
void | terminateDeviceMonitor () Interrompere i monitoraggi del dispositivo. |
void | terminateDeviceRecovery () Interrompe il thread di ripristino del dispositivo. |
void | terminateHard (String reason) Come |
void | terminateHard () Come |
boolean | waitForFirstDeviceAdded (long timeout) Attendi fino al collegamento del primo dispositivo fisico. |
Campi
UNKNOWN_DISPLAY_STRING
public static final String UNKNOWN_DISPLAY_STRING
Visualizza la stringa per le proprietà sconosciute
mFastbootAbilitato
protected boolean mFastbootEnabled
Costruttori pubblici
Gestore dispositivi
public DeviceManager ()
Il DeviceManager dovrebbe essere recuperato 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 |
aggiungiFastbootDevice
public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)
Parametri | |
---|---|
fastbootDevice | DeviceManager.FastbootDevice |
aggiungiFastbootListener
public void addFastbootListener (IDeviceManager.IFastbootListener listener)
Informa il manager che un ascoltatore è interessato ai cambiamenti dello stato di avvio rapido.
Attualmente unIDeviceManager
monitorerà i dispositivi in fastboot solo se sono presenti uno o più ascoltatori attivi. TODO: questo è un po' un trucchetto: trova una soluzione migliore addMonitoringTcpFastbootDevice
public void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)
Aggiungi un dispositivo al monitor 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 : numero di serie della modalità fastboot del dispositivo. |
allocateDevice
public 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 ne è disponibile uno |
allocateDevice
public 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 ne è disponibile uno |
allocateDevice
public ITestDevice allocateDevice ()
Richiedi un dispositivo fisico per il test
ritorna | |
---|---|
ITestDevice | un ITestDevice per il test o null se non ne è disponibile uno |
connectToTcpDevice
public ITestDevice connectToTcpDevice (String ipAndPort)
Connettiti a un dispositivo con adb-over-tcp
Questo metodo alloca un nuovo dispositivo, che dovrebbe eventualmente essere liberato tramitedisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)
L' ITestDevice
restituito sarà online, ma potrebbe non rispondere. Tieni presente che l'esecuzione di un'azione come un riavvio su un dispositivo connesso tramite TCP interromperà la connessione TCP al dispositivo e genererà un'eccezione 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 stabilire una connessione TCP |
disconnesso da TcpDevice
public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)
Disconnettersi 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 ha avuto esito positivo |
displayDevicesInfo
public void displayDevicesInfo (PrintWriter stream, boolean includeStub)
Genera una descrizione intuitiva contenente l'elenco dei dispositivi conosciuti, il loro stato e i valori per le opzioni IDeviceSelection
comunemente utilizzate.
Parametri | |
---|---|
stream | PrintWriter : l' ERROR(/PrintWriter) a cui inviare la descrizione |
includeStub | boolean : se visualizzare o meno anche i dispositivi stub. |
eseguireCmdOnAvailableDevice
public 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 seriale del dispositivo. |
command | String : il comando della shell. |
timeout | long : la quantità di tempo necessaria per il completamento del comando. |
timeUnit | TimeUnit : l'unità per il timeout. |
ritorna | |
---|---|
CommandResult | Un CommandResult . |
eseguireGlobalAdbCommand
public String executeGlobalAdbCommand (String... cmdArgs)
Esegui un comando adb non mirato a un particolare dispositivo, ad es. 'adb connetti'
ritorna | |
---|---|
String | output std se il comando ha successo null altrimenti. |
forceAllocateDevice
public ITestDevice forceAllocateDevice (String serial)
Assegna bruscamente un dispositivo, anche se non è attualmente disponibile.
Non avrà alcun effetto se il dispositivo è già allocato.Parametri | |
---|---|
serial | String : la seriale del dispositivo da allocare |
ritorna | |
---|---|
ITestDevice | ITestDevice o null se non è stato possibile allocarlo |
freeDevice
public void freeDevice (ITestDevice device, FreeDeviceState deviceState)
Restituisci un dispositivo al pool
I tentativi di restituire un dispositivo che non è stato precedentemente assegnato verranno ignorati.Parametri | |
---|---|
device | ITestDevice : l' ITestDevice da liberare |
deviceState | FreeDeviceState : 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.
ritorna | |
---|---|
String |
getAdbVersion
public String getAdbVersion ()
Ottieni la versione adb attualmente utilizzata da Gestione dispositivi.
ritorna | |
---|---|
String |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (String serial)
Restituisce il DeviceDescriptor con il seriale specificato.
Parametri | |
---|---|
serial | String : numero di serie del dispositivo da ottenere |
ritorna | |
---|---|
DeviceDescriptor | il DeviceDescriptor per il dispositivo selezionato o null se il seriale non corrisponde a un dispositivo noto. |
getFastbootPath
public String getFastbootPath ()
Restituisce il percorso del binario fastboot da utilizzare.
ritorna | |
---|---|
String |
dentro
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)
Inizializza la gestione dispositivi. Questo deve essere chiamato una e una sola volta prima che venga chiamato qualsiasi altro metodo.
Parametri | |
---|---|
globalDeviceFilter | IDeviceSelection |
globalDeviceMonitors | |
deviceFactory | IManagedTestDeviceFactory |
dentro
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors)
Inizializza la gestione dispositivi. Questo deve essere chiamato una e una sola volta prima che venga chiamato qualsiasi altro metodo.
Parametri | |
---|---|
globalDeviceFilter | IDeviceSelection : il filtro del dispositivo |
globalDeviceMonitors |
dentro
public void init ()
Inizializza la gestione dispositivi. Questo deve essere chiamato una e una sola volta prima che venga chiamato qualsiasi altro metodo.
isEmulator
public boolean isEmulator (String serial)
Determina se il seriale dato rappresenta un emulatore
Parametri | |
---|---|
serial | String |
ritorna | |
---|---|
boolean |
èFileSystemMountCheckEnabled
public boolean isFileSystemMountCheckEnabled ()
Indica se verificare o meno in NativeDeviceStateMonitor
che il file system sia montato correttamente.
ritorna | |
---|---|
boolean |
isNullDevice
public boolean isNullDevice (String serial)
Determina se il seriale indicato rappresenta un dispositivo nullo
Parametri | |
---|---|
serial | String |
ritorna | |
---|---|
boolean |
killEmulator
public void killEmulator (ITestDevice device)
Arrestare l'emulatore fornito.
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 arrestare |
Lancia | |
---|---|
DeviceNotAvailableException |
launchEmulator
public void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil,emulatorArgs)
Metodo di supporto per avviare l'emulatore.
Lancerà l'emulatore come specificato dal chiamanteParametri | |
---|---|
device | ITestDevice : il segnaposto ITestDevice che rappresenta il dispositivo emulatore allocato |
bootTimeout | long : il tempo in ms di attesa per l'avvio dell'emulatore |
emulatorArgs |
Lancia | |
---|---|
DeviceNotAvailableException |
listAllDevices
publiclistAllDevices (boolean shortDescriptor)
Restituisce un elenco di DeviceDescriptors per tutti i dispositivi conosciuti
Parametri | |
---|---|
shortDescriptor | boolean : se limitare i descrittori alle informazioni minime |
ritorna | |
---|---|
un elenco di DeviceDescriptor per tutti i dispositivi conosciuti |
listAllDevices
publiclistAllDevices ()
Restituisce un elenco di DeviceDescriptors per tutti i dispositivi conosciuti
ritorna | |
---|---|
un elenco di DeviceDescriptor per tutti i dispositivi conosciuti |
ricollegareDeviceToTcp
public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)
Un metodo di supporto che commuta il dispositivo USB fornito 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 ITestDevice appena allocato in modalità TCP o null se non è stato possibile stabilire una connessione TCP |
Lancia | |
---|---|
DeviceNotAvailableException |
rimuoviDeviceMonitor
public void removeDeviceMonitor (IDeviceMonitor mon)
Rimuove un IDeviceMonitor
aggiunto in precedenza. Non ha alcun effetto se non è stato aggiunto mon.
Parametri | |
---|---|
mon | IDeviceMonitor |
rimuovereFastbootListener
public void removeFastbootListener (IDeviceManager.IFastbootListener listener)
Informa il manager che un ascoltatore non è più interessato ai cambiamenti dello stato di avvio rapido.
riavviaAdbBridge
public void restartAdbBridge ()
Riavvia (se è stato chiamato stopAdbBridge()
) adb bridge e i servizi dipendono dalle connessioni adb.
stopAdbBridge
public void stopAdbBridge ()
Arresta il bridge e i servizi adb dipendono dalle connessioni adb.
terminare
public void terminate ()
Interrompe i servizi di monitoraggio del dispositivo e termina la libreria ddm.
Questo deve essere richiesto al momento della chiusura dell'applicazione.terminateDeviceMonitor
public void terminateDeviceMonitor ()
Interrompere i monitoraggi del dispositivo.
terminateDeviceRecovery
public void terminateDeviceRecovery ()
Interrompe il thread di ripristino del dispositivo.
terminaHard
public void terminateHard (String reason)
Come terminateHard()
.
Parametri | |
---|---|
reason | String : motivo facoltativo fornito per la terminazione. |
terminaHard
public void terminateHard ()
Come terminate()
, ma tenta anche di chiudere forzatamente adb.
waitForFirstDeviceAggiunto
public boolean waitForFirstDeviceAdded (long timeout)
Attendi fino al collegamento del primo dispositivo fisico. Se un dispositivo era 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. |
ritorna | |
---|---|
boolean |
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2023-12-01 UTC.