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

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Объект
↳ com.android.tradefed.device.DeviceManager

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

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

class DeviceManager.FastbootDevice

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

Поля

public static final 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 fastboot_serial)

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

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 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

добавитьАваилаблеНативедевице 

public void addAvailableNativeDevice (IDevice stubDevice)

Параметры
stubDevice IDevice

добавитьDeviceMonitor 

public void addDeviceMonitor (IDeviceMonitor mon)

Добавляет IDeviceMonitor

Параметры
mon IDeviceMonitor

добавитьFastbootDevice 

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

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

добавитьFastbootListener 

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

TODO: это небольшой трюк — найдите лучшее решение

AddMonitoringTcpFastbootDevice 

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Добавьте устройство в монитор быстрой загрузки. Монитор быстрой загрузки будет использовать fastboot_serial для связи с устройством.

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

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

выделитьустройство 

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

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

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

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

выделитьустройство 

public ITestDevice allocateDevice (IDeviceSelection options)

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

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

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

выделитьустройство 

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-соединение не может быть сформировано

отключитьфромткпдевице 

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 : отображать или нет также заглушки.

выполнитьCmdOnAvailableDevice 

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, не предназначенную для конкретного устройства, например. «Адб подключение»

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

ForceAllocateDevice 

public ITestDevice forceAllocateDevice (String serial)

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

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

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

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

бесплатноУстройство 

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

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

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

Параметры
device ITestDevice : ITestDevice для бесплатного использования.

deviceState FreeDeviceState : FreeDeviceState . Используется для контроля того, возвращается ли устройство в доступный пул устройств.

получитьAdbPath 

public String getAdbPath ()

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

Возврат
String

получитьAdbVersion 

public String getAdbVersion ()

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

Возврат
String

getDeviceDescriptor 

public DeviceDescriptor getDeviceDescriptor (String serial)

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

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

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

получитьFastbootPath 

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

Исфилесистемомаунтчекекенаблед 

public boolean isFileSystemMountCheckEnabled ()

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

Возврат
boolean

isNullDevice 

public boolean isNullDevice (String serial)

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

Параметры
serial String

Возврат
boolean

killЭмулятор 

public void killEmulator (ITestDevice device)

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

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

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

Броски
DeviceNotAvailableException

запускЭмулятор 

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

удалитьDeviceMonitor 

public void removeDeviceMonitor (IDeviceMonitor mon)

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

Параметры
mon IDeviceMonitor

удалить FastbootListener 

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

public void restartAdbBridge ()

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

остановитьAdbBridge 

public void stopAdbBridge ()

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

прекратить 

public void terminate ()

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

Это должно быть вызвано при завершении приложения.

завершить устройстводевицемонитор 

public void terminateDeviceMonitor ()

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

прекращениедевицерековери 

public void terminateDeviceRecovery ()

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

завершить трудный 

public void terminateHard (String reason)

Как terminateHard() .

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

завершить трудный 

public void terminateHard ()

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

waitForFirstDeviceAdded 

public boolean waitForFirstDeviceAdded (long timeout)

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

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

Возврат
boolean