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

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Object
↳	com.android.tradefed.device.DeviceManager

---

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

Вложенные классы
class	DeviceManager.FastbootDevice Изображение устройства в режиме Fastboot.

Константы
String	UNKNOWN_DISPLAY_STRING Отображаемая строка для неизвестных свойств

Поля
protected DeviceMonitorMultiplexer	mDvcMon
protected boolean	mFastbootEnabled

Государственные строители
DeviceManager () Объект DeviceManager следует получить из GlobalConfiguration

Общедоступные методы
void	addAvailableDevice ( IDevice stubDevice)
void	addAvailableNativeDevice ( IDevice stubDevice)
void	addDeviceMonitor ( IDeviceMonitor mon) Добавляет IDeviceMonitor
void	addFastbootDevice ( DeviceManager.FastbootDevice fastbootDevice)
void	addFastbootListener ( IDeviceManager.IFastbootListener listener) Сообщает менеджеру, что слушатель заинтересован в изменениях состояния fastboot.
void	addMonitoringTcpFastbootDevice (String serial, String fastbootSerial) Добавить устройство в монитор быстрой загрузки.
ITestDevice	allocateDevice ( IDeviceSelection options, boolean isTemporary) Запросите для тестирования устройство, отвечающее определенным критериям.
ITestDevice	allocateDevice ( IDeviceSelection options) Запросите для тестирования устройство, отвечающее определенным критериям.
ITestDevice	allocateDevice () Запросите физическое устройство для тестирования.
ITestDevice	connectToTcpDevice (String ipAndPort) Подключитесь к устройству с помощью adb-over-tcp Этот метод выделяет новое устройство, которое в конечном итоге должно быть освобождено с помощью disconnectFromTcpDevice(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 для использования.
long	getShellCheckCmdTime () Получает значение таймаута в миллисекундах для команды проверки доступности оболочки.
void	init ( IDeviceSelection globalDeviceFilter, List< IDeviceMonitor > globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) Инициализируйте диспетчер устройств.
void	init ( IDeviceSelection globalDeviceFilter, List< IDeviceMonitor > 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, List<String> emulatorArgs) Вспомогательный метод для запуска эмулятора.
List< DeviceDescriptor >	listAllDevices (boolean shortDescriptor) Возвращает список DeviceDescriptors для всех известных устройств.
List< DeviceDescriptor >	listAllDevices () Возвращает список DeviceDescriptors для всех известных устройств.
ITestDevice	reconnectDeviceToTcp ( ITestDevice usbDevice) Вспомогательный метод, который переключает заданное USB-устройство в режим adb-over-tcp, а затем подключается к нему с помощью connectToTcpDevice(String) .
void	removeDeviceMonitor ( IDeviceMonitor mon) Удаляет ранее добавленный IDeviceMonitor .
void	removeFastbootListener ( IDeviceManager.IFastbootListener listener) Сообщает менеджеру, что слушатель больше не заинтересован в изменениях состояния fastboot.
void	removeMonitoringTcpFastbootDevice (String serial)
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

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

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

Параметры
stubDevice	IDevice

addAvailableNativeDevice

public void addAvailableNativeDevice (IDevice stubDevice)

Параметры
stubDevice	IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

Добавляет IDeviceMonitor

Параметры
mon	IDeviceMonitor

addFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

Параметры
fastbootDevice	DeviceManager.FastbootDevice

addFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

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

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastbootSerial)

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

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

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

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

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

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options)

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

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

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

allocateDevice

public ITestDevice allocateDevice ()

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

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

connectToTcpDevice

public ITestDevice connectToTcpDevice (String ipAndPort)

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

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

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

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

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

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

disconnectFromTcpDevice

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 : объект PrintWriter , в который будет выводиться описание.
includeStub	boolean : отображать ли также заглушки устройств.

executeCmdOnAvailableDevice

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

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

Параметры
serial	String : Серийный номер устройства.
command	String : Команда оболочки.
timeout	long : Время, необходимое для выполнения команды.
timeUnit	TimeUnit : Единица измерения времени ожидания.

Возвраты
CommandResult	CommandResult .

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Выполните команду adb, не предназначенную для конкретного устройства, например, 'adb connect'.

Возвраты
String	Стандартный вывод: если команда выполнена успешно; в противном случае: null.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

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

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

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

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

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

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

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

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

getAdbPath

public String getAdbPath ()

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

Возвраты
String

getAdbVersion

public String getAdbVersion ()

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

Возвраты
String

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

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

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

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

getFastbootPath

public String getFastbootPath ()

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

Возвраты
String

getShellCheckCmdTime

public long getShellCheckCmdTime ()

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

Возвраты
long

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

public void init (IDeviceSelection globalDeviceFilter, 
                List<IDeviceMonitor> globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

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

Параметры
globalDeviceFilter	IDeviceSelection
globalDeviceMonitors	List
deviceFactory	IManagedTestDeviceFactory

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

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

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

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

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

public void init ()

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

эмулятор

public boolean isEmulator (String serial)

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

Параметры
serial	String

Возвраты
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

Возвраты
boolean

isNullDevice

public boolean isNullDevice (String serial)

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

Параметры
serial	String

Возвраты
boolean

killEmulator

public void killEmulator (ITestDevice device)

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

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

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

Броски
DeviceNotAvailableException

launchEmulator

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

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

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

Параметры
device	ITestDevice : заполнитель ITestDevice представляющий выделенное эмуляторное устройство.
bootTimeout	long : время в миллисекундах, необходимое для загрузки эмулятора.
emulatorArgs	List : аргументы командной строки для запуска эмулятора

Броски
DeviceNotAvailableException

listAllDevices

public List<DeviceDescriptor> listAllDevices (boolean shortDescriptor)

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

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

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

listAllDevices

public List<DeviceDescriptor> listAllDevices ()

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

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

reconnectDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

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

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

Броски
DeviceNotAvailableException

removeDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

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

Параметры
mon	IDeviceMonitor

removeFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

removeMonitoringTcpFastbootDevice

public void removeMonitoringTcpFastbootDevice (String serial)

Параметры
serial	String

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

public void restartAdbBridge ()

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

stopAdbBridge

public void stopAdbBridge ()

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

завершить

public void terminate ()

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

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

terminateDeviceMonitor

public void terminateDeviceMonitor ()

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

terminateDeviceRecovery

public void terminateDeviceRecovery ()

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

terminateHard

public void terminateHard (String reason)

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

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

terminateHard

public void terminateHard ()

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

waitForFirstDeviceAdded

public boolean waitForFirstDeviceAdded (long timeout)

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

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

Возвраты
boolean