Идевицеманажер
public interface IDeviceManager
com.android.tradefed.device.IDeviceManager |
Интерфейс управления набором доступных для тестирования устройств.
Краткое содержание
Вложенные классы | |
---|---|
interface | IDeviceManager.IFastbootListener Прослушиватель изменений состояния быстрой загрузки. |
Публичные методы | |
---|---|
abstract void | addDeviceMonitor ( IDeviceMonitor mon) Добавляет |
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) Выведите удобное для пользователя описание, содержащее список известных устройств, их состояние и значения для часто используемых параметров |
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 () Возвращает, следует ли нам проверить в |
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, а затем подключается к нему через |
abstract void | removeDeviceMonitor ( IDeviceMonitor mon) Удаляет ранее добавленный |
abstract void | removeFastbootListener ( IDeviceManager.IFastbootListener listener) Сообщает менеджеру, что прослушиватель больше не заинтересован в изменениях состояния быстрой загрузки. |
abstract void | restartAdbBridge () Перезапустите (если была вызвана |
abstract void | stopAdbBridge () Остановите мост adb, и службы зависят от подключений adb. |
abstract void | terminate () Останавливает службы мониторинга устройств и завершает работу библиотеки ddm. |
abstract void | terminateDeviceMonitor () Остановите мониторы устройств. |
abstract void | terminateDeviceRecovery () Останавливает поток восстановления устройства. |
default void | terminateHard (String reason) Как |
abstract void | terminateHard () Аналогично |
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 abstractlistAllDevices (boolean shortDescriptor)
Возвращает список DeviceDescriptors для всех известных устройств.
Параметры | |
---|---|
shortDescriptor | boolean : следует ли ограничивать дескрипторы минимумом информации. |
Возврат | |
---|---|
список DeviceDescriptor для всех известных устройств |
списокВсеУстройства
public abstractlistAllDevices ()
Возвращает список 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 |
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-12 UTC.