IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice

Устройство. Это может быть физическое устройство или эмулятор.

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

Константы

int CHANGE_BUILD_INFO

Изменение маски битов устройства: изменение информации о сборке.

int CHANGE_STATE

Битовая маска изменения устройства: изменение DeviceState .

String FIRST_EMULATOR_SN

Серийный номер первого подключенного эмулятора.

String MNT_DATA

String MNT_EXTERNAL_STORAGE

String MNT_ROOT

String PROP_BUILD_API_LEVEL

String PROP_BUILD_CHARACTERISTICS

String PROP_BUILD_CODENAME

String PROP_BUILD_TAGS

String PROP_BUILD_TYPE

String PROP_BUILD_VERSION

String PROP_BUILD_VERSION_NUMBER

Эта константа устарела. Используйте PROP_BUILD_API_LEVEL .

String PROP_DEBUGGABLE

String PROP_DEVICE_CPU_ABI

String PROP_DEVICE_CPU_ABI2

String PROP_DEVICE_CPU_ABI_LIST

String PROP_DEVICE_DENSITY

String PROP_DEVICE_EMULATOR_DENSITY

String PROP_DEVICE_LANGUAGE

String PROP_DEVICE_MANUFACTURER

String PROP_DEVICE_MODEL

String PROP_DEVICE_REGION

String RE_EMULATOR_SN

Регулярное выражение для серийного номера эмулятора.

String UNKNOWN_PACKAGE

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

abstract boolean arePropertiesSet ()

Возвращает true если свойства были кэшированы.

abstract void createForward (int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)

Создает переадресацию портов между локальным TCP-портом и удаленным сокетом домена Unix.

abstract void createForward (int localPort, int remotePort)

Создает переадресацию портов между локальным и удаленным портами.

default void createReverse (int remotePort, int localPort)

Создает механизм обратного переключения портов между удаленным и локальным портами.

default void executeBinderCommand (String[] parameters, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)

Выполняет команду Binder на устройстве и отправляет результат receiver .

Здесь используется exec:cmd вызовите или выполните более быструю команду abb_exec: если и операционная система устройства, и сервер ADB хоста поддерживают функцию выполнения Android Binder Bridge.

abstract void executeShellCommand (String command, IShellOutputReceiver receiver)

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

Это аналогично вызову функции executeShellCommand(command, receiver, DdmPreferences.getTimeOut()) .

abstract void executeShellCommand (String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)

Этот метод устарел. Используйте executeShellCommand(String,IShellOutputReceiver,long,TimeUnit) .

default void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)

Вариант команды executeShell, который может принимать входной поток для отправки через стандартный ввод (stdin).

default void forceStop (String applicationName)

Принудительная остановка приложения по его имени.

abstract List<String> getAbis ()

Возвращает поддерживаемые данным устройством ABI.

default ListenableFuture< AvdData > getAvdData ()

Возвращает информацию об AVD, на котором запущен эмулятор.

abstract String getAvdName ()

Возвращает имя AVD, на котором запущен эмулятор.

abstract String getAvdPath ()

Возвращает абсолютный путь к виртуальному устройству в файловой системе.

abstract Future<Integer> getBattery (long freshnessTime, TimeUnit timeUnit)

Верните уровень заряда батареи устройства с 0 до 100 процентов.

abstract Future<Integer> getBattery ()

Верните уровень заряда батареи устройства с 0 до 100 процентов.

abstract Integer getBatteryLevel (long freshnessMs)

Этот метод устарел. Используйте getBattery(long,TimeUnit)

abstract Integer getBatteryLevel ()

Этот метод устарел. Используйте getBattery()

abstract int getDensity ()

Возвращает диапазон плотности экрана устройства, считывая значение системного свойства PROP_DEVICE_DENSITY .

abstract FileListingService getFileListingService ()

Возвращает объект FileListingService для данного устройства.

default Set<String> getHardwareCharacteristics ()

Возвращает характеристики, полученные путем чтения свойства «характеристики сборки».

abstract String getLanguage ()

Возвращает язык пользователя.

default InstallMetrics getLastInstallMetrics ()

Получает информацию о последней установке на этом устройстве.

abstract String getMountPoint (String name)

Возвращает точку монтирования.

abstract Map<String, String> getProperties ()

Этот метод устарел. Используйте вместо него getSystemProperty(String) .

abstract String getProperty (String name)

Удобный метод, который пытается получить свойство с помощью getSystemProperty(String) с очень коротким временем ожидания и игнорирует исключения.

abstract String getPropertyCacheOrSync (String name)

Этот метод устарел. Используйте вместо него getSystemProperty(String) .

abstract int getPropertyCount ()

Этот метод устарел. Подробности реализации.

abstract String getPropertySync (String name)

Этот метод устарел. Используйте getSystemProperty(String)

abstract String getRegion ()

Возвращает регион пользователя.

abstract RawImage getScreenshot ()

Делает снимок экрана устройства и возвращает его в формате RawImage .

abstract RawImage getScreenshot (long timeout, TimeUnit unit)
abstract String getSerialNumber ()

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

abstract IDevice.DeviceState getState ()

Возвращает состояние устройства.

abstract SyncService getSyncService ()

Возвращает объект SyncService для отправки/получения файлов на устройство и с устройства.

abstract void installPackage (String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)

Устанавливает Android-приложение на устройство.

abstract void installPackage (String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)

Устанавливает Android-приложение на устройство.

abstract void installPackage (String packageFilePath, boolean reinstall, String... extraArgs)

Устанавливает Android-приложение на устройство.

abstract void installPackages (List<File> apks, boolean reinstall, List<String> installOptions, long timeout, TimeUnit timeoutUnit)

Устанавливает Android-приложение, состоящее из нескольких APK-файлов (один основной и 0..n разделенных пакетов).

default void installPackages (List<File> apks, boolean reinstall, List<String> installOptions)

Устанавливает Android-приложение, состоящее из нескольких APK-файлов (один основной и 0..n разделенных пакетов) с таймаутом по умолчанию.

abstract void installRemotePackage (String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)

Устанавливает пакет приложения, который был загружен во временное местоположение на устройстве.

abstract void installRemotePackage (String remoteFilePath, boolean reinstall, String... extraArgs)

Устанавливает пакет приложения, который был загружен во временное местоположение на устройстве.

abstract void installRemotePackage (String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)

Устанавливает пакет приложения, который был загружен во временное местоположение на устройстве.

default void installRemotePackages (List<String> remoteApks, boolean reinstall, List<String> installOptions, long timeout, TimeUnit timeoutUnit)

Устанавливает Android-приложение, состоящее из нескольких APK-файлов, расположенных локально на устройстве.

default void installRemotePackages (List<String> remoteApks, boolean reinstall, List<String> installOptions)

Устанавливает Android-приложение, состоящее из нескольких APK-файлов, расположенных локально на устройстве, с заданным по умолчанию временем ожидания.

abstract boolean isBootLoader ()

Возвращает значение, указывающее, находится ли устройство в режиме загрузчика.

abstract boolean isEmulator ()

Возвращает true если устройство является эмулятором.

abstract boolean isOffline ()

Возвращает значение, если устройство находится в автономном режиме.

abstract boolean isOnline ()

Возвращает значение, если устройство готово.

abstract boolean isRoot ()

Запрашивает текущий корневой статус устройства.

default void kill (String applicationName)

Завершает работу приложения по его имени.

abstract void pullFile (String remote, String local)

Извлекает один файл.

default void push (String[] local, String remote)

Перемещает несколько файлов или каталогов.

abstract void pushFile (String local, String remote)

Загружает один файл.

default SocketChannel rawBinder (String service, String[] parameters)

Запустите службу Android Binder Bridge на удаленном устройстве.

default SocketChannel rawExec (String executable, String[] parameters)

Запустите службу host:exec на удаленном устройстве.

abstract void reboot (String into)

Перезагрузите устройство.

default void removeForward (int localPort)

Удаляет переадресацию портов между локальным и удаленным портами.

default void removeForward (int localPort, int remotePort)

Этот метод устарел. Используйте removeForward(int)

default void removeForward (int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)

Этот метод устарел. Используйте removeForward(int)

abstract void removeRemotePackage (String remoteFilePath)

Удаляет файл с устройства.

default void removeReverse (int remotePort)

Удаляет переключение портов между удаленным и локальным портами.

abstract boolean root ()

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

abstract void startScreenRecorder (String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)

Запускает запись экрана на устройстве, если устройство поддерживает Feature.SCREEN_RECORD .

abstract boolean supportsFeature ( IDevice.HardwareFeature feature)

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

abstract boolean supportsFeature ( IDevice.Feature feature)

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

abstract String syncPackageToDevice (String localFilePath)

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

abstract String uninstallApp (String applicationID, String... extraArgs)

Удаляет приложение с устройства.

abstract String uninstallPackage (String packageName)

Удаляет пакет с устройства.

Константы

CHANGE_BUILD_INFO 

public static final int CHANGE_BUILD_INFO

Изменение маски битов устройства: изменение информации о сборке.

Постоянное значение: 4 (0x00000004)

ИЗМЕНЕНИЕ_СОСТОЯНИЯ 

public static final int CHANGE_STATE

Битовая маска изменения устройства: изменение DeviceState .

Постоянное значение: 1 (0x00000001)

ПЕРВЫЙ_ЭМУЛЯТОР_SN 

public static final String FIRST_EMULATOR_SN

Серийный номер первого подключенного эмулятора.

Постоянное значение: "emulator-5554"

MNT_DATA 

public static final String MNT_DATA

Постоянное значение: "ANDROID_DATA"

MNT_EXTERNAL_STORAGE 

public static final String MNT_EXTERNAL_STORAGE

Постоянное значение: "EXTERNAL_STORAGE"

MNT_ROOT 

public static final String MNT_ROOT

Постоянное значение: "ANDROID_ROOT"

PROP_BUILD_API_LEVEL 

public static final String PROP_BUILD_API_LEVEL

Постоянное значение: "ro.build.version.sdk"

PROP_BUILD_CHARACTERISTICS 

public static final String PROP_BUILD_CHARACTERISTICS

Постоянное значение: "ro.build.characteristics"

PROP_BUILD_CODENAME 

public static final String PROP_BUILD_CODENAME

Постоянное значение: "ro.build.version.codename"

PROP_BUILD_TAGS 

public static final String PROP_BUILD_TAGS

Постоянное значение: "ro.build.tags"

PROP_BUILD_TYPE 

public static final String PROP_BUILD_TYPE

Постоянное значение: "ro.build.type"

PROP_BUILD_VERSION 

public static final String PROP_BUILD_VERSION

Постоянное значение: "ro.build.version.release"

PROP_BUILD_VERSION_NUMBER 

public static final String PROP_BUILD_VERSION_NUMBER

Эта константа устарела.
Используйте PROP_BUILD_API_LEVEL .

Постоянное значение: "ro.build.version.sdk"

PROP_DEBUGGABLE 

public static final String PROP_DEBUGGABLE

Постоянное значение: "ro.debuggable"

PROP_DEVICE_CPU_ABI 

public static final String PROP_DEVICE_CPU_ABI

Постоянное значение: "ro.product.cpu.abi"

PROP_DEVICE_CPU_ABI2 

public static final String PROP_DEVICE_CPU_ABI2

Постоянное значение: "ro.product.cpu.abi2"

PROP_DEVICE_CPU_ABI_LIST 

public static final String PROP_DEVICE_CPU_ABI_LIST

Постоянное значение: "ro.product.cpu.abilist"

PROP_DEVICE_DENSITY 

public static final String PROP_DEVICE_DENSITY

Постоянное значение: "ro.sf.lcd_density"

PROP_DEVICE_EMULATOR_DENSITY 

public static final String PROP_DEVICE_EMULATOR_DENSITY

Постоянное значение: "qemu.sf.lcd_density"

PROP_DEVICE_LANGUAGE 

public static final String PROP_DEVICE_LANGUAGE

Постоянное значение: "persist.sys.language"

PROP_DEVICE_MANUFACTURER 

public static final String PROP_DEVICE_MANUFACTURER

Постоянное значение: "ro.product.manufacturer"

PROP_DEVICE_MODEL 

public static final String PROP_DEVICE_MODEL

Постоянное значение: "ro.product.model"

PROP_DEVICE_REGION 

public static final String PROP_DEVICE_REGION

Постоянное значение: "persist.sys.country"

RE_EMULATOR_SN 

public static final String RE_EMULATOR_SN

Регулярное выражение для серийного номера эмулятора.

Постоянное значение: "emulator-(\d+)"

НЕИЗВЕСТНЫЙ_ПАКЕТ 

public static final String UNKNOWN_PACKAGE

Постоянное значение: ""

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

arePropertiesSet 

public abstract boolean arePropertiesSet ()

Возвращает true если свойства были кэшированы.

Возвраты
boolean

createForward 

public abstract void createForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

Создает переадресацию портов между локальным TCP-портом и удаленным сокетом домена Unix.

Параметры
localPort int : локальный порт для переадресации

remoteSocketName String : имя сокета домена Unix, созданного на устройстве.

namespace IDevice.DeviceUnixSocketNamespace : пространство имен, в котором был создан сокет домена Unix.

Броски
AdbCommandRejectedException если adb отклонит команду
TimeoutException в случае истечения времени ожидания соединения.
IOException в случае ошибки ввода-вывода в соединении.

createForward 

public abstract void createForward (int localPort, 
                int remotePort)

Создает переадресацию портов между локальным и удаленным портами.

Параметры
localPort int : локальный порт для переадресации

remotePort int : удаленный порт.

Броски
AdbCommandRejectedException если adb отклонит команду
TimeoutException в случае истечения времени ожидания соединения.
IOException в случае ошибки ввода-вывода в соединении.

createReverse 

public void createReverse (int remotePort, 
                int localPort)

Создает механизм обратного переключения портов между удаленным и локальным портами.

Параметры
remotePort int : удаленный порт для реверсирования.

localPort int : локальный порт

Броски
AdbCommandRejectedException если adb отклонит команду
TimeoutException в случае истечения времени ожидания соединения.
IOException в случае ошибки ввода-вывода в соединении.

executeBinderCommand 

public void executeBinderCommand (String[] parameters, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

Выполняет команду Binder на устройстве и отправляет результат receiver .

Здесь используется exec:cmd вызовите или выполните более быструю команду abb_exec: если и операционная система устройства, и сервер ADB хоста поддерживают функцию выполнения Android Binder Bridge.

Параметры
parameters String : команда binder для выполнения

receiver IShellOutputReceiver : объект IShellOutputReceiver , который будет принимать вывод команды binder.

maxTimeToOutputResponse long

maxTimeUnits TimeUnit

is InputStream : необязательный входной поток для отправки через стандартный ввод.

Броски
AdbCommandRejectedException если adb отклонит команду
ShellCommandUnresponsiveException в случае, если команда binder не отправляет вывод в течение заданного времени.
TimeoutException в случае истечения времени ожидания соединения.
IOException в случае ошибки ввода-вывода в соединении.

См. также:

executeShellCommand 

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

Это аналогично вызову функции executeShellCommand(command, receiver, DdmPreferences.getTimeOut()) .

Параметры
command String : команда оболочки для выполнения

receiver IShellOutputReceiver : объект IShellOutputReceiver , который будет принимать вывод команды оболочки.

Броски
AdbCommandRejectedException если adb отклонит команду
ShellCommandUnresponsiveException в случае, если команда оболочки не выводит результат в течение заданного времени.
TimeoutException в случае истечения времени ожидания соединения.
IOException в случае ошибки ввода-вывода в соединении.

executeShellCommand 

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                int maxTimeToOutputResponse)

Этот метод устарел.
Используйте executeShellCommand(String,IShellOutputReceiver,long,TimeUnit) .

Параметры
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse int

Броски
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

executeShellCommand 

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

Вариант команды executeShell, который может принимать входной поток для отправки через стандартный ввод (stdin).

Параметры
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse long

maxTimeUnits TimeUnit

is InputStream

Броски
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

forceStop 

public void forceStop (String applicationName)

Принудительная остановка приложения по его имени. Это удалит все ожидающие оповещения и задачи, находящиеся в очереди на вычисления.

Параметры
applicationName String : название приложения

getAbis 

public abstract List<String> getAbis ()

Возвращает поддерживаемые устройством интерфейсы ABI. Интерфейсы ABI отсортированы в порядке предпочтения, при этом первый интерфейс ABI является наиболее предпочтительным.

Возвраты
List<String> список ABI.

getAvdData 

public ListenableFuture<AvdData> getAvdData ()

Возвращает информацию об AVD, на котором запущен эмулятор.

AvdData.getName — это имя AVD или null , если его нет.

AvdData.getPath — это путь к AVD или null, если это физическое устройство, подкоманда консоли эмулятора завершилась с ошибкой или версия эмулятора старше 30.0.18.

Возвраты
ListenableFuture< AvdData > Данные AvdData для устройства.

getAvdName 

public abstract String getAvdName ()

Возвращает имя AVD, на котором запущен эмулятор.

Это справедливо только в том случае, если isEmulator() возвращает true.

Если эмулятор не использует AVD (например, он запускается из исходного кода Android), этот метод вернет " <build> ".

Примечание: Если вы хотите контролировать время ожидания, предпочтительнее использовать getAvdData() .

Возвраты
String Название AVD или null , если его нет.

getAvdPath 

public abstract String getAvdPath ()

Возвращает абсолютный путь к виртуальному устройству в файловой системе. Путь зависит от операционной системы; в Linux он будет содержать разделители /, а в Windows — разделители \.

Примечание: Если вы хотите контролировать время ожидания, предпочтительнее использовать getAvdData() .

Возвраты
String Путь к AVD или значение null, если это физическое устройство, подкоманда консоли эмулятора завершилась с ошибкой или версия эмулятора старше 30.0.18.

получить батарею 

public abstract Future<Integer> getBattery (long freshnessTime, 
                TimeUnit timeUnit)

Верните уровень заряда батареи устройства с 0 до 100 процентов.

Уровень заряда батареи может храниться в кэше. Запрос уровня заряда батареи устройства выполняется только в том случае, если с момента последнего успешного запроса истекло freshnessTime .

Параметры
freshnessTime long : желаемый уровень заряда батареи

timeUnit TimeUnit : TimeUnit свежести.

Возвраты
Future<Integer> Объект Future , который можно использовать для запроса уровня заряда батареи. В случае невозможности получения уровня заряда батареи объект Future вернет исключение ExecutionException .

получить батарею 

public abstract Future<Integer> getBattery ()

Верните уровень заряда батареи устройства с 0 до 100 процентов.

Уровень заряда батареи может кэшироваться. Запрос уровня заряда батареи устройства выполняется только в том случае, если с момента последнего успешного запроса прошло 5 минут.

Возвраты
Future<Integer> Объект Future , который можно использовать для запроса уровня заряда батареи. В случае невозможности получения уровня заряда батареи объект Future вернет исключение ExecutionException .

getBatteryLevel 

public abstract Integer getBatteryLevel (long freshnessMs)

Этот метод устарел.
use getBattery(long,TimeUnit)

Верните уровень заряда батареи устройства с 0 до 100 процентов.

Уровень заряда батареи может кэшироваться. Запрос уровня заряда батареи устройства выполняется только в том случае, если с момента последнего успешного запроса истек срок действия freshnessMs ms.

Возвраты
Integer Уровень заряда батареи или null , если его не удалось получить.

Броски
com.android.ddmlib.ShellCommandUnresponsiveException
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

getBatteryLevel 

public abstract Integer getBatteryLevel ()

Этот метод устарел.
используйте getBattery()

Верните уровень заряда батареи устройства с 0 до 100 процентов.

Уровень заряда батареи может кэшироваться. Запрос уровня заряда батареи устройства выполняется только в том случае, если с момента последнего успешного запроса прошло 5 минут.

Возвраты
Integer Уровень заряда батареи или null , если его не удалось получить.

Броски
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

getDensity 

public abstract int getDensity ()

Возвращает диапазон плотности экрана устройства, считывая значение системного свойства PROP_DEVICE_DENSITY .

Возвраты
int плотность, или -1, если ее невозможно определить.

getFileListingService 

public abstract FileListingService getFileListingService ()

Возвращает объект FileListingService для данного устройства.

Возвраты
FileListingService

getHardwareCharacteristics 

public Set<String> getHardwareCharacteristics ()

Возвращает характеристики, полученные путем чтения свойства «характеристики сборки».

Возвраты
Set<String>

Броски
Exception

getLanguage 

public abstract String getLanguage ()

Возвращает язык пользователя.

Возвраты
String Язык пользователя или null, если он неизвестен.

getLastInstallMetrics 

public InstallMetrics getLastInstallMetrics ()

Получает информацию о последней установке на этом устройстве.

Возвраты
InstallMetrics Метрики InstallMetrics , описывающие процесс установки.

getMountPoint 

public abstract String getMountPoint (String name)

Возвращает точку монтирования.

Параметры
name String : имя точки монтирования, которую необходимо вернуть.

Возвраты
String

получитьСвойства 

public abstract Map<String, String> getProperties ()

Этот метод устарел.
используйте getSystemProperty(String) вместо этого.

Возвращает кэшированные свойства устройства. Содержит полный вывод команды 'getprop'.

Возвраты
Map<String, String>

получитьСвойство 

public abstract String getProperty (String name)

Удобный метод, который пытается получить свойство с помощью getSystemProperty(String) с очень коротким временем ожидания и игнорирует исключения.

Примечание: Если вы хотите контролировать время ожидания, предпочтительнее использовать getSystemProperty(String) .

Параметры
name String : имя возвращаемого значения.

Возвраты
String значение или null , если значение свойства было недоступно немедленно.

getPropertyCacheOrSync 

public abstract String getPropertyCacheOrSync (String name)

Этот метод устарел.
используйте getSystemProperty(String) вместо этого.

Комбинация методов getProperty(String) и getPropertySync(String) попытается получить свойство из кэша. Если свойство не найдено, будет предпринята синхронная попытка напрямую запросить данные с устройства и, в случае успеха, повторно заполнить кэш.

Параметры
name String : имя возвращаемого значения.

Возвраты
String значение или null , если свойство не существует

Броски
AdbCommandRejectedException если adb отклонит команду
ShellCommandUnresponsiveException в случае, если команда оболочки не выводит результат в течение заданного времени.
TimeoutException в случае истечения времени ожидания соединения.
IOException в случае ошибки ввода-вывода в соединении.

getPropertyCount 

public abstract int getPropertyCount ()

Этот метод устарел.
детали реализации

Возвращает номер свойства для данного устройства.

Возвраты
int

getPropertySync 

public abstract String getPropertySync (String name)

Этот метод устарел.
использовать getSystemProperty(String)

Вариант метода getProperty(String) , который попытается получить заданное свойство непосредственно с устройства, без использования кэша. Этот метод следует (только) использовать для любых переменных свойств.

Параметры
name String : имя возвращаемого значения.

Возвраты
String значение или null , если свойство не существует

Броски
AdbCommandRejectedException если adb отклонит команду
ShellCommandUnresponsiveException в случае, если команда оболочки не выводит результат в течение заданного времени.
TimeoutException в случае истечения времени ожидания соединения.
IOException в случае ошибки ввода-вывода в соединении.

getRegion 

public abstract String getRegion ()

Возвращает регион пользователя.

Возвраты
String регион пользователя или null, если он неизвестен.

получить скриншот 

public abstract RawImage getScreenshot ()

Делает снимок экрана устройства и возвращает его в формате RawImage .

Возвраты
RawImage Скриншот сохраняется в формате RawImage или null , если что-то пошло не так.

Броски
AdbCommandRejectedException если adb отклонит команду
TimeoutException в случае истечения времени ожидания соединения.
IOException в случае ошибки ввода-вывода в соединении.

получить скриншот 

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Параметры
timeout long

unit TimeUnit

Возвраты
RawImage

Броски
AdbCommandRejectedException
IOException
TimeoutException

getSerialNumber 

public abstract String getSerialNumber ()

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

Возвраты
String

getState 

public abstract IDevice.DeviceState getState ()

Возвращает состояние устройства.

Возвраты
IDevice.DeviceState

getSyncService 

public abstract SyncService getSyncService ()

Возвращает объект SyncService для отправки/получения файлов на устройство и с устройства.

Возвраты
SyncService null , если SyncService создать не удалось. Это может произойти, если adb откажется открыть соединение, потому что IDevice недействителен (или был отключен).

Броски
AdbCommandRejectedException если adb отклонит команду
TimeoutException в случае истечения времени ожидания соединения.
IOException если соединение с adb не удалось.

установить пакет 

public abstract void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

Устанавливает Android-приложение на устройство. Это вспомогательный метод, объединяющий шаги syncPackageToDevice, installRemotePackage и removePackage.

Параметры
packageFilePath String : абсолютный путь к файлу в локальной системе для установки.

reinstall boolean : установите значение true , если необходимо выполнить переустановку приложения.

receiver InstallReceiver : InstallReceiver , используемый для мониторинга установки и получения окончательного статуса.

extraArgs String : необязательные дополнительные аргументы для передачи. См. 'adb shell pm install --help' для получения информации о доступных параметрах.

Броски
InstallException если установка не удастся.

установить пакет 

public abstract void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

Устанавливает Android-приложение на устройство. Это вспомогательный метод, объединяющий шаги syncPackageToDevice, installRemotePackage и removePackage.

Параметры
packageFilePath String : абсолютный путь к файлу в локальной системе для установки.

reinstall boolean : установите значение true , если необходимо выполнить переустановку приложения.

receiver InstallReceiver : InstallReceiver , используемый для мониторинга установки и получения окончательного статуса.

maxTimeout long : максимальный таймаут, в течение которого команда должна завершиться. Значение 0 означает, что максимальный таймаут применяться не будет.

maxTimeToOutputResponse long : максимальное время, в течение которого команда может не выдавать никакого ответа. Значение 0 означает, что метод будет ждать вывода команды бесконечно (пока receiver не отменит выполнение) и никогда не выдаст исключение.

maxTimeUnits TimeUnit : Единицы измерения для ненулевых значений maxTimeout и maxTimeToOutputResponse .

extraArgs String : необязательные дополнительные аргументы для передачи. См. 'adb shell pm install --help' для получения информации о доступных параметрах.

Броски
InstallException если установка не удастся.

установить пакет 

public abstract void installPackage (String packageFilePath, 
                boolean reinstall, 
                String... extraArgs)

Устанавливает Android-приложение на устройство. Это вспомогательный метод, объединяющий шаги syncPackageToDevice, installRemotePackage и removePackage.

Параметры
packageFilePath String : абсолютный путь к файлу в локальной системе для установки.

reinstall boolean : установите значение true , если необходимо выполнить переустановку приложения.

extraArgs String : необязательные дополнительные аргументы для передачи. См. 'adb shell pm install --help' для получения информации о доступных параметрах.

Броски
InstallException если установка не удастся.

установить пакеты 

public abstract void installPackages (List<File> apks, 
                boolean reinstall, 
                List<String> installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

Устанавливает Android-приложение, состоящее из нескольких APK-файлов (один основной и 0..n разделенных пакетов).

Параметры
apks List : список APK-файлов для установки (1 основной APK + 0..n разделенных APK-файлов)

reinstall boolean : установите значение true , если необходимо выполнить переустановку приложения.

installOptions List : необязательные дополнительные аргументы для передачи. См. 'adb shell pm install --help' для получения информации о доступных параметрах.

timeout long : время ожидания установки

timeoutUnit TimeUnit : TimeUnit соответствующая параметру таймаута.

Броски
InstallException если установка не удастся.

установить пакеты 

public void installPackages (List<File> apks, 
                boolean reinstall, 
                List<String> installOptions)

Устанавливает Android-приложение, состоящее из нескольких APK-файлов (один основной и 0..n разделенных пакетов) с таймаутом по умолчанию.

Параметры
apks List : список APK-файлов для установки (1 основной APK + 0..n разделенных APK-файлов)

reinstall boolean : установите значение true , если необходимо выполнить переустановку приложения.

installOptions List : необязательные дополнительные аргументы для передачи. См. 'adb shell pm install --help' для получения информации о доступных параметрах.

Броски
InstallException если установка не удастся.

installRemotePackage 

public abstract void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

Устанавливает пакет приложения, который был загружен во временное местоположение на устройстве.

Параметры
remoteFilePath String : абсолютный путь к файлу пакета на устройстве

reinstall boolean : установите значение true , если необходимо выполнить переустановку приложения.

receiver InstallReceiver : InstallReceiver , используемый для мониторинга установки и получения окончательного статуса.

extraArgs String : необязательные дополнительные аргументы для передачи. См. 'adb shell pm install --help' для получения информации о доступных параметрах.

Броски
InstallException если установка не удастся.

installRemotePackage 

public abstract void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                String... extraArgs)

Устанавливает пакет приложения, который был загружен во временное местоположение на устройстве.

Параметры
remoteFilePath String : абсолютный путь к файлу пакета на устройстве

reinstall boolean : установите значение true , если необходимо выполнить переустановку приложения.

extraArgs String : необязательные дополнительные аргументы для передачи. См. 'adb shell pm install --help' для получения информации о доступных параметрах.

Броски
InstallException если установка не удастся.

installRemotePackage 

public abstract void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

Устанавливает пакет приложения, который был загружен во временное местоположение на устройстве.

Параметры
remoteFilePath String : абсолютный путь к файлу пакета на устройстве

reinstall boolean : установите значение true , если необходимо выполнить переустановку приложения.

receiver InstallReceiver : InstallReceiver , используемый для мониторинга установки и получения окончательного статуса.

maxTimeout long : максимальный таймаут, в течение которого команда должна завершиться. Значение 0 означает, что максимальный таймаут применяться не будет.

maxTimeToOutputResponse long : максимальное время, в течение которого команда может не выдавать никакого ответа. Значение 0 означает, что метод будет ждать вывода команды бесконечно (пока receiver не отменит выполнение) и никогда не выдаст исключение.

maxTimeUnits TimeUnit : Единицы измерения для ненулевых значений maxTimeout и maxTimeToOutputResponse .

extraArgs String : необязательные дополнительные аргументы для передачи. См. 'adb shell pm install --help' для получения информации о доступных параметрах.

Броски
InstallException если установка не удастся.

installRemotePackages 

public void installRemotePackages (List<String> remoteApks, 
                boolean reinstall, 
                List<String> installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

Устанавливает Android-приложение, состоящее из нескольких APK-файлов, расположенных локально на устройстве.

Параметры
remoteApks List : перечень путей к APK-файлам, находящимся на устройстве и доступным для установки.

reinstall boolean : установите значение true , если необходимо выполнить переустановку приложения.

installOptions List : необязательные дополнительные аргументы для передачи. См. 'adb shell pm install --help' для получения информации о доступных параметрах.

timeout long : время ожидания установки

timeoutUnit TimeUnit : TimeUnit соответствующая параметру таймаута.

Броски
InstallException если установка не удастся.

installRemotePackages 

public void installRemotePackages (List<String> remoteApks, 
                boolean reinstall, 
                List<String> installOptions)

Устанавливает Android-приложение, состоящее из нескольких APK-файлов, расположенных локально на устройстве, с заданным по умолчанию временем ожидания.

Параметры
remoteApks List : список путей к APK-файлам на устройстве для установки.

reinstall boolean : установите значение true , если необходимо выполнить переустановку приложения.

installOptions List : необязательные дополнительные аргументы для передачи. См. 'adb shell pm install --help' для получения информации о доступных параметрах.

Броски
InstallException если установка не удастся.

isBootLoader 

public abstract boolean isBootLoader ()

Возвращает значение, указывающее, находится ли устройство в режиме загрузчика.

Возвраты
boolean true , если getState() возвращает DeviceState.BOOTLOADER .

эмулятор 

public abstract boolean isEmulator ()

Возвращает true если устройство является эмулятором.

Возвраты
boolean

isOffline 

public abstract boolean isOffline ()

Возвращает значение, если устройство находится в автономном режиме.

Возвраты
boolean true если getState() возвращает DeviceState.OFFLINE .

isOnline 

public abstract boolean isOnline ()

Возвращает значение, если устройство готово.

Возвраты
boolean true если getState() возвращает DeviceState.ONLINE .

isRoot 

public abstract boolean isRoot ()

Запрашивает текущий корневой статус устройства. Дополнительную информацию см. в разделе "adb root".

Возвраты
boolean Возвращает true, если демон adb запущен от имени root, в противном случае — false.

Броски
AdbCommandRejectedException если adb отклонит команду.
TimeoutException в случае истечения времени ожидания соединения.
IOException
ShellCommandUnresponsiveException

убийство 

public void kill (String applicationName)

Завершает работу приложения по его имени. При этом уничтожаются только активности, а состояние приложения в системе Android остается неизменным.

Параметры
applicationName String : название приложения

pullFile 

public abstract void pullFile (String remote, 
                String local)

Извлекает один файл.

Параметры
remote String : полный путь к удаленному файлу

local String : Локальный адрес назначения.

Броски
AdbCommandRejectedException если adb отклонит команду
SyncException в случае ошибки синхронизации.
TimeoutException в случае превышения времени ожидания при чтении ответов с устройства.
IOException в случае возникновения ошибки ввода-вывода.

толкать 

public void push (String[] local, 
                String remote)

Перемещает несколько файлов или каталогов.

Параметры
local String : локальные файлы для отправки

remote String : удаленный путь, представляющий собой каталог.

Броски
AdbCommandRejectedException если adb отклонит команду
SyncException если некоторые файлы не удалось отправить
TimeoutException в случае превышения времени ожидания при чтении ответов от устройства
IOException в случае ошибки ввода-вывода в соединении

pushFile 

public abstract void pushFile (String local, 
                String remote)

Загружает один файл.

Параметры
local String : локальный путь к файлу.

remote String : путь к удаленному файлу

Броски
AdbCommandRejectedException если adb отклонит команду
SyncException если файл не удалось отправить
TimeoutException в случае превышения времени ожидания при чтении ответов от устройства
IOException в случае ошибки ввода-вывода в соединении

rawBinder 

public SocketChannel rawBinder (String service, 
                String[] parameters)

Вызовите службу Android Binder Bridge на удаленном устройстве. Верните сокетный канал, подключенный к команде привязки устройства.

Права собственности на SocketChannel переходят к вызывающей стороне, и его необходимо явно закрыть после использования.

Параметры
service String : имя службы Android, к которой нужно подключиться.

parameters String : параметры команды binder

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

Броски
AdbCommandRejectedException
IOException
TimeoutException

rawExec 

public SocketChannel rawExec (String executable, 
                String[] parameters)

Вызовите службу host:exec на удаленном устройстве. Верните канал сокета, подключенный к выполняющемуся процессу. Обратите внимание, что служба exec не различает стандартный вывод (stdout) и стандартную ошибку (stderr), поэтому все, что читается из сокета, может поступать из любого из этих источников и чередоваться.

Права собственности на SocketChannel переходят к вызывающей стороне, и его необходимо явно закрыть после использования.

Параметры
executable String

parameters String

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

Броски
AdbCommandRejectedException
IOException
TimeoutException

перезагрузить 

public abstract void reboot (String into)

Перезагрузите устройство.

Параметры
into String : имя загрузчика, в который следует перезагрузиться, или null для перезагрузки устройства.

Броски
AdbCommandRejectedException если adb отклонит команду
TimeoutException в случае истечения времени ожидания соединения.
java.io.IOException
IOException

удалитьПереадресацию 

public void removeForward (int localPort)

Удаляет переадресацию портов между локальным и удаленным портами.

Параметры
localPort int : локальный порт для переадресации

Броски
AdbCommandRejectedException если adb отклонит команду
TimeoutException в случае истечения времени ожидания соединения.
IOException в случае ошибки ввода-вывода в соединении.

удалитьПереадресацию 

public void removeForward (int localPort, 
                int remotePort)

Этот метод устарел.
Используйте removeForward(int)

Параметры
localPort int

remotePort int

Броски
AdbCommandRejectedException
IOException
TimeoutException

удалитьПереадресацию 

public void removeForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

Этот метод устарел.
Используйте removeForward(int)

Параметры
localPort int

remoteSocketName String

namespace IDevice.DeviceUnixSocketNamespace

Броски
AdbCommandRejectedException
IOException
TimeoutException

removeRemotePackage 

public abstract void removeRemotePackage (String remoteFilePath)

Удаляет файл с устройства.

Параметры
remoteFilePath String : путь к файлу на устройстве, который нужно удалить.

Броски
InstallException если установка не удастся.

removeReverse 

public void removeReverse (int remotePort)

Удаляет переключение портов между удаленным и локальным портами.

Параметры
remotePort int : удаленный порт.

Броски
AdbCommandRejectedException если adb отклонит команду
TimeoutException в случае истечения времени ожидания соединения.
IOException в случае ошибки ввода-вывода в соединении.

корень 

public abstract boolean root ()

Запросите у демона adb права root на устройстве. Это может завершиться незаметно для пользователя и может быть успешно выполнено только в сборках для разработчиков. Дополнительную информацию см. в разделе "adb root".

Возвраты
boolean Возвращает true, если демон adb запущен от имени root, в противном случае — false.

Броски
AdbCommandRejectedException если adb отклонит команду.
ShellCommandUnresponsiveException если невозможно получить информацию о корневом статусе.
TimeoutException в случае истечения времени ожидания соединения.
java.io.IOException
IOException

startScreenRecorder 

public abstract void startScreenRecorder (String remoteFilePath, 
                ScreenRecorderOptions options, 
                IShellOutputReceiver receiver)

Запускает запись экрана на устройстве, если устройство поддерживает Feature.SCREEN_RECORD .

Параметры
remoteFilePath String

options ScreenRecorderOptions

receiver IShellOutputReceiver

Броски
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

поддерживает функцию 

public abstract boolean supportsFeature (IDevice.HardwareFeature feature)

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

Параметры
feature IDevice.HardwareFeature

Возвраты
boolean

поддерживает функцию 

public abstract boolean supportsFeature (IDevice.Feature feature)

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

Параметры
feature IDevice.Feature

Возвраты
boolean

syncPackageToDevice 

public abstract String syncPackageToDevice (String localFilePath)

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

Параметры
localFilePath String : абсолютный путь к файлу на локальном компьютере

Возвраты
String String путь назначения файла на устройстве

Броски
AdbCommandRejectedException если adb отклонит команду
SyncException если во время отправки пакета на устройство произойдет ошибка.
TimeoutException в случае истечения времени ожидания соединения.
IOException в случае ошибки ввода-вывода в соединении.

удалить приложение 

public abstract String uninstallApp (String applicationID, 
                String... extraArgs)

Удаляет приложение с устройства.

Параметры
applicationID String : идентификатор приложения Android, которое нужно удалить.

extraArgs String : необязательные дополнительные аргументы для передачи. См. 'adb shell pm install --help' для получения информации о доступных параметрах.

Возвраты
String String с кодом ошибки или null в случае успеха.

Броски
InstallException если удаление не удастся.

удалить пакет 

public abstract String uninstallPackage (String packageName)

Удаляет пакет с устройства.

Параметры
packageName String : идентификатор приложения Android, которое нужно удалить.

Возвраты
String String с кодом ошибки или null в случае успеха.

Броски
InstallException если удаление не удастся.