IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice

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

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

Константы

int CHANGE_BUILD_INFO

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

int CHANGE_CLIENT_LIST

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

int CHANGE_PROFILEABLE_CLIENT_LIST

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

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.

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

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

abstract void executeShellCommand (String command, IShellOutputReceiver receiver)

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

Это похоже на вызов executeShellCommand(command, receiver, DdmPreferences.getTimeOut()) .

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

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

default void forceStop (String applicationName)

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

abstract getAbis ()

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

default ListenableFuture< AvdData > getAvdData ()

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

abstract String getAvdName ()

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

abstract String getAvdPath ()

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

abstract getBattery (long freshnessTime, TimeUnit timeUnit)

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

abstract getBattery ()

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

abstract Integer getBatteryLevel (long freshnessMs)

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

abstract Integer getBatteryLevel ()

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

abstract Client getClient (String applicationName)

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

abstract String getClientName (int pid)

Возвращает имя клиента по pid или null , если pid неизвестен

abstract Client[] getClients ()

Возвращает массив клиентов.

abstract int getDensity ()

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

abstract FileListingService getFileListingService ()

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

default getHardwareCharacteristics ()

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

abstract String getLanguage ()

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

default InstallMetrics getLastInstallMetrics ()

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

abstract String getMountPoint (String name)

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

default ProfileableClient[] getProfileableClients ()

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

abstract getProperties ()

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

abstract String getProperty (String name)

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

abstract String getPropertyCacheOrSync (String name)

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

abstract int getPropertyCount ()

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

abstract String getPropertySync (String name)

Этот метод устарел. Используйте IShellEnabledDevice.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 boolean hasClients ()

Возвращает, есть ли у IDevice Client .

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, InstallReceiver receiver, String... extraArgs)

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

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

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

default void installPackages ( apks, boolean reinstall, installOptions)

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

abstract void installPackages ( apks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)

Устанавливает приложение 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 ( remoteApks, boolean reinstall, installOptions)

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

default void installRemotePackages ( remoteApks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)

Устанавливает приложение 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)

Запускает запись экрана на устройстве, если устройство поддерживает IDevice.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_CLIENT_LIST

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

Постоянное значение: 2 (0x00000002)

CHANGE_PROFILEABLE_CLIENT_LIST 

public static final int CHANGE_PROFILEABLE_CLIENT_LIST

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

Постоянное значение: 8 (0x00000008)

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

public static final int CHANGE_STATE

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

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

FIRST_EMULATOR_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.

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

createForward 

public abstract void createForward (int localPort, 
                int remotePort)

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

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

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

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

createReverse 

public void createReverse (int remotePort, 
                int localPort)

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

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

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

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

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 : команда компоновщика для выполнения

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

maxTimeToOutputResponse long

maxTimeUnits TimeUnit

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

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

Смотрите также:

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
ShellCommandUnresponsiveException
TimeoutException

executeShellCommand 

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

Это похоже на вызов executeShellCommand(command, receiver, DdmPreferences.getTimeOut()) .

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

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

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

executeShellCommand 

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

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

Параметры
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse int

Броски
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

forceStop 

public void forceStop (String applicationName)

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

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

getAbis 

public abstract  getAbis ()

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

Возврат
список ABI.

получитьAvdData 

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 , если такового нет.

получитьAvdPath 

public abstract String getAvdPath ()

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

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

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

getBattery 

public abstract  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

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

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

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

timeUnit TimeUnit : ERROR(/TimeUnit) свежести

Возврат
ERROR(/Future) , который можно использовать для запроса уровня заряда батареи. Future вернет ERROR(/ExecutionException) , если уровень заряда батареи не удалось получить.

getBattery 

public abstract  getBattery ()

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

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

Возврат
ERROR(/Future) , который можно использовать для запроса уровня заряда батареи. Future вернет ERROR(/ExecutionException) , если уровень заряда батареи не удалось получить.

получитьУровеньБатарейки 

public abstract Integer getBatteryLevel (long freshnessMs)

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

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

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

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

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

получитьУровеньБатарейки 

public abstract Integer getBatteryLevel ()

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

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

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

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

Броски
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

получитьКлиент 

public abstract Client getClient (String applicationName)

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

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

Возврат
Client объект Client или null , если совпадений не найдено.

getClientName 

public abstract String getClientName (int pid)

Возвращает имя клиента по pid или null , если pid неизвестен

Параметры
pid int : pid клиента.

Возврат
String

получитьКлиенты 

public abstract Client[] getClients ()

Возвращает массив клиентов.

Возврат
Client[]

получитьПлотность 

public abstract int getDensity ()

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

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

getFileListingService 

public abstract FileListingService getFileListingService ()

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

Возврат
FileListingService

getHardwareCharacteristics 

public  getHardwareCharacteristics ()

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

Возврат

получитьЯзык 

public abstract String getLanguage ()

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

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

getLastInstallMetrics 

public InstallMetrics getLastInstallMetrics ()

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

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

getMountPoint 

public abstract String getMountPoint (String name)

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

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

Возврат
String

Смотрите также:

getProfileableClients 

public ProfileableClient[] getProfileableClients ()

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

Возврат
ProfileableClient[]

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

public abstract  getProperties ()

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

Возвращает кэшированные свойства устройства. Содержит все выходные данные функции getprop.

Возврат

получитьПроперти 

public abstract String getProperty (String name)

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

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

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

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

getPropertyCacheOrSync 

public abstract String getPropertyCacheOrSync (String name)

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

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

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

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

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

получитьPropertyCount 

public abstract int getPropertyCount ()

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

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

Возврат
int

getPropertySync 

public abstract String getPropertySync (String name)

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

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

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

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

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

получитьРегион 

public abstract String getRegion ()

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

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

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

public abstract RawImage getScreenshot ()

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

Возврат
RawImage снимок экрана как RawImage или null , если что-то пошло не так.

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

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

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Параметры
timeout long

unit TimeUnit

Возврат
RawImage

Броски
AdbCommandRejectedException
TimeoutException

получить серийный номер 

public abstract String getSerialNumber ()

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

Возврат
String

получитьСостояние 

public abstract IDevice.DeviceState getState ()

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

Возврат
IDevice.DeviceState

getSyncService 

public abstract SyncService getSyncService ()

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

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

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

hasClients 

public abstract boolean hasClients ()

Возвращает, есть ли у IDevice Client .

Возврат
boolean

installPackage 

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 если установка не удалась.

installPackage 

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 если установка не удалась.

installPackage 

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 если установка не удалась.

installPackages 

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions)

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

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

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

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

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

installPackages 

public abstract void installPackages ( apks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

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

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

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

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

timeoutUnit TimeUnit : ERROR(/TimeUnit) , соответствующая параметру тайм-аута

Броски
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 ( remoteApks, 
                boolean reinstall, 
                 installOptions)

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

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

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

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

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

installRemotePackages 

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

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

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

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

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

timeoutUnit TimeUnit : ERROR(/TimeUnit) , соответствующая параметру тайм-аута

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

isBootLoader 

public abstract boolean isBootLoader ()

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

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

isEmulator 

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 ()

Запрашивает текущий статус root-доступа устройства. Подробнее см. в разделе «adb root».

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

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

убийство 

public void kill (String applicationName)

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

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

pullFile 

public abstract void pullFile (String remote, 
                String local)

Тянет один файл.

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

local String : Местный пункт назначения.

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

толкать 

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

Отправка нескольких файлов или каталогов.

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

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

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

pushFile 

public abstract void pushFile (String local, 
                String remote)

Выталкивает один файл.

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

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

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

rawBinder 

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

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

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

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

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

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

Броски
AdbCommandRejectedException
TimeoutException

rawExec 

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

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

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

Параметры
executable String

parameters String

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

Броски
AdbCommandRejectedException
TimeoutException

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

public abstract void reboot (String into)

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

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

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

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

public void removeForward (int localPort)

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

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

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

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

public void removeForward (int localPort, 
                int remotePort)

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

Параметры
localPort int

remotePort int

Броски
AdbCommandRejectedException
TimeoutException

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

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

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

Параметры
localPort int

remoteSocketName String

namespace IDevice.DeviceUnixSocketNamespace

Броски
AdbCommandRejectedException
TimeoutException

removeRemotePackage 

public abstract void removeRemotePackage (String remoteFilePath)

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

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

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

удалитьОбратный 

public void removeReverse (int remotePort)

Удаляет обратный порт между удаленным и локальным портом.

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

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

корень 

public abstract boolean root ()

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

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

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

startScreenRecorder 

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

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

Параметры
remoteFilePath String

options ScreenRecorderOptions

receiver IShellOutputReceiver

Броски
AdbCommandRejectedException
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 пути назначения на устройстве для файла

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

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

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

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

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

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

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

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

uninstallPackage 

public abstract String uninstallPackage (String packageName)

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

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

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

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