Administrador de dispositivos

public class DeviceManager
extends Object implements IDeviceManager

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


Resumen

clases anidadas

class DeviceManager.FastbootDevice

Representación de un dispositivo en modo Fastboot.

Campos

public static final String UNKNOWN_DISPLAY_STRING

Mostrar cadena para propiedades desconocidas

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

Constructores públicos

DeviceManager ()

El DeviceManager debe recuperarse de 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 oyente está interesado en los cambios de estado de fastboot.

void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

Agregue un dispositivo al monitor fastboot.

ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

Solicite un dispositivo para realizar pruebas que cumpla con ciertos criterios.

ITestDevice allocateDevice ( IDeviceSelection options)

Solicite un dispositivo para realizar pruebas que cumpla con ciertos criterios.

ITestDevice allocateDevice ()

Solicite un dispositivo físico para realizar pruebas

ITestDevice connectToTcpDevice (String ipAndPort)

Conéctese a un dispositivo con adb-over-tcp

Este método asigna un nuevo dispositivo, que eventualmente debería liberarse mediante disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

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

boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

Desconéctese de un dispositivo conectado adb-over-tcp.

void displayDevicesInfo (PrintWriter stream, boolean includeStub)

Genere una descripción fácil de usar que contenga una lista de dispositivos conocidos, su estado y valores para las opciones IDeviceSelection más utilizadas.

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

Un método auxiliar para ejecutar comandos de shell en un dispositivo disponible.

String executeGlobalAdbCommand (String... cmdArgs)

Ejecute un comando adb que no esté dirigido a un dispositivo en particular, por ejemplo.

ITestDevice forceAllocateDevice (String serial)

Asignar de manera grosera un dispositivo, incluso si no está disponible actualmente.

void freeDevice ( ITestDevice device, FreeDeviceState deviceState)

Devolver un dispositivo al grupo

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

String getAdbPath ()

Devuelve la ruta al binario adb que se utilizará.

String getAdbVersion ()

Obtenga la versión de adb que utiliza actualmente el administrador de dispositivos.

DeviceDescriptor getDeviceDescriptor (String serial)

Devuelve el DeviceDescriptor con el número de serie dado.

String getFastbootPath ()

Devuelve la ruta al binario fastboot que se utilizará.

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

Inicialice el administrador de dispositivos.

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

Inicialice el administrador de dispositivos.

void init ()

Inicialice el administrador de dispositivos.

boolean isEmulator (String serial)

Determinar si el serial dado representa un emulador

boolean isFileSystemMountCheckEnabled ()

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

boolean isNullDevice (String serial)

Determinar si la serie dada representa un dispositivo nulo

void killEmulator ( ITestDevice device)

Apague el emulador proporcionado.

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

Método auxiliar 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 el dispositivo USB dado al modo adb-over-tcp y luego se conecta a él a través de connectToTcpDevice(String) .

void removeDeviceMonitor ( IDeviceMonitor mon)

Elimina un IDeviceMonitor agregado previamente.

void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

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

void restartAdbBridge ()

Reinicie (si se llamó stopAdbBridge() ) el puente adb y los servicios dependen de las conexiones adb.

void stopAdbBridge ()

Detenga el puente adb y los servicios dependen de las conexiones adb.

void terminate ()

Detiene los servicios de monitoreo de dispositivos y finaliza la biblioteca ddm.

void terminateDeviceMonitor ()

Detenga los monitores de dispositivos.

void terminateDeviceRecovery ()

Detiene el hilo de recuperación del dispositivo.

void terminateHard (String reason)

Como terminateHard() .

void terminateHard ()

Como terminate() , pero también intenta cerrar adb por la fuerza.

boolean waitForFirstDeviceAdded (long timeout)

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

Campos

DESCONOCIDO_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Mostrar cadena para propiedades desconocidas

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

Constructores públicos

Administrador de dispositivos

public DeviceManager ()

El DeviceManager debe recuperarse de GlobalConfiguration

Métodos públicos

agregarDispositivoDisponible

public void addAvailableDevice (IDevice stubDevice)

Parámetros
stubDevice IDevice

agregarDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

Agrega un IDeviceMonitor

Parámetros
mon IDeviceMonitor

agregar dispositivo Fastboot

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

Parámetros
fastbootDevice DeviceManager.FastbootDevice

agregarFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

TODO: esto es un truco: encuentre una solución mejor

agregarMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Agregue un dispositivo al monitor fastboot. El monitor fastboot utilizará 'fastboot_serial' para comunicarse con el dispositivo.

Parámetros
serial String : el número de serie del dispositivo.

fastboot_serial String : el número de serie del modo fastboot del dispositivo.

asignar dispositivo

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Solicite un dispositivo para realizar pruebas que cumpla con ciertos criterios.

Parámetros
options IDeviceSelection : el IDeviceSelection que debe cumplir el dispositivo.

isTemporary boolean : si se debe crear o no un NullDevice temporal.

Devoluciones
ITestDevice un ITestDevice para pruebas, o null si no hay uno disponible

asignar dispositivo

public ITestDevice allocateDevice (IDeviceSelection options)

Solicite un dispositivo para realizar pruebas que cumpla con ciertos criterios.

Parámetros
options IDeviceSelection : el IDeviceSelection que debe cumplir el dispositivo.

Devoluciones
ITestDevice un ITestDevice para pruebas, o null si no hay uno disponible

asignar dispositivo

public ITestDevice allocateDevice ()

Solicite un dispositivo físico para realizar pruebas

Devoluciones
ITestDevice un ITestDevice para pruebas, o null si no hay uno disponible

conectar al dispositivo Tcp

public ITestDevice connectToTcpDevice (String ipAndPort)

Conéctese a un dispositivo con adb-over-tcp

Este método asigna un nuevo dispositivo, que eventualmente debería liberarse mediante disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

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

Tenga en cuenta que realizar una acción como reiniciar en un dispositivo conectado por TCP cortará la conexión TCP con el dispositivo y generará una DeviceNotAvailableException .

Parámetros
ipAndPort String : la dirección IP original y el puerto del dispositivo al que conectarse

Devoluciones
ITestDevice ITestDevice o null si no se pudo formar una conexión TCP

desconectar del dispositivo Tcp

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Desconéctese de un dispositivo conectado adb-over-tcp.

Vuelve el dispositivo al modo USB y lo libera.

Parámetros
tcpDevice ITestDevice : el dispositivo actualmente en modo tcp, previamente asignado a través de connectToTcpDevice(String)

Devoluciones
boolean true si el cambio al modo USB fue exitoso

mostrarDispositivosInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

Genere una descripción fácil de usar que contenga una lista de dispositivos conocidos, su estado y valores para las opciones IDeviceSelection más utilizadas.

Parámetros
stream PrintWriter : el ERROR(/PrintWriter) para enviar la descripción a

includeStub boolean : si se muestran o no también los dispositivos stub.

ejecutarCmdOnAvailableDevice

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

Un método auxiliar para ejecutar comandos de shell en un dispositivo disponible.

Parámetros
serial String : el número de serie del dispositivo.

command String : el comando de shell.

timeout long : la cantidad de tiempo que tarda en completarse el comando.

timeUnit TimeUnit : la unidad para el tiempo de espera.

Devoluciones
CommandResult Un CommandResult .

ejecutarGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Ejecute un comando adb que no esté dirigido a un dispositivo en particular, por ejemplo. 'adb conectar'

Devoluciones
String salida estándar si el comando tiene éxito, es nulo en caso contrario.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

Asignar de manera grosera un dispositivo, incluso si no está disponible actualmente.

No tendrá ningún efecto si el dispositivo ya está asignado.

Parámetros
serial String : el número de serie del dispositivo a asignar

Devoluciones
ITestDevice el ITestDevice , o null si no se pudo asignar

Dispositivo gratuito

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Devolver un dispositivo al grupo

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

Parámetros
device ITestDevice : el ITestDevice gratuito

deviceState FreeDeviceState : el FreeDeviceState . Se utiliza para controlar si el dispositivo se devuelve al grupo de dispositivos disponibles.

obtenerAdbPath

public String getAdbPath ()

Devuelve la ruta al binario adb que se utilizará.

Devoluciones
String

getAdbVersion

public String getAdbVersion ()

Obtenga la versión de adb que utiliza actualmente el administrador de dispositivos.

Devoluciones
String

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

Devuelve el DeviceDescriptor con el número de serie dado.

Parámetros
serial String : número de serie que obtendrá el dispositivo

Devoluciones
DeviceDescriptor el DeviceDescriptor para el dispositivo seleccionado, o nulo si el número de serie no coincide con un dispositivo conocido.

obtenerRutaFastboot

public String getFastbootPath ()

Devuelve la ruta al binario fastboot que se utilizará.

Devoluciones
String

en eso

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

Inicialice el administrador de dispositivos. Esto debe llamarse una vez y sólo una vez antes de llamar a cualquier otro método.

Parámetros
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

en eso

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

Inicialice el administrador de dispositivos. Esto debe llamarse una vez y sólo una vez antes de llamar a cualquier otro método.

Parámetros
globalDeviceFilter IDeviceSelection : el filtro de dispositivo

globalDeviceMonitors

en eso

public void init ()

Inicialice el administrador de dispositivos. Esto debe llamarse una vez y sólo una vez antes de llamar a cualquier otro método.

es emulador

public boolean isEmulator (String serial)

Determinar si el serial dado representa un emulador

Parámetros
serial String

Devoluciones
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

Devoluciones
boolean

esNullDevice

public boolean isNullDevice (String serial)

Determinar si la serie dada representa un dispositivo nulo

Parámetros
serial String

Devoluciones
boolean

matarEmulador

public void killEmulator (ITestDevice device)

Apague el emulador proporcionado.

Se bloquea hasta que el emulador desaparece de adb. No tendrá ningún efecto si el emulador ya no está disponible.

Parámetros
device ITestDevice : el ITestDevice que representa el emulador para apagar

Lanza
DeviceNotAvailableException

lanzarEmulador

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

Método auxiliar para iniciar el emulador.

Lanzará el emulador según lo especificado por la persona que llama.

Parámetros
device ITestDevice : el marcador de posición ITestDevice que representa el dispositivo emulador asignado

bootTimeout long : el tiempo en ms que se debe esperar a que arranque el emulador

emulatorArgs : argumentos de la línea de comando para iniciar el emulador

Lanza
DeviceNotAvailableException

listaTodos los dispositivos

public  listAllDevices (boolean shortDescriptor)

Devuelve una lista de DeviceDescriptors para todos los dispositivos conocidos

Parámetros
shortDescriptor boolean : si se deben limitar los descriptores a información mínima

Devoluciones
una lista de DeviceDescriptor para todos los dispositivos conocidos

listaTodos los dispositivos

public  listAllDevices ()

Devuelve una lista de DeviceDescriptors para todos los dispositivos conocidos

Devoluciones
una lista de DeviceDescriptor para todos los dispositivos conocidos

reconectarDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

Parámetros
usbDevice ITestDevice : el dispositivo actualmente en modo USB

Devoluciones
ITestDevice el ITestDevice recién asignado en modo tcp o null si no se pudo formar una conexión tcp

Lanza
DeviceNotAvailableException

eliminarDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

Elimina un IDeviceMonitor agregado previamente. No tiene efecto si no se ha agregado mon.

Parámetros
mon IDeviceMonitor

eliminarFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

reiniciarAdbBridge

public void restartAdbBridge ()

Reinicie (si se llamó stopAdbBridge() ) el puente adb y los servicios dependen de las conexiones adb.

detenerAdbBridge

public void stopAdbBridge ()

Detenga el puente adb y los servicios dependen de las conexiones adb.

Terminar

public void terminate ()

Detiene los servicios de monitoreo de dispositivos y finaliza la biblioteca ddm.

Esto debe solicitarse al finalizar la solicitud.

terminarDeviceMonitor

public void terminateDeviceMonitor ()

Detenga los monitores de dispositivos.

terminarDeviceRecovery

public void terminateDeviceRecovery ()

Detiene el hilo de recuperación del dispositivo.

terminarDifícil

public void terminateHard (String reason)

Como terminateHard() .

Parámetros
reason String : motivo opcional dado para la terminación.

terminarDifícil

public void terminateHard ()

Como terminate() , pero también intenta cerrar adb por la fuerza.

esperar por el primer dispositivo agregado

public boolean waitForFirstDeviceAdded (long timeout)

Espere hasta que se conecte un primer dispositivo físico. Si un dispositivo estuvo conectado antes, devuelve directamente Verdadero. Si no se agregó ningún dispositivo, devuelve falso después del tiempo de espera.

Parámetros
timeout long : tiempo de espera en milisegundos antes de devolver falso.

Devoluciones
boolean