Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Gestore dispositivi

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Object
com.android.tradefed.device.DeviceManager


Sommario

Classi annidate

class DeviceManager.FastbootDevice

Rappresentazione di un dispositivo in modalità Fastboot.

Campi

public static final String UNKNOWN_DISPLAY_STRING

Visualizza stringa per proprietà sconosciute

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

Costruttori pubblici

DeviceManager ()

Il DeviceManager dovrebbe essere recuperato da GlobalConfiguration

Metodi pubblici

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

Aggiunge un IDeviceMonitor

void addFastbootListener ( IDeviceManager.IFastbootListener listener)

Informa il manager che un listener è interessato alle modifiche allo stato 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 alla fine dovrebbe essere liberato tramite disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

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

boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Disconnettiti da un dispositivo connesso adb-over-tcp.

void displayDevicesInfo (PrintWriter stream, boolean includeStub)

Produce una descrizione IDeviceSelection contenente l'elenco dei dispositivi noti, il loro stato e i valori per le opzioni IDeviceSelection uso IDeviceSelection .

String executeGlobalAdbCommand (String... cmdArgs)

Esegui un comando adb non mirato a un particolare dispositivo, ad es.

ITestDevice forceAllocateDevice (String serial)

Allocare malamente un dispositivo, anche se non è attualmente disponibile.

void freeDevice (ITestDevice device, FreeDeviceState deviceState)

Restituire un dispositivo alla piscina

I tentativi di restituire un dispositivo che non è stato assegnato in precedenza verranno ignorati.

String getAdbPath ()

Restituisce il percorso del binario adb da utilizzare.

String getAdbVersion ()

Ottieni la versione di adb attualmente in uso dal gestore dispositivi.

int getAvailableFlashingPermits ()

Ottieni il numero di permessi lampeggianti disponibili

DeviceDescriptor getDeviceDescriptor (String serial)

Restituisce il DeviceDescriptor con il numero di serie specificato.

String getFastbootPath ()

Restituisce il percorso al binario di avvio rapido da utilizzare.

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

Inizializza il gestore dispositivi.

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

Inizializza il gestore dispositivi.

void init ()

Inizializza il gestore dispositivi.

boolean isEmulator (String serial)

Determina se il seriale fornito rappresenta un emulatore

boolean isNullDevice (String serial)

Determina se il numero di serie fornito rappresenta un dispositivo nullo

void killEmulator (ITestDevice device)

Spegni l'emulatore dato.

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

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

void removeDeviceMonitor ( IDeviceMonitor mon)

Rimuove un IDeviceMonitor aggiunto in precedenza.

void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

Informa il manager che un listener non è più interessato alle modifiche allo stato di avvio rapido.

void restartAdbBridge ()

Riavvia (se è stato chiamato stopAdbBridge() ) adb bridge e i servizi dipendono dalle connessioni adb.

void returnFlashingPermit ()

Ripristina un permesso di lampeggio che abbiamo acquisito in precedenza

void stopAdbBridge ()

Arresta il bridge adb ei servizi dipendono dalle connessioni adb.

void takeFlashingPermit ()

Richiedi l'autorizzazione per eseguire il flash.

void terminate ()

Arresta i servizi di monitoraggio del dispositivo e termina la libreria ddm.

void terminateDeviceMonitor ()

Arrestare i monitor del dispositivo.

void terminateDeviceRecovery ()

Arresta il thread di ripristino del dispositivo.

void terminateHard ()

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

boolean waitForFirstDeviceAdded (long timeout)

Attendi il collegamento di un primo dispositivo fisico.

Campi

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Visualizza stringa per proprietà sconosciute

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

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

addFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

Informa il manager che un listener è interessato alle modifiche allo stato di avvio rapido.

Attualmente un IDeviceManager monitorerà i dispositivi in ​​fastboot solo se sono presenti uno o più listener attivi.

TODO: questo è un po 'un trucco: trova una soluzione migliore

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Richiedi un dispositivo per il test che soddisfi determinati criteri.

Parametri
options IDeviceSelection : IDeviceSelection 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 è disponibile

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options)

Richiedi un dispositivo per il test che soddisfi determinati criteri.

Parametri
options IDeviceSelection : IDeviceSelection il dispositivo deve soddisfare.

ritorna
ITestDevice un ITestDevice per il test o null se non è disponibile

allocateDevice

public ITestDevice allocateDevice ()

Richiedi un dispositivo fisico per il test

ritorna
ITestDevice un ITestDevice per il test o null se non è disponibile

connectToTcpDevice

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' ITestDevice restituito sarà online, ma potrebbe non essere reattivo.

Si noti che l'esecuzione di azioni come un riavvio su un dispositivo connesso tcp, interromperà la connessione tcp al dispositivo e risulterà in 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 ITestDevice una connessione TCP

disconnectFromTcpDevice

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Disconnettiti 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 è riuscito

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

Produce una descrizione IDeviceSelection contenente l'elenco dei dispositivi noti, il loro stato e i valori per le opzioni IDeviceSelection uso IDeviceSelection .

Parametri
stream PrintWriter : l' ERROR(/PrintWriter) a cui inviare la descrizione

includeStub boolean : se visualizzare o meno anche i dispositivi stub.

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Esegui un comando adb non mirato a un particolare dispositivo, ad es. "adb connect"

ritorna
String std output se il comando ha esito positivo altrimenti null.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

Allocare maledettamente un dispositivo, anche se non è attualmente disponibile.

Non avrà effetto se il dispositivo è già assegnato.

Parametri
serial String : il seriale del dispositivo da allocare

ritorna
ITestDevice ITestDevice o null se non è stato possibile allocarlo

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Restituire un dispositivo alla piscina

I tentativi di restituire un dispositivo che non è stato assegnato in precedenza verranno ignorati.

Parametri
device ITestDevice : il ITestDevice da liberare

deviceState FreeDeviceState : il FreeDeviceState . Utilizzato per controllare se il dispositivo viene restituito al pool di dispositivi disponibile.

getAdbPath

public String getAdbPath ()

Restituisce il percorso del binario adb da utilizzare.

ritorna
String

getAdbVersion

public String getAdbVersion ()

Ottieni la versione di adb attualmente in uso dal gestore dispositivi.

ritorna
String

getAvailableFlashingPermits

public int getAvailableFlashingPermits ()

Ottieni il numero di permessi lampeggianti disponibili

ritorna
int Numero di permessi lampeggianti disponibili o Integer.MAX_VALUE se non disponibile.

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

Restituisce il DeviceDescriptor con il numero di serie specificato.

Parametri
serial String : numero di serie per il 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 al binario di avvio rapido da utilizzare.

ritorna
String

dentro

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

Inizializza il gestore dispositivi. Questo deve essere chiamato una sola volta prima di chiamare qualsiasi altro metodo.

Parametri
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

dentro

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

Inizializza il gestore dispositivi. Questo deve essere chiamato una sola volta prima di chiamare qualsiasi altro metodo.

Parametri
globalDeviceFilter IDeviceSelection : il filtro del dispositivo

globalDeviceMonitors

dentro

public void init ()

Inizializza il gestore dispositivi. Questo deve essere chiamato una sola volta prima di chiamare qualsiasi altro metodo.

isEmulator

public boolean isEmulator (String serial)

Determina se il numero di serie fornito rappresenta un emulatore

Parametri
serial String

ritorna
boolean

isNullDevice

public boolean isNullDevice (String serial)

Determina se il seriale fornito rappresenta un dispositivo nullo

Parametri
serial String

ritorna
boolean

killEmulator

public void killEmulator (ITestDevice device)

Spegni l'emulatore dato.

Si blocca finché l'emulatore non scompare da adb. Non avrà effetto se l'emulatore non è già disponibile.

Parametri
device ITestDevice : il ITestDevice 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.

Avvierà l'emulatore come specificato dal chiamante

Parametri
device ITestDevice : il segnaposto ITestDevice rappresenta il dispositivo di emulazione allocato

bootTimeout long : il tempo in ms di attesa per l'avvio dell'emulatore

emulatorArgs : argomenti della riga di comando per avviare l'emulatore

Lancia
DeviceNotAvailableException

listAllDevices

public  listAllDevices ()

Restituisce un elenco di DeviceDescriptors per tutti i dispositivi conosciuti

ritorna
un elenco di DeviceDescriptor per tutti i dispositivi conosciuti

reconnectDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Un metodo di supporto che commuta il dispositivo USB specificato 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 nuovo ITestDevice allocato in modalità tcp o null se non è stato possibile ITestDevice una connessione tcp

Lancia
DeviceNotAvailableException

removeDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

Rimuove un IDeviceMonitor aggiunto in precedenza. Non ha effetto se mon non è stato aggiunto.

Parametri
mon IDeviceMonitor

removeFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informa il manager che un listener non è più interessato alle modifiche allo stato di avvio rapido.

riavviareAdbBridge

public void restartAdbBridge ()

Riavvia (se è stato chiamato stopAdbBridge() ) adb bridge e i servizi dipendono dalle connessioni adb.

returnFlashingPermit

public void returnFlashingPermit ()

Ripristina un permesso di lampeggio che abbiamo acquisito in precedenza

stopAdbBridge

public void stopAdbBridge ()

Arresta il bridge adb ei servizi dipendono dalle connessioni adb.

takeFlashingPermit

public void takeFlashingPermit ()

Richiedi l'autorizzazione per eseguire il flash. Se il numero di lampeggiatori simultanei è limitato, questo attenderà in linea per rimanere al di sotto del conteggio del limite di flash.

terminare

public void terminate ()

Arresta i servizi di monitoraggio del dispositivo e termina la libreria ddm.

Questo deve essere richiamato al termine dell'applicazione.

terminateDeviceMonitor

public void terminateDeviceMonitor ()

Arrestare i monitor del dispositivo.

terminateDeviceRecovery

public void terminateDeviceRecovery ()

Arresta il thread di ripristino del dispositivo.

terminateHard

public void terminateHard ()

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

waitForFirstDeviceAdded

public boolean waitForFirstDeviceAdded (long timeout)

Attendi il collegamento di un primo dispositivo fisico. Se un dispositivo è stato collegato 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