IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


Interfaz para la gestión del conjunto de dispositivos disponibles para la prueba.

Resumen

Clases anidadas

interface IDeviceManager.IFastbootListener

Un oyente para los cambios de estado de fastboot.

Métodos públicos

abstract void addDeviceMonitor ( IDeviceMonitor mon)

Agrega un IDeviceMonitor

abstract void addFastbootListener ( IDeviceManager.IFastbootListener listener)

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

abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

Agregue un dispositivo al monitor fastboot.

abstract ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

Solicite un dispositivo para la prueba que cumpla con ciertos criterios.

abstract ITestDevice allocateDevice ( IDeviceSelection options)

Solicite un dispositivo para la prueba que cumpla con ciertos criterios.

abstract ITestDevice allocateDevice ()

Solicite un dispositivo físico para la prueba

abstract 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 a través de disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

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

abstract boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

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

abstract void displayDevicesInfo (PrintWriter printWriter, 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 de uso común.

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

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

abstract ITestDevice forceAllocateDevice (String serial)

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

abstract void freeDevice ( ITestDevice device, FreeDeviceState state)

Devolver un dispositivo a la piscina

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

abstract String getAdbPath ()

Devuelve la ruta al binario adb para usar.

abstract String getAdbVersion ()

Obtenga la versión adb actualmente en uso por el administrador de dispositivos.

abstract DeviceDescriptor getDeviceDescriptor (String serial)

Devuelve el DeviceDescriptor con el serial dado.

abstract String getFastbootPath ()

Devuelve la ruta al binario fastboot que se va a usar.

abstract void init ( IDeviceSelection globalDeviceFilter, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, deviceMonitors)

Inicialice el administrador de dispositivos con un filtro de dispositivos.

abstract void init ()

Inicialice el administrador de dispositivos.

abstract boolean isEmulator (String serial)

Determinar si la serie dada representa un emulador

default boolean isFileSystemMountCheckEnabled ()

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

abstract boolean isNullDevice (String serial)

Determinar si el serial dado representa un dispositivo nulo

abstract void killEmulator ( ITestDevice device)

Cierra el emulador dado.

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

Método auxiliar para iniciar el emulador.

abstract listAllDevices (boolean shortDescriptor)

Devuelve una lista de DeviceDescriptors para todos los dispositivos conocidos

abstract listAllDevices ()

Devuelve una lista de DeviceDescriptors para todos los dispositivos conocidos

abstract 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) .

abstract void removeDeviceMonitor ( IDeviceMonitor mon)

Elimina un IDeviceMonitor agregado previamente.

abstract void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

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

abstract void restartAdbBridge ()

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

abstract void stopAdbBridge ()

Detenga adb bridge y los servicios dependen de las conexiones adb.

abstract void terminate ()

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

abstract void terminateDeviceMonitor ()

Detenga los monitores de dispositivos.

abstract void terminateDeviceRecovery ()

Detiene el subproceso de recuperación del dispositivo.

default void terminateHard (String reason)

Como terminateHard() .

abstract void terminateHard ()

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

abstract boolean waitForFirstDeviceAdded (long timeout)

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

Métodos públicos

agregarDeviceMonitor

public abstract void addDeviceMonitor (IDeviceMonitor mon)

Agrega un IDeviceMonitor

Parámetros
mon IDeviceMonitor

agregarFastbootListener

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

Informa al administrador que un agente de escucha 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: encuentra una mejor solución

addMonitoringTcpFastbootDevice

public abstract 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 abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Solicite un dispositivo para la prueba que cumpla con ciertos criterios.

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

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

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

Asignar dispositivo

public abstract ITestDevice allocateDevice (IDeviceSelection options)

Solicite un dispositivo para la prueba que cumpla con ciertos criterios.

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

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

Asignar dispositivo

public abstract ITestDevice allocateDevice ()

Solicite un dispositivo físico para la prueba

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

conectar al dispositivo Tcp

public abstract 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 a través de 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 dará como resultado una DeviceNotAvailableException .

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

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

desconectar del dispositivo Tcp

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

Cambia 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

mostrarDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                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 de uso común.

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

includeStub boolean : si mostrar o no los dispositivos auxiliares también.

ejecutar cmd en dispositivo disponible

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

Un método auxiliar para ejecutar el comando de shell en el 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 para que se complete el comando.

timeUnit TimeUnit : la unidad para el tiempo de espera.

Devoluciones
CommandResult Un CommandResult .

forzar asignar dispositivo

public abstract ITestDevice forceAllocateDevice (String serial)

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

No tendrá efecto si el dispositivo ya está asignado.

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

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

dispositivo libre

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Devolver un dispositivo a la piscina

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

Parámetros
device ITestDevice : el ITestDevice para liberar

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

getAdbPath

public abstract String getAdbPath ()

Devuelve la ruta al binario adb para usar.

Devoluciones
String

getAdbVersion

public abstract String getAdbVersion ()

Obtenga la versión adb actualmente en uso por el administrador de dispositivos.

Devoluciones
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

Devuelve el DeviceDescriptor con el serial dado.

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

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

getFastbootPath

public abstract String getFastbootPath ()

Devuelve la ruta al binario fastboot que se va a usar.

Devoluciones
String

en eso

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Inicialice el administrador de dispositivos con un filtro de dispositivos. Este filtro se puede utilizar para indicar a DeviceManager que ignore determinados dispositivos conectados.

Parámetros
globalDeviceFilter IDeviceSelection : el filtro de dispositivos

deviceMonitors

en eso

public abstract void init ()

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

esEmulador

public abstract boolean isEmulator (String serial)

Determinar si la serie dada representa un emulador

Parámetros
serial String

Devoluciones
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

Devoluciones
boolean

esNullDevice

public abstract boolean isNullDevice (String serial)

Determinar si el serial dado representa un dispositivo nulo

Parámetros
serial String

Devoluciones
boolean

matarEmulador

public abstract void killEmulator (ITestDevice device)

Cierra el emulador dado.

Bloquea hasta que el emulador desaparezca de adb. No tendrá efecto si el emulador no está disponible.

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

Lanza
DeviceNotAvailableException si el emulador no se apaga

lanzar emulador

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

Método auxiliar para iniciar el emulador.

Iniciará 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 para esperar a que arranque el emulador

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

Lanza
DeviceNotAvailableException si el emulador no arranca o no se conecta

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

Devuelve una lista de DeviceDescriptors para todos los dispositivos conocidos

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

Devoluciones
una lista de DeviceDescriptor para todos los dispositivos conocidos

listAllDevices

public abstract  listAllDevices ()

Devuelve una lista de DeviceDescriptors para todos los dispositivos conocidos

Devoluciones
una lista de DeviceDescriptor para todos los dispositivos conocidos

reconectar dispositivo a Tcp

public abstract 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 si la conexión con usbDevice se perdió y no se pudo recuperar

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

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

Parámetros
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

reiniciarAdbBridge

public abstract void restartAdbBridge ()

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

detenerAdbBridge

public abstract void stopAdbBridge ()

Detenga adb bridge y los servicios dependen de las conexiones adb.

Terminar

public abstract void terminate ()

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

Esto debe ser llamado a la terminación de la aplicación.

terminarDeviceMonitor

public abstract void terminateDeviceMonitor ()

Detenga los monitores de dispositivos.

terminarDeviceRecovery

public abstract void terminateDeviceRecovery ()

Detiene el subproceso de recuperación del dispositivo.

terminar duro

public void terminateHard (String reason)

Como terminateHard() .

Parámetros
reason String : razón opcional dada para la terminación.

terminar duro

public abstract void terminateHard ()

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

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Espere hasta que se conecte un primer dispositivo físico. Si un dispositivo se conectó antes, devuelve directamente True. 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 false.

Devoluciones
boolean