IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Интерфейс для управления набором доступных для тестирования устройств.

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

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

interface IDeviceManager.IFastbootListener

Слушатель изменений состояния fastboot.

Общедоступные методы

abstract void addDeviceMonitor ( IDeviceMonitor mon)

Добавляет IDeviceMonitor

abstract void addFastbootListener ( IDeviceManager.IFastbootListener listener)

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

abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

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

abstract ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

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

abstract ITestDevice allocateDevice ( IDeviceSelection options)

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

abstract ITestDevice allocateDevice ()

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

abstract ITestDevice connectToTcpDevice (String ipAndPort)

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

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

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

abstract boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

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

abstract void displayDevicesInfo (PrintWriter printWriter, boolean includeStub)

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

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

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

abstract ITestDevice forceAllocateDevice (String serial)

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

abstract void freeDevice ( ITestDevice device, FreeDeviceState state)

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

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

abstract String getAdbPath ()

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

abstract String getAdbVersion ()

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

abstract DeviceDescriptor getDeviceDescriptor (String serial)

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

abstract String getFastbootPath ()

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

abstract long getShellCheckCmdTime ()

Получает значение таймаута в миллисекундах для команды проверки доступности оболочки.

abstract void init ( IDeviceSelection globalDeviceFilter, List< IDeviceMonitor > deviceMonitors)

Инициализируйте диспетчер устройств с помощью фильтра устройств.

abstract void init ()

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

abstract boolean isEmulator (String serial)

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

default boolean isFileSystemMountCheckEnabled ()

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

abstract boolean isNullDevice (String serial)

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

abstract void killEmulator ( ITestDevice device)

Выключите указанный эмулятор.

abstract void launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, List<String> emulatorArgs)

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

abstract List< DeviceDescriptor > listAllDevices (boolean shortDescriptor)

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

abstract List< DeviceDescriptor > listAllDevices ()

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

abstract ITestDevice reconnectDeviceToTcp ( ITestDevice usbDevice)

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

abstract void removeDeviceMonitor ( IDeviceMonitor mon)

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

abstract void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

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

default void removeMonitoringTcpFastbootDevice (String serial)
abstract void restartAdbBridge ()

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

abstract void stopAdbBridge ()

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

abstract void terminate ()

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

abstract void terminateDeviceMonitor ()

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

abstract void terminateDeviceRecovery ()

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

default void terminateHard (String reason)

Аналогично terminateHard() .

abstract void terminateHard ()

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

abstract boolean waitForFirstDeviceAdded (long timeout)

Дождитесь подключения первого физического устройства.

Общедоступные методы

addDeviceMonitor 

public abstract void addDeviceMonitor (IDeviceMonitor mon)

Добавляет IDeviceMonitor

Параметры
mon IDeviceMonitor

addFastbootListener 

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

TODO: это немного неоптимальное решение — найдите лучшее.

addMonitoringTcpFastbootDevice 

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

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

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

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

allocateDevice 

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

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

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

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

allocateDevice 

public abstract ITestDevice allocateDevice (IDeviceSelection options)

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

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

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

allocateDevice 

public abstract ITestDevice allocateDevice ()

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

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

connectToTcpDevice 

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

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

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

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

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

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

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

disconnectFromTcpDevice 

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

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

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

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

displayDevicesInfo 

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

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

Параметры
printWriter PrintWriter : объект PrintWriter , в который будет выводиться описание.

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

executeCmdOnAvailableDevice 

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

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

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

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

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

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

Возвраты
CommandResult CommandResult .

forceAllocateDevice 

public abstract ITestDevice forceAllocateDevice (String serial)

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

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

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

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

freeDevice 

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

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

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

Параметры
device ITestDevice : бесплатный ITestDevice .

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

getAdbPath 

public abstract String getAdbPath ()

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

Возвраты
String

getAdbVersion 

public abstract String getAdbVersion ()

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

Возвраты
String

getDeviceDescriptor 

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

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

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

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

getFastbootPath 

public abstract String getFastbootPath ()

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

Возвраты
String

getShellCheckCmdTime 

public abstract long getShellCheckCmdTime ()

Получает значение таймаута в миллисекундах для команды проверки доступности оболочки.

Возвраты
long

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

public abstract void init (IDeviceSelection globalDeviceFilter, 
                List<IDeviceMonitor> deviceMonitors)

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

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

deviceMonitors List

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

public abstract void init ()

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

эмулятор 

public abstract boolean isEmulator (String serial)

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

Параметры
serial String

Возвраты
boolean

isFileSystemMountCheckEnabled 

public boolean isFileSystemMountCheckEnabled ()

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

Возвраты
boolean

isNullDevice 

public abstract boolean isNullDevice (String serial)

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

Параметры
serial String

Возвраты
boolean

killEmulator 

public abstract void killEmulator (ITestDevice device)

Выключите указанный эмулятор.

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

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

Броски
DeviceNotAvailableException если эмулятор не выключится

launchEmulator 

public abstract void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                List<String> emulatorArgs)

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

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

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

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

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

Броски
DeviceNotAvailableException если эмулятор не запускается или не подключается к сети

listAllDevices 

public abstract List<DeviceDescriptor> listAllDevices (boolean shortDescriptor)

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

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

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

listAllDevices 

public abstract List<DeviceDescriptor> listAllDevices ()

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

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

reconnectDeviceToTcp 

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

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

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

Броски
DeviceNotAvailableException если соединение с usbDevice было потеряно и не могло быть восстановлено

removeDeviceMonitor 

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

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

Параметры
mon IDeviceMonitor

removeFastbootListener 

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

removeMonitoringTcpFastbootDevice 

public void removeMonitoringTcpFastbootDevice (String serial)

Параметры
serial String

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

public abstract void restartAdbBridge ()

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

stopAdbBridge 

public abstract void stopAdbBridge ()

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

завершить 

public abstract void terminate ()

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

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

terminateDeviceMonitor 

public abstract void terminateDeviceMonitor ()

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

terminateDeviceRecovery 

public abstract void terminateDeviceRecovery ()

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

terminateHard 

public void terminateHard (String reason)

Аналогично terminateHard() .

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

terminateHard 

public abstract void terminateHard ()

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

waitForFirstDeviceAdded 

public abstract boolean waitForFirstDeviceAdded (long timeout)

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

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

Возвраты
boolean