DeviceManager

public class DeviceManager
extends Object implements IDeviceManager

Objeto java.lang.
   ↳ com.android.tradefed.device.DeviceManager

Resumen

Clases anidadas

class DeviceManager.FastbootDevice

Representación de un dispositivo en Modo fastboot [Fastboot mode]. 

Campos

public static final String UNKNOWN_DISPLAY_STRING

Cadena de visualización para propiedades desconocidas

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

Constructores públicos

DeviceManager()

El DeviceManager debe recuperarse desde GlobalConfiguration.

Métodos públicos

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

Agrega un IDeviceMonitor

void addFastbootDevice(DeviceManager.FastbootDevice fastbootDevice)
void addFastbootListener(IDeviceManager.IFastbootListener listener)

Informa al administrador que un objeto de escucha está interesado en los cambios de estado de fastboot.

void addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)

Agrega un dispositivo al monitor de fastboot.

ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

Solicita un dispositivo para pruebas que cumpla con ciertos criterios.

ITestDevice allocateDevice(IDeviceSelection options)

Solicita un dispositivo para pruebas que cumpla con ciertos criterios.

ITestDevice allocateDevice()

Solicita un dispositivo físico para las pruebas

ITestDevice connectToTcpDevice(String ipAndPort)

Cómo conectarte a un dispositivo con adb-over-tcp

Este método asigna un nuevo dispositivo, que eventualmente debe liberarse a través de disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

El ITestDevice que se muestra estará en línea, pero es posible que no responda.

boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

Desconéctate de un dispositivo conectado con adb-over-tcp.

void displayDevicesInfo(PrintWriter stream, boolean includeStub)

Genera una descripción fácil de usar que contenga una lista de dispositivos conocidos, su estado y sus valores para las opciones de IDeviceSelection de uso general.

CommandResult executeCmdOnAvailableDevice(String serial, String command, long timeout, TimeUnit timeUnit)

Un método auxiliar para ejecutar un comando shell en el dispositivo disponible.

String executeGlobalAdbCommand(String... cmdArgs)

Ejecuta un comando adb que no esté dirigido a un dispositivo en particular; p. ej.,

ITestDevice forceAllocateDevice(String serial)

Asignar un dispositivo de manera grosera, incluso si no está disponible en ese momento

void freeDevice(ITestDevice device, FreeDeviceState deviceState)

Cómo devolver un dispositivo al grupo

Se ignorarán los intentos de devolver un dispositivo que no se haya asignado previamente.

String getAdbPath()

Muestra la ruta de acceso al objeto binario de adb que se usará.

String getAdbVersion()

Obtén la versión de adb que usa el administrador de dispositivos.

DeviceDescriptor getDeviceDescriptor(String serial)

Devuelve DeviceDescriptor con el número de serie especificado.

String getFastbootPath()

Muestra la ruta de acceso al objeto binario de fastboot que se usará.

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

Inicializa el administrador de dispositivos.

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

Inicializa el administrador de dispositivos.

void init()

Inicializa el administrador de dispositivos.

boolean isEmulator(String serial)

Determina si el número de serie especificado representa un emulador.

boolean isFileSystemMountCheckEnabled()

Muestra si debemos verificar o no el sistema de archivos en NativeDeviceStateMonitor. esté montado correctamente.

boolean isNullDevice(String serial)

Determina si el número de serie especificado representa un dispositivo nulo.

void killEmulator(ITestDevice device)

Cierra el emulador.

void launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs)

Método de ayuda para iniciar el emulador.

listAllDevices(boolean shortDescriptor)

Devuelve una lista de DeviceDescriptors para todos los dispositivos conocidos.

listAllDevices()

Devuelve una lista de DeviceDescriptors para todos los dispositivos conocidos.

ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

Un método auxiliar que cambia un dispositivo USB al modo adb-over-tcp y, luego, se conecta a través de connectToTcpDevice(String).

void removeDeviceMonitor(IDeviceMonitor mon)

Quita un IDeviceMonitor que se agregó anteriormente.

void removeFastbootListener(IDeviceManager.IFastbootListener listener)

Informa al administrador que un objeto de escucha ya no está interesado en los cambios de estado de fastboot.

void restartAdbBridge()

Reiniciar (si se llamó a stopAdbBridge()) puente adb y servicios dependen de adb conexiones de red.

void stopAdbBridge()

La detención del puente adb y los servicios dependen de las conexiones adb.

void terminate()

Detiene los servicios de supervisión del dispositivo y finaliza la biblioteca de ddm.

void terminateDeviceMonitor()

Detén los monitores de dispositivos.

void terminateDeviceRecovery()

Detiene el subproceso de recuperación del dispositivo.

void terminateHard(String reason)

Por ejemplo, terminateHard().

void terminateHard()

Es similar a terminate(), pero también intenta cerrar adb de manera forzosa.

boolean waitForFirstDeviceAdded(long timeout)

Espera hasta que se conecte un primer dispositivo físico.

Campos

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Cadena de visualización para propiedades desconocidas

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

Constructores públicos

DeviceManager

public DeviceManager ()

El DeviceManager debe recuperarse desde GlobalConfiguration.

Métodos públicos

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

Parámetros
stubDevice IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

Agrega un IDeviceMonitor

Parámetros
mon IDeviceMonitor

agregarFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

Parámetros
fastbootDevice DeviceManager.FastbootDevice

addFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

Informa al administrador que un objeto de escucha está interesado en los cambios de estado de fastboot.

Actualmente, un IDeviceManager solo supervisará dispositivos en fastboot si hay uno o y oyentes más activos.

PENDIENTE: Esta es una modificación pequeña; encuentra una mejor solución

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Agrega un dispositivo al monitor de fastboot. El monitor de fastboot usará "fastboot_serial" a para comunicarse con el dispositivo.

Parámetros
serial String: Es el número de serie del dispositivo.
fastboot_serial String: Es el número de serie del modo fastboot del dispositivo.

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Solicita un dispositivo para pruebas que cumpla con ciertos criterios.

Parámetros
options IDeviceSelection: Es el IDeviceSelection que debe cumplir el dispositivo.
isTemporary boolean: Indica si se debe crear o no un NullDevice temporal.
Muestra
ITestDevice un objeto ITestDevice para probar o un objeto null si no hay uno disponible.

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options)

Solicita un dispositivo para pruebas que cumpla con ciertos criterios.

Parámetros
options IDeviceSelection: Es el IDeviceSelection que debe cumplir el dispositivo.
Muestra
ITestDevice un ITestDevice para prueba o null si existe no está disponible

allocateDevice

public ITestDevice allocateDevice ()

Solicita un dispositivo físico para las pruebas

Muestra
ITestDevice un objeto ITestDevice para probar o un objeto null si no hay uno disponible.

conectarseToTcpDevice

public ITestDevice connectToTcpDevice (String ipAndPort)

Cómo conectarte a un dispositivo con adb-over-tcp

Este método asigna un nuevo dispositivo, que eventualmente debe liberarse a través de disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

El ITestDevice que se muestra estará en línea, pero es posible que no responda.

Ten en cuenta que realizar una acción, como reiniciar un dispositivo conectado a TCP, dividirá la tcp al dispositivo y dan como resultado una DeviceNotAvailableException

Parámetros
ipAndPort String: Es la dirección IP y el puerto originales del dispositivo al que se conectará.
Muestra
ITestDevice el ITestDevice o el null si no se pudo formar una conexión TCP

desconectarDesdeTcpDispositivo

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Desconéctate de un dispositivo conectado con adb-over-tcp.

Vuelve a cambiar el dispositivo al modo USB y lo libera.

Parámetros
tcpDevice ITestDevice: Es el dispositivo actualmente en modo TCP, asignado anteriormente mediante connectToTcpDevice(String)
Muestra
boolean true si se cambió correctamente al modo USB

Información de dispositivos de visualización

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

Genera una descripción fácil de usar que contenga una lista de dispositivos conocidos, su estado y sus valores para las opciones de IDeviceSelection de uso general.

Parámetros
stream PrintWriter: Es el ERROR(/PrintWriter) al que se enviará la descripción.
includeStub boolean: Indica si también se deben mostrar o no dispositivos auxiliares.

runCmdOnAvailableDevice

public CommandResult executeCmdOnAvailableDevice (String serial, 
                String command, 
                long timeout, 
                TimeUnit timeUnit)

Un método auxiliar para ejecutar un comando shell en el dispositivo disponible.

Parámetros
serial String: Es el número de serie del dispositivo.
command String: Es el comando de shell.
timeout long: Es la cantidad de tiempo que tarda en completarse el comando.
timeUnit TimeUnit: Es la unidad para el tiempo de espera.
Muestra
CommandResult Un objeto CommandResult.

EjecutarGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Ejecuta un comando adb que no esté dirigido a un dispositivo en particular; p. ej., "adb connect"

Muestra
String De lo contrario, el resultado es std si el comando tiene éxitom null.

ForceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

Asignar un dispositivo de manera grosera, incluso si no está disponible en ese momento

No tendrá efecto si ya se asignó el dispositivo.

Parámetros
serial String: Es el número de serie del dispositivo que se asignará.
Muestra
ITestDevice ITestDevice o null si no se pudo asignar

Dispositivo gratis

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Cómo devolver un dispositivo al grupo

Se ignorarán los intentos de devolver un dispositivo que no se haya asignado previamente.

Parámetros
device ITestDevice: Es el ITestDevice que se liberará.
deviceState FreeDeviceState: Es el FreeDeviceState. Se usan para controlar si El dispositivo regresa al grupo de dispositivos disponible.

getAdbPath

public String getAdbPath ()

Muestra la ruta de acceso al objeto binario de adb que se usará.

Muestra
String

getAdbVersion

public String getAdbVersion ()

Obtén la versión de adb que usa el administrador de dispositivos.

Muestra
String

getDeviceDescriptor.

public DeviceDescriptor getDeviceDescriptor (String serial)

Devuelve DeviceDescriptor con el número de serie especificado.

Parámetros
serial String: Es el número de serie que debe obtener el dispositivo.
Muestra
DeviceDescriptor el DeviceDescriptor para el dispositivo seleccionado o un valor nulo si el número de serie no coinciden con un dispositivo conocido.

getFastbootPath

public String getFastbootPath ()

Muestra la ruta de acceso al objeto binario de fastboot que se usará.

Muestra
String

init

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

Inicializa el administrador de dispositivos. Se debe llamar a este método solo una vez antes que cualquier otro. se llama a todos los métodos.

Parámetros
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

init

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

Inicializa el administrador de dispositivos. Se debe llamar a este método solo una vez antes que cualquier otro. se llama a todos los métodos.

Parámetros
globalDeviceFilter IDeviceSelection: Es el filtro de dispositivos.
globalDeviceMonitors

init

public void init ()

Inicializa el administrador de dispositivos. Se debe llamar a este método solo una vez antes que cualquier otro. se llama a todos los métodos.

isEmulator

public boolean isEmulator (String serial)

Determina si el número de serie especificado representa un emulador.

Parámetros
serial String

Muestra
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Muestra si debemos verificar o no el sistema de archivos en NativeDeviceStateMonitor. esté montado correctamente.

Muestra
boolean

DispositivoEsNulo

public boolean isNullDevice (String serial)

Determina si el número de serie especificado representa un dispositivo nulo.

Parámetros
serial String

Muestra
boolean

killEmulator

public void killEmulator (ITestDevice device)

Cierra el emulador.

Se bloquea hasta que el emulador desaparece de adb. No tendrá efecto si el emulador aún no está activado. disponibles.

Parámetros
device ITestDevice: Es el ITestDevice que representa el emulador que se debe apagar.
Arroja
DeviceNotAvailableException

iniciar emulador

public void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                 emulatorArgs)

Método de ayuda para iniciar el emulador.

Se iniciará el emulador según lo especificado por el llamador.

Parámetros
device ITestDevice: Es el marcador de posición ITestDevice que representa el dispositivo emulador asignado.
bootTimeout long: Es el tiempo en ms para esperar a que se inicie el emulador.
emulatorArgs : Son los argumentos de la línea de comandos para iniciar el emulador.
Arroja
DeviceNotAvailableException

listAllDevices

public  listAllDevices (boolean shortDescriptor)

Devuelve una lista de DeviceDescriptors para todos los dispositivos conocidos.

Parámetros
shortDescriptor boolean: Indica si se deben limitar los descriptores a la información mínima.
Muestra
una lista de DeviceDescriptor para todos los dispositivos conocidos

listAllDevices

public  listAllDevices ()

Devuelve una lista de DeviceDescriptors para todos los dispositivos conocidos.

Muestra
una lista de DeviceDescriptor para todos los dispositivos conocidos

volver a conectarDispositivoToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Un método auxiliar que cambia un dispositivo USB al modo adb-over-tcp y, luego, se conecta a través de connectToTcpDevice(String).

Parámetros
usbDevice ITestDevice: Es el dispositivo que se encuentra en modo USB.
Muestra
ITestDevice el ITestDevice recientemente asignado en modo TCP o null si se trata de no se pudo formar la conexión
Arroja
DeviceNotAvailableException

quitarDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

Quita un IDeviceMonitor que se agregó anteriormente. No tiene efecto si no se agregó el mes.

Parámetros
mon IDeviceMonitor

quitarFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informa al administrador que un objeto de escucha ya no está interesado en los cambios de estado de fastboot.

reiniciarAdbBridge

public void restartAdbBridge ()

Reiniciar (si se llamó a stopAdbBridge()) puente adb y servicios dependen de adb conexiones de red.

paradaAdbBridge

public void stopAdbBridge ()

La detención del puente adb y los servicios dependen de las conexiones adb.

cerrar

public void terminate ()

Detiene los servicios de supervisión del dispositivo y finaliza la biblioteca de ddm.

Se debe llamar cuando se cierre la aplicación.

finalizarDeviceMonitor

public void terminateDeviceMonitor ()

Detén los monitores de dispositivos.

rescindirDeviceRecovery

public void terminateDeviceRecovery ()

Detiene el subproceso de recuperación del dispositivo.

Terminar

public void terminateHard (String reason)

Por ejemplo, terminateHard().

Parámetros
reason String: Es el motivo opcional del cierre.

Terminar

public void terminateHard ()

Es similar a terminate(), pero también intenta cerrar adb de manera forzosa.

waitForFirstDeviceAdded

public boolean waitForFirstDeviceAdded (long timeout)

Espera hasta que se conecte un primer dispositivo físico. Si un dispositivo se conectó anteriormente, devuelve directamente True. Si no se agregó ningún dispositivo, se muestra el valor "false" después del tiempo de espera.

Parámetros
timeout long: Es el tiempo de espera en milisegundos antes de mostrar un valor falso.
Muestra
boolean