IDeviceManager

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)

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

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)

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

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)

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

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)

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

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

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

addMonitoringTcpFastbootDevice 

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Добавьте устройство в Fastboot Monitor. Fastboot Monitor будет использовать порт 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(com.android.tradefed.device.ITestDevice)

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

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

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

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

отключитьFromTcpDevice 

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

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

получитьAdbPath 

public abstract String getAdbPath ()

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

Возврат
String

getAdbVersion 

public abstract String getAdbVersion ()

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

Возврат
String

получитьDeviceDescriptor 

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

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

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

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

getFastbootPath 

public abstract String getFastbootPath ()

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

Возврат
String

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

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

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

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

deviceMonitors

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

public abstract void init ()

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

isEmulator 

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

removeDeviceMonitor 

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

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

Параметры
mon IDeviceMonitor

removeFastbootListener 

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

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