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

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 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) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

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

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) 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) 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

добавить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