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 GlobalConfiguration

Metodi pubblici

void addAvailableDevice(IDevice stubDevice)
void addDeviceMonitor(IDeviceMonitor mon)

Aggiunge un IDeviceMonitor

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 disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

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

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 IDeviceSelection di uso comune.

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, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

Inizializza Gestione dispositivi.

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

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 NativeDeviceStateMonitor che il file system è montato correttamente.

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, emulatorArgs)

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 connectToTcpDevice(String).

void removeDeviceMonitor(IDeviceMonitor mon)

Rimuove un elemento IDeviceMonitor aggiunto in precedenza.

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 stopAdbBridge()) il bridge adb e i servizi dipendono da adb e connessioni a Internet.

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 terminateHard().

void terminateHard()

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

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

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

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

public  listAllDevices (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

public  listAllDevices ()

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