Диспетчер устройств

public class DeviceManager
extends Object implements IDeviceManager

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

Краткое содержание

Вложенные классы

class DeviceManager.FastbootDevice

Представление устройства в режиме Fastboot.

Константы

String UNKNOWN_DISPLAY_STRING

Отображение строки для неизвестных свойств

Поля

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

Публичные конструкторы

DeviceManager ()

DeviceManager следует извлечь из GlobalConfiguration

Публичные методы

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

Добавляет IDeviceMonitor

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

Информирует менеджера о том, что слушатель заинтересован в изменении состояния быстрой загрузки.

void addMonitoringTcpFastbootDevice (String serial, String fastbootSerial)

Добавьте устройство в монитор быстрой загрузки.

ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

Запросите для тестирования устройство, соответствующее определенным критериям.

ITestDevice allocateDevice ( IDeviceSelection options)

Запросите для тестирования устройство, соответствующее определенным критериям.

ITestDevice allocateDevice ()

Запросите физическое устройство для тестирования

ITestDevice connectToTcpDevice (String ipAndPort)

Подключитесь к устройству с помощью adb-over-tcp

Этот метод выделяет новое устройство, которое в конечном итоге должно быть освобождено с помощью disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

Возвращенный ITestDevice будет доступен, но может не отвечать.

boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

Отключитесь от устройства, подключенного по adb-over-tcp.

void displayDevicesInfo (PrintWriter stream, boolean includeStub)

Вывести удобное для пользователя описание, содержащее список известных устройств, их состояние и значения для часто используемых параметров IDeviceSelection .

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

Вспомогательный метод для выполнения команды оболочки на доступном устройстве.

String executeGlobalAdbCommand (String... cmdArgs)

Выполнить команду adb, не предназначенную для конкретного устройства, например:

ITestDevice forceAllocateDevice (String serial)

Грубо выделите устройство, даже если оно в данный момент недоступно.

void freeDevice ( ITestDevice device, FreeDeviceState deviceState)

Верните устройство в пул

Попытки вернуть устройство, которое не было выделено ранее, будут игнорироваться.

String getAdbPath ()

Возвращает путь к используемому двоичному файлу adb.

String getAdbVersion ()

Получите версию adb, используемую в данный момент диспетчером устройств.

DeviceDescriptor getDeviceDescriptor (String serial)

Возвращает DeviceDescriptor с заданным серийным номером.

String getFastbootPath ()

Возвращает путь к используемому двоичному файлу fastboot.

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

Инициализируйте диспетчер устройств.

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

Инициализируйте диспетчер устройств.

void init ()

Инициализируйте диспетчер устройств.

boolean isEmulator (String serial)

Определить, представляет ли данный серийный номер эмулятор

boolean isFileSystemMountCheckEnabled ()

Возвращает, следует ли проверять в NativeDeviceStateMonitor правильность монтирования файловой системы.

boolean isNullDevice (String serial)

Определить, представляет ли данный серийный номер нулевое устройство

void killEmulator ( ITestDevice device)

Завершите работу данного эмулятора.

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

Вспомогательный метод для запуска эмулятора.

listAllDevices (boolean shortDescriptor)

Возвращает список DeviceDescriptors для всех известных устройств.

listAllDevices ()

Возвращает список DeviceDescriptors для всех известных устройств.

ITestDevice reconnectDeviceToTcp ( ITestDevice usbDevice)

Вспомогательный метод, который переключает заданное USB-устройство в режим adb-over-tcp, а затем подключается к нему через connectToTcpDevice(String) .

void removeDeviceMonitor ( IDeviceMonitor mon)

Удаляет ранее добавленный IDeviceMonitor .

void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

Информирует менеджера о том, что слушатель больше не заинтересован в изменениях состояния быстрой загрузки.

void removeMonitoringTcpFastbootDevice (String serial)

void restartAdbBridge ()

Перезапустите (если был вызван stopAdbBridge() ) мост adb и службы, зависящие от подключений adb.

void stopAdbBridge ()

Остановите adb-мост и службы, зависящие от adb-подключений.

void terminate ()

Останавливает службы мониторинга устройств и завершает работу библиотеки ddm.

void terminateDeviceMonitor ()

Остановите мониторы устройств.

void terminateDeviceRecovery ()

Останавливает поток восстановления устройства.

void terminateHard (String reason)

Как terminateHard() .

void terminateHard ()

Похож на terminate() , но также пытается принудительно завершить работу adb.

boolean waitForFirstDeviceAdded (long timeout)

Подождите, пока не будет подключено первое физическое устройство.

Константы

UNKNOWN_DISPLAY_STRING 

public static final String UNKNOWN_DISPLAY_STRING

Отображение строки для неизвестных свойств

Постоянное значение: «неизвестно»

Поля

mDvcMon 

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled 

protected boolean mFastbootEnabled

Публичные конструкторы

Диспетчер устройств 

public DeviceManager ()

DeviceManager следует извлечь из GlobalConfiguration

Публичные методы

добавитьДоступноеУстройство 

public void addAvailableDevice (IDevice stubDevice)

Параметры
stubDevice IDevice

addAvailableNativeDevice 

public void addAvailableNativeDevice (IDevice stubDevice)

Параметры
stubDevice IDevice

addDeviceMonitor 

public void addDeviceMonitor (IDeviceMonitor mon)

Добавляет IDeviceMonitor

Параметры
mon IDeviceMonitor

addFastbootDevice 

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

Параметры
fastbootDevice DeviceManager.FastbootDevice

addFastbootListener 

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

Информирует менеджера о том, что слушатель заинтересован в изменении состояния быстрой загрузки.

В настоящее время IDeviceManager будет отслеживать устройства в режиме быстрой загрузки только при наличии одного или нескольких активных прослушивателей.

TODO: это своего рода хак — найдите решение получше.

addMonitoringTcpFastbootDevice 

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastbootSerial)

Добавьте устройство в Fastboot Monitor. Fastboot Monitor будет использовать порт fastboot_serial для связи с устройством.

Параметры
serial String : серийный номер устройства.

fastbootSerial String : серийный номер режима быстрой загрузки устройства.

allocateDevice 

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Запросите для тестирования устройство, соответствующее определенным критериям.

Параметры
options IDeviceSelection : IDeviceSelection которому должно соответствовать устройство.

isTemporary boolean : следует ли создавать временный NullDevice.

Возврат
ITestDevice ITestDevice для тестирования или null , если он недоступен

allocateDevice 

public ITestDevice allocateDevice (IDeviceSelection options)

Запросите для тестирования устройство, соответствующее определенным критериям.

Параметры
options IDeviceSelection : IDeviceSelection которому должно соответствовать устройство.

Возврат
ITestDevice ITestDevice для тестирования или null , если он недоступен

allocateDevice 

public ITestDevice allocateDevice ()

Запросите физическое устройство для тестирования

Возврат
ITestDevice ITestDevice для тестирования или null , если он недоступен

connectToTcpDevice 

public ITestDevice connectToTcpDevice (String ipAndPort)

Подключитесь к устройству с помощью adb-over-tcp

Этот метод выделяет новое устройство, которое в конечном итоге должно быть освобождено с помощью disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

Возвращенный ITestDevice будет доступен, но может не отвечать.

Обратите внимание, что выполнение таких действий, как перезагрузка устройства, подключенного по протоколу TCP, приведет к разрыву соединения TCP с устройством и возникновению исключения DeviceNotAvailableException

Параметры
ipAndPort String : исходный IP-адрес и порт устройства для подключения.

Возврат
ITestDevice ITestDevice или null , если TCP-соединение не может быть установлено

отключитьFromTcpDevice 

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Отключитесь от устройства, подключенного по adb-over-tcp.

Переключает устройство обратно в режим USB и освобождает его.

Параметры
tcpDevice ITestDevice : устройство в настоящее время находится в режиме TCP, ранее выделенном через connectToTcpDevice(String)

Возврат
boolean true , если переключение в режим USB прошло успешно

displayDevicesInfo 

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

Вывести удобное для пользователя описание, содержащее список известных устройств, их состояние и значения для часто используемых параметров IDeviceSelection .

Параметры
stream PrintWriter : ERROR(/PrintWriter) при выводе описания

includeStub boolean : отображать ли также и устройства-заглушки.

executeCmdOnAvailableDevice 

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

Вспомогательный метод для выполнения команды оболочки на доступном устройстве.

Параметры
serial String : Серийный номер устройства.

command String : Команда оболочки.

timeout long : Время, необходимое для выполнения команды.

timeUnit TimeUnit : Единица измерения времени ожидания.

Возврат
CommandResult CommandResult .

выполнитьGlobalAdbCommand 

public String executeGlobalAdbCommand (String... cmdArgs)

Выполнить команду adb, не предназначенную для конкретного устройства, например, «adb connect».

Возврат
String стандартный вывод, если команда выполнена успешно, в противном случае — null.

forceAllocateDevice 

public ITestDevice forceAllocateDevice (String serial)

Грубо выделите устройство, даже если оно в данный момент недоступно.

Не окажет никакого эффекта, если устройство уже выделено.

Параметры
serial String : серийный номер устройства для выделения

Возврат
ITestDevice ITestDevice или null , если его не удалось выделить

freeDevice 

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Верните устройство в пул

Попытки вернуть устройство, которое не было выделено ранее, будут игнорироваться.

Параметры
device ITestDevice : ITestDevice для освобождения

deviceState FreeDeviceState : FreeDeviceState . Используется для управления возвратом устройства в пул доступных устройств.

получитьAdbPath 

public String getAdbPath ()

Возвращает путь к используемому двоичному файлу adb.

Возврат
String

getAdbVersion 

public String getAdbVersion ()

Получите версию adb, используемую в данный момент диспетчером устройств.

Возврат
String

получитьDeviceDescriptor 

public DeviceDescriptor getDeviceDescriptor (String serial)

Возвращает DeviceDescriptor с заданным серийным номером.

Параметры
serial String : серийный номер устройства, которое нужно получить

Возврат
DeviceDescriptor DeviceDescriptor для выбранного устройства или null, если серийный номер не соответствует известному устройству.

getFastbootPath 

public String getFastbootPath ()

Возвращает путь к используемому двоичному файлу fastboot.

Возврат
String

инициализация 

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

Инициализируйте диспетчер устройств. Этот вызов должен быть выполнен только один раз, перед вызовом любых других методов.

Параметры
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

инициализация 

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

Инициализируйте диспетчер устройств. Этот вызов должен быть выполнен только один раз, перед вызовом любых других методов.

Параметры
globalDeviceFilter IDeviceSelection : фильтр устройств

globalDeviceMonitors

инициализация 

public void init ()

Инициализируйте диспетчер устройств. Этот вызов должен быть выполнен только один раз, перед вызовом любых других методов.

isEmulator 

public boolean isEmulator (String serial)

Определить, представляет ли данный серийный номер эмулятор

Параметры
serial String

Возврат
boolean

isFileSystemMountCheckEnabled 

public boolean isFileSystemMountCheckEnabled ()

Возвращает, следует ли проверять в NativeDeviceStateMonitor правильность монтирования файловой системы.

Возврат
boolean

isNullDevice 

public boolean isNullDevice (String serial)

Определить, представляет ли данный серийный номер нулевое устройство

Параметры
serial String

Возврат
boolean

killEmulator 

public void killEmulator (ITestDevice device)

Завершите работу данного эмулятора.

Блокирует до тех пор, пока эмулятор не исчезнет из ADB. Не будет иметь никакого эффекта, если эмулятор уже недоступен.

Параметры
device ITestDevice : ITestDevice представляющий эмулятор, который нужно отключить

Броски
DeviceNotAvailableException

launchEmulator 

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

Вспомогательный метод для запуска эмулятора.

Запустит эмулятор, как указано вызывающим.

Параметры
device ITestDevice : заполнитель ITestDevice , представляющий выделенное эмуляторное устройство

bootTimeout long : время в мс для ожидания загрузки эмулятора

emulatorArgs : аргументы командной строки для запуска эмулятора

Броски
DeviceNotAvailableException

списокВсехУстройств 

public  listAllDevices (boolean shortDescriptor)

Возвращает список DeviceDescriptors для всех известных устройств.

Параметры
shortDescriptor boolean : следует ли ограничивать дескрипторы минимальной информацией

Возврат
список DeviceDescriptor для всех известных устройств

списокВсехУстройств 

public  listAllDevices ()

Возвращает список DeviceDescriptors для всех известных устройств.

Возврат
список DeviceDescriptor для всех известных устройств

переподключитьDeviceToTcp 

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Вспомогательный метод, который переключает заданное USB-устройство в режим adb-over-tcp, а затем подключается к нему через connectToTcpDevice(String) .

Параметры
usbDevice ITestDevice : устройство в данный момент находится в режиме USB

Возврат
ITestDevice вновь выделенный ITestDevice в режиме TCP или null , если TCP-соединение не удалось сформировать

Броски
DeviceNotAvailableException

removeDeviceMonitor 

public void removeDeviceMonitor (IDeviceMonitor mon)

Удаляет ранее добавленный IDeviceMonitor . Не действует, если mon не был добавлен.

Параметры
mon IDeviceMonitor

removeFastbootListener 

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Информирует менеджера о том, что слушатель больше не заинтересован в изменениях состояния быстрой загрузки.

removeMonitoringTcpFastbootDevice 

public void removeMonitoringTcpFastbootDevice (String serial)

Параметры
serial String

перезапуститьAdbBridge 

public void restartAdbBridge ()

Перезапустите (если был вызван stopAdbBridge() ) мост adb и службы, зависящие от подключений adb.

stopAdbBridge 

public void stopAdbBridge ()

Остановите adb-мост и службы, зависящие от adb-подключений.

прекратить 

public void terminate ()

Останавливает службы мониторинга устройств и завершает работу библиотеки ddm.

Эту функцию необходимо вызывать при завершении действия заявки.

terminateDeviceMonitor 

public void terminateDeviceMonitor ()

Остановите мониторы устройств.

terminateDeviceRecovery 

public void terminateDeviceRecovery ()

Останавливает поток восстановления устройства.

terminateHard 

public void terminateHard (String reason)

Как terminateHard() .

Параметры
reason String : необязательная причина прекращения.

terminateHard 

public void terminateHard ()

Похож на terminate() , но также пытается принудительно завершить работу adb.

waitForFirstDeviceAdded 

public boolean waitForFirstDeviceAdded (long timeout)

Дождитесь подключения первого физического устройства. Если устройство уже было подключено, функция сразу возвращает значение True. Если устройство не было добавлено, функция возвращает значение False по истечении времени ожидания.

Параметры
timeout long : время ожидания в миллисекундах перед возвратом значения false.

Возврат
boolean