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 |
Métodos públicos | |
---|---|
void | addAvailableDevice (IDevice stubDevice) |
void | addDeviceMonitor ( IDeviceMonitor mon) Agrega un |
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 mediantedisconnectFromTcpDevice(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 |
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 |
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 |
void | removeDeviceMonitor ( IDeviceMonitor mon) Elimina un |
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ó |
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 |
void | terminateHard () Como |
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
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, unIDeviceManager
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 mediantedisconnectFromTcpDevice(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 |
Lanza | |
---|---|
DeviceNotAvailableException |
listaTodos los dispositivos
publiclistAllDevices (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
publiclistAllDevices ()
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 |
El contenido y el código de ejemplo de esta página están sujetos a las licencias que se describen en la licencia de contenido. Java y OpenJDK son marcas registradas de Oracle o sus entidades asociadas.
Última actualización: 2023-12-01 (UTC).