Диспетчер устройств
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 следует получить из |
Публичные методы | |
---|---|
void | addAvailableDevice (IDevice stubDevice) |
void | addDeviceMonitor ( IDeviceMonitor mon) Добавляет |
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) Выведите удобное для пользователя описание, содержащее список известных устройств, их состояние и значения для часто используемых параметров |
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 () Возвращает, следует ли нам проверить в |
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, а затем подключается к нему через |
void | removeDeviceMonitor ( IDeviceMonitor mon) Удаляет ранее добавленный |
void | removeFastbootListener ( IDeviceManager.IFastbootListener listener) Сообщает менеджеру, что прослушиватель больше не заинтересован в изменениях состояния быстрой загрузки. |
void | restartAdbBridge () Перезапустите (если была вызвана |
void | stopAdbBridge () Остановите мост adb, и службы зависят от подключений adb. |
void | terminate () Останавливает службы мониторинга устройств и завершает работу библиотеки ddm. |
void | terminateDeviceMonitor () Остановите мониторы устройств. |
void | terminateDeviceRecovery () Останавливает поток восстановления устройства. |
void | terminateHard (String reason) Как |
void | terminateHard () Аналогично |
boolean | waitForFirstDeviceAdded (long timeout) Подождите, пока не будет подключено первое физическое устройство. |
Поля
UNKNOWN_DISPLAY_STRING
public static final String UNKNOWN_DISPLAY_STRING
Отображение строки для неизвестных свойств
mDvcMon
protected DeviceMonitorMultiplexer mDvcMon
mFastbootEnabled
protected boolean mFastbootEnabled
Общественные конструкторы
Публичные методы
добавитьдоступноеустройство
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 |
списокВсеУстройства
publiclistAllDevices (boolean shortDescriptor)
Возвращает список DeviceDescriptors для всех известных устройств.
Параметры | |
---|---|
shortDescriptor | boolean : следует ли ограничивать дескрипторы минимумом информации. |
Возврат | |
---|---|
список DeviceDescriptor для всех известных устройств |
списокВсеУстройства
publiclistAllDevices ()
Возвращает список 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 |
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-09-09 UTC.