DeviceImpl

public final class DeviceImpl
extends Object implements IDevice

java.lang.Object
com.android.tradefed.device.server.DeviceImpl


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

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

Государственные строители

DeviceImpl (String serialNumber, IDevice.DeviceState deviceState)

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

boolean arePropertiesSet ()

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

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

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

void createForward (int localPort, int remotePort)

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

void createReverse (int remotePort, int localPort)

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

void executeShellCommand (String command, IShellOutputReceiver receiver)

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

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

void executeShellCommand (String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)
void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

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

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

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

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

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

void forceStop (String applicationName)

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

List<String> getAbis ()

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

ListenableFuture< AvdData > getAvdData ()

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

String getAvdName ()

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

String getAvdPath ()

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

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

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

Future<Integer> getBattery ()

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

Integer getBatteryLevel (long freshnessMs)

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

Integer getBatteryLevel ()

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

int getDensity ()

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

FileListingService getFileListingService ()

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

String getLanguage ()

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

InstallMetrics getLastInstallMetrics ()

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

String getMountPoint (String name)

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

String getName ()

Возвращает (очеловеченное) название для этого устройства.

Map<String, String> getProperties ()

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

String getProperty (String name)

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

String getPropertyCacheOrSync (String name)

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

int getPropertyCount ()

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

String getPropertySync (String name)

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

String getRegion ()

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

static String getScreenRecorderCommand (String remoteFilePath, ScreenRecorderOptions options)
RawImage getScreenshot ()

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

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

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

IDevice.DeviceState getState ()

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

SyncService getSyncService ()

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

ListenableFuture<String> getSystemProperty (String name)

Выполните потенциально асинхронный запрос к системному свойству.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

boolean isBootLoader ()

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

boolean isEmulator ()

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

boolean isOffline ()

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

boolean isOnline ()

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

boolean isRoot ()

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

void kill (String applicationName)

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

void pullFile (String remote, String local)

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

void push (String[] local, String remote)

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

void pushFile (String local, String remote)

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

SocketChannel rawBinder (String service, String[] parameters)

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

SocketChannel rawExec (String executable, String[] parameters)

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

void reboot (String into)

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

void removeForward (int localPort)

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

void removeRemotePackage (String remoteFilePath)

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

void removeReverse (int remotePort)

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

boolean root ()

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

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

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

boolean supportsFeature ( IDevice.HardwareFeature feature)

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

boolean supportsFeature ( IDevice.Feature feature)

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

String syncPackageToDevice (String localFilePath)

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

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

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

String uninstallPackage (String packageName)

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

Государственные строители

DeviceImpl

public DeviceImpl (String serialNumber, 
                IDevice.DeviceState deviceState)

Параметры
serialNumber String

deviceState IDevice.DeviceState

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

arePropertiesSet

public boolean arePropertiesSet ()

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

Возвраты
boolean

createForward

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

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

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

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

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

Броски
AdbCommandRejectedException
IOException
TimeoutException

createForward

public void createForward (int localPort, 
                int remotePort)

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

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

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

Броски
AdbCommandRejectedException
IOException
TimeoutException

createReverse

public void createReverse (int remotePort, 
                int localPort)

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

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

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

Броски
AdbCommandRejectedException
IOException
TimeoutException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

Броски
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

executeShellCommand

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

Параметры
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse int

Броски
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

executeShellCommand

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

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

maxTimeToOutputResponse используется в качестве максимального времени ожидания при получении выходных данных команды от устройства.
Если команда оболочки не выводит ничего в течение периода времени, превышающего maxTimeToOutputResponse , то метод выбросит исключение ShellCommandUnresponsiveException .

Для таких команд, как вывод в лог, следует использовать значение maxTimeToOutputResponse , равное 0, что означает, что метод никогда не выдаст исключение и будет блокироваться до тех пор, пока метод IShellOutputReceiver.isCancelled() получателя не вернет true .

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

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

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

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

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

Броски
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

executeShellCommand

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

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

maxTimeToOutputResponse используется в качестве максимального времени ожидания при получении выходных данных команды от устройства.
Если команда оболочки не выводит ничего в течение периода времени, превышающего maxTimeToOutputResponse , то метод выбросит исключение ShellCommandUnresponsiveException .

Для таких команд, как вывод в лог, следует использовать значение maxTimeToOutputResponse , равное 0, что означает, что метод никогда не выдаст исключение и будет блокироваться до тех пор, пока метод IShellOutputReceiver.isCancelled() получателя не вернет true .

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

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

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

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

Броски
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

forceStop

public void forceStop (String applicationName)

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

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

getAbis

public 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 String getAvdName ()

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

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

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

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

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

getAvdPath

public String getAvdPath ()

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

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

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

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

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

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

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

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

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

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

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

public Future<Integer> getBattery ()

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

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

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

getBatteryLevel

public Integer getBatteryLevel (long freshnessMs)

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

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

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

getBatteryLevel

public Integer getBatteryLevel ()

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

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

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

getDensity

public int getDensity ()

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

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

getFileListingService

public FileListingService getFileListingService ()

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

Возвраты
FileListingService

getLanguage

public String getLanguage ()

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

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

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

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

getMountPoint

public String getMountPoint (String name)

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

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

Возвраты
String

getName

public String getName ()

Возвращает (удобочитаемое) имя для этого устройства. Обычно это имя AVD для устройств AVD и комбинация названия производителя, названия модели и серийного номера для устройств.

Возвраты
String

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

public Map<String, String> getProperties ()

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

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

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

public String getProperty (String name)

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

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

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

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

getPropertyCacheOrSync

public String getPropertyCacheOrSync (String name)

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

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

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

getPropertyCount

public int getPropertyCount ()

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

Возвраты
int

getPropertySync

public String getPropertySync (String name)

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

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

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

getRegion

public String getRegion ()

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

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

getScreenRecorderCommand

public static String getScreenRecorderCommand (String remoteFilePath, 
                ScreenRecorderOptions options)

Параметры
remoteFilePath String

options ScreenRecorderOptions

Возвраты
String

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

public RawImage getScreenshot ()

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

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

Броски
AdbCommandRejectedException
IOException
TimeoutException

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

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Параметры
timeout long

unit TimeUnit

Возвраты
RawImage

Броски
AdbCommandRejectedException
IOException
TimeoutException

getSerialNumber

public String getSerialNumber ()

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

Возвраты
String

getState

public IDevice.DeviceState getState ()

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

Возвраты
IDevice.DeviceState

getSyncService

public SyncService getSyncService ()

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

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

Броски
AdbCommandRejectedException
IOException
TimeoutException

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

public ListenableFuture<String> getSystemProperty (String name)

Выполните потенциально асинхронный запрос к системному свойству.

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

Возвраты
ListenableFuture<String> ListenableFuture. get может вернуть null.

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

public 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 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 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 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 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 void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                String... extraArgs)

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

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

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

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

Броски
InstallException

installRemotePackage

public 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 boolean isBootLoader ()

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

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

эмулятор

public boolean isEmulator ()

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

Возвраты
boolean

isOffline

public boolean isOffline ()

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

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

isOnline

public boolean isOnline ()

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

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

isRoot

public boolean isRoot ()

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

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

Броски
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

убийство

public void kill (String applicationName)

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

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

pullFile

public void pullFile (String remote, 
                String local)

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

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

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

Броски
AdbCommandRejectedException
IOException
SyncException
TimeoutException

толкать

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

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

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

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

Броски
AdbCommandRejectedException
IOException
SyncException
TimeoutException

pushFile

public void pushFile (String local, 
                String remote)

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

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

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

Броски
AdbCommandRejectedException
IOException
SyncException
TimeoutException

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 void reboot (String into)

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

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

Броски
AdbCommandRejectedException
IOException
TimeoutException

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

public void removeForward (int localPort)

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

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

Броски
AdbCommandRejectedException
IOException
TimeoutException

removeRemotePackage

public void removeRemotePackage (String remoteFilePath)

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

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

Броски
InstallException

removeReverse

public void removeReverse (int remotePort)

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

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

Броски
AdbCommandRejectedException
IOException
TimeoutException

корень

public boolean root ()

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

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

Броски
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

startScreenRecorder

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

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

Параметры
remoteFilePath String

options ScreenRecorderOptions

receiver IShellOutputReceiver

Броски
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

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

public boolean supportsFeature (IDevice.HardwareFeature feature)

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

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

Возвраты
boolean

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

public boolean supportsFeature (IDevice.Feature feature)

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

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

Возвраты
boolean

syncPackageToDevice

public String syncPackageToDevice (String localFilePath)

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

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

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

Броски
AdbCommandRejectedException
IOException
SyncException
TimeoutException

toString

public String toString ()

Возвраты
String

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

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

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

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

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

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

Броски
InstallException

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

public String uninstallPackage (String packageName)

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

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

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

Броски
InstallException