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)

Добавьте устройство в монитор fastboot.

abstract ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

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

abstract ITestDevice allocateDevice ( IDeviceSelection options)

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

abstract ITestDevice allocateDevice ()

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

abstract ITestDevice connectToTcpDevice (String ipAndPort)

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

Этот метод выделяет новое устройство, которое в конечном итоге должно быть освобождено через disconnectFromTcpDevice(com.android.tradefed.device.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 void init ( IDeviceSelection globalDeviceFilter, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, 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, emulatorArgs) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs)

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

abstract listAllDevices (boolean shortDescriptor)

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

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

abstract void restartAdbBridge ()

Перезапуск (если была вызвана stopAdbBridge() ) adb bridge и сервисы зависят от соединений 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

добавить FastbootListener

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 : серийный номер режима быстрой загрузки устройства.

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

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

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

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

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

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

public abstract ITestDevice allocateDevice (IDeviceSelection options)

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

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

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

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

public abstract ITestDevice allocateDevice ()

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

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

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

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

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

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

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

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

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

отключение от TCPDevice

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 : ERROR(/PrintWriter) для вывода описания в

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

выполнитьCmdOnAvailableDevice

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

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

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

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

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

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

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

получитьAdbPath

public abstract String getAdbPath ()

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

Возвращает
String

получитьAdbVersion

public abstract String getAdbVersion ()

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

Возвращает
String

получитьDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

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

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

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

получитьFastbootPath

public abstract String getFastbootPath ()

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

Возвращает
String

в этом

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

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

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

deviceMonitors

в этом

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

killЭмулятор

public abstract void killEmulator (ITestDevice device)

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

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

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

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

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

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

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

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

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

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

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

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

списокВсеустройства

public abstract  listAllDevices (boolean shortDescriptor)

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

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

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

списокВсеустройства

public abstract  listAllDevices ()

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

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

переподключить устройство к TCP

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 не добавлен.

Параметры
mon IDeviceMonitor

удалить FastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

public abstract void restartAdbBridge ()

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

стопAdbBridge

public abstract void stopAdbBridge ()

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

прекращать

public abstract void terminate ()

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

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

Смотрите также:

TerminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

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

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

public abstract void terminateDeviceRecovery ()

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

прекратитьжесткий

public void terminateHard (String reason)

Как и terminateHard() .

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

прекратитьжесткий

public abstract void terminateHard ()

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

ждатьForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

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

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

Возвращает
boolean