Идевицеманажер

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


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

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

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

interface IDeviceManager.IFastbootListener

Прослушиватель изменений состояния быстрой загрузки.

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

abstract void addDeviceMonitor ( IDeviceMonitor mon)

Добавляет IDeviceMonitor

abstract void addFastbootListener ( IDeviceManager.IFastbootListener listener)

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

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

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

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)

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

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

добавитьDeviceMonitor

public abstract void addDeviceMonitor (IDeviceMonitor mon)

Добавляет IDeviceMonitor

Параметры
mon IDeviceMonitor

добавитьFastbootListener

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

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

AddMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Добавьте устройство в монитор быстрой загрузки. Монитор быстрой загрузки будет использовать 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-соединение не может быть сформировано

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

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

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

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

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

получитьFastbootPath

public abstract String getFastbootPath ()

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

Возврат
String

в этом

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

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

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

deviceMonitors

в этом

public abstract void init ()

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

isEmulator

public abstract boolean isEmulator (String serial)

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

Параметры
serial String

Возврат
boolean

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

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 для всех известных устройств

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

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

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

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

Броски
DeviceNotAvailableException если соединение с usbDevice потеряно и не подлежит восстановлению

удалитьDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

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

Параметры
mon IDeviceMonitor

удалить FastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

public abstract void restartAdbBridge ()

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

остановитьAdbBridge

public abstract void stopAdbBridge ()

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

прекратить

public abstract void terminate ()

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

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

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

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

public abstract void terminateDeviceMonitor ()

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

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

public abstract void terminateDeviceRecovery ()

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

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

public void terminateHard (String reason)

Как terminateHard() .

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

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

public abstract void terminateHard ()

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

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

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

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

Возврат
boolean