Начиная с 2026 года, в соответствии с нашей моделью стабильной разработки основной ветки и для обеспечения стабильности платформы для экосистемы, мы будем публиковать исходный код в AOSP во 2-м и 4-м кварталах. Для сборки и внесения вклада в AOSP мы рекомендуем использовать android-latest-release вместо aosp-main . Ветка манифеста android-latest-release всегда будет ссылаться на самый последний релиз, выпущенный в AOSP. Для получения дополнительной информации см. раздел «Изменения в AOSP» .

Эта страница переведена с помощью Cloud Translation API.

DeviceImpl

public final class DeviceImpl
extends Object implements IDevice

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

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

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

Публичные конструкторы
`DeviceImpl ( ClientTracker clientTracer, 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`	`executeBinderCommand (String[] parameters, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)` Выполняет команду Binder на устройстве и отправляет результат `receiver` . Здесь используется exec:cmd вызовите или быстрее abb_exec: если и ОС устройства, и сервер ADB хоста поддерживают функцию выполнения Android Binder Bridge.
`void`	`executeShellCommand (String command, IShellOutputReceiver receiver, 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)` Выполняет команду оболочки на устройстве и отправляет результат `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`	`forceStop (String applicationName)` Принудительная остановка приложения по его имени.
	`getAbis ()` Возвращает ABI, поддерживаемые этим устройством.
`ListenableFuture< AvdData >`	`getAvdData ()` Возвращает информацию об AVD, на котором работает эмулятор.
`String`	`getAvdName ()` Возвращает имя AVD, запущенного эмулятором.
`String`	`getAvdPath ()` Возвращает абсолютный путь к виртуальному устройству в файловой системе.
	`getBattery (long freshnessTime, TimeUnit timeUnit)` Возвращает уровень заряда батареи устройства от 0 до 100 процентов.
	`getBattery ()` Возвращает уровень заряда батареи устройства от 0 до 100 процентов.
`Integer`	`getBatteryLevel (long freshnessMs)` Возвращает уровень заряда батареи устройства от 0 до 100 процентов.
`Integer`	`getBatteryLevel ()` Возвращает уровень заряда батареи устройства от 0 до 100 процентов.
`ClientImpl`	`getClient (String applicationName)` Возвращает `Client` по имени его приложения.
`String`	`getClientName (int pid)` Возвращает имя клиента по pid или `null` , если pid неизвестен
`ClientTracker`	`getClientTracker ()`
`ClientImpl[]`	`getClients ()` Возвращает массив клиентов.
`int`	`getDensity ()` Возвращает плотность экрана устройства, считывая значение системного свойства `PROP_DEVICE_DENSITY` .
`FileListingService`	`getFileListingService ()` Возвращает `FileListingService` для этого устройства.
`String`	`getLanguage ()` Возвращает язык пользователя.
`InstallMetrics`	`getLastInstallMetrics ()` Получает информацию о последней установке на этом устройстве.
`String`	`getMountPoint (String name)` Возвращает точку монтирования.
`String`	`getName ()` Возвращает (человеческое) имя для этого устройства.
`ClientImpl[]`	`getNativeClients ()`
`ClientImpl`	`getNativeClients (String applicationName)`
`ProfileableClientImpl[]`	`getProfileableClients ()` Возвращает массив профилируемых клиентов.
	`getProperties ()` Возвращает кэшированные свойства устройства.
`String`	`getProperty (String name)` Удобный метод, который пытается получить свойство через `IShellEnabledDevice.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)` Выполните потенциальный асинхронный запрос к системному свойству.
`boolean`	`hasClients ()` Возвращает, есть ли у `IDevice` `Client` .
`void`	`installPackage (String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` Устанавливает приложение Android на устройство.
`void`	`installPackage (String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Устанавливает приложение Android на устройство.
`void`	`installPackage (String packageFilePath, boolean reinstall, String... extraArgs)` Устанавливает приложение Android на устройство.
`void`	`installPackages ( apks, boolean reinstall, installOptions)` Устанавливает приложение Android, состоящее из нескольких APK-файлов (один основной и 0..n разделенных пакетов) со стандартным тайм-аутом.
`void`	`installPackages ( apks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)` Устанавливает приложение 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 ( remoteApks, boolean reinstall, installOptions)` Устанавливает приложение Android, состоящее из нескольких APK-файлов, локально размещенных на устройстве, с заданным временем ожидания по умолчанию.
`void`	`installRemotePackages ( remoteApks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)` Устанавливает приложение 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)` Запускает запись экрана на устройстве, если устройство поддерживает `IDevice.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 (ClientTracker clientTracer, 
                String serialNumber, 
                IDevice.DeviceState deviceState)

Параметры
`clientTracer`	`ClientTracker`
`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`
`TimeoutException`

createForward

public void createForward (int localPort, 
                int remotePort)

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

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

Броски
`AdbCommandRejectedException`
`TimeoutException`

createReverse

public void createReverse (int remotePort, 
                int localPort)

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

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

Броски
`AdbCommandRejectedException`
`TimeoutException`

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

Броски
`AdbCommandRejectedException`
`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`
`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`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

Броски
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

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

Параметры
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`int`

Броски
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

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

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

Параметры
`command`	`String` : команда оболочки для выполнения
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` , который будет получать вывод команды оболочки.
`maxTimeout`	`long` : максимальное время ожидания для возврата команды. Значение 0 означает, что максимальное время ожидания не применяется.
`maxTimeToOutputResponse`	`long` : максимальное время, в течение которого команда может не выводить никакого ответа. Значение 0 означает, что метод будет ждать вывода команды бесконечно (пока `receiver` не отменит выполнение) и никогда не выдаст исключение.
`maxTimeUnits`	`TimeUnit` : Единицы измерения для ненулевых значений `maxTimeout` и `maxTimeToOutputResponse` .

Броски
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

forceStop

public void forceStop (String applicationName)

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

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

getAbis

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

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

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

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

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

Возврат
`String`	имя AVD или `null` , если такового нет.

получитьAvdPath

public String getAvdPath ()

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

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

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

getBattery

public  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

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

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

Параметры
`freshnessTime`	`long` : желаемая давность уровня заряда батареи
`timeUnit`	`TimeUnit` : `ERROR(/TimeUnit)` свежести

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

getBattery

public  getBattery ()

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

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

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

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

public Integer getBatteryLevel (long freshnessMs)

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

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

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

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

public Integer getBatteryLevel ()

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

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

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

public ClientImpl getClient (String applicationName)

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

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

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

getClientName

public String getClientName (int pid)

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

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

Возврат
`String`

получитьClientTracker

public ClientTracker getClientTracker ()

Возврат
`ClientTracker`

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

public ClientImpl[] getClients ()

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

Возврат
`ClientImpl[]`

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

public int getDensity ()

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

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

getFileListingService

public FileListingService getFileListingService ()

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

Возврат
`FileListingService`

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

public String getLanguage ()

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

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

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

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

getMountPoint

public String getMountPoint (String name)

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

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

Возврат
`String`

получитьИмя

public String getName ()

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

Возврат
`String`

getNativeClients

public ClientImpl[] getNativeClients ()

Возврат
`ClientImpl[]`

getNativeClients

public ClientImpl getNativeClients (String applicationName)

Параметры
`applicationName`	`String`

Возврат
`ClientImpl`

getProfileableClients

public ProfileableClientImpl[] getProfileableClients ()

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

Возврат
`ProfileableClientImpl[]`

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

public  getProperties ()

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

Возврат

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

public String getProperty (String name)

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

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

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

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

getPropertyCacheOrSync

public String getPropertyCacheOrSync (String name)

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

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

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

получитьPropertyCount

public int getPropertyCount ()

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

Возврат
`int`

getPropertySync

public String getPropertySync (String name)

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

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

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

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

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

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

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Параметры
`timeout`	`long`
`unit`	`TimeUnit`

Возврат
`RawImage`

Броски
`AdbCommandRejectedException`
`TimeoutException`

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

public String getSerialNumber ()

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

Возврат
`String`

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

public IDevice.DeviceState getState ()

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

Возврат
`IDevice.DeviceState`

getSyncService

public SyncService getSyncService ()

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

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

Броски
`AdbCommandRejectedException`
`TimeoutException`

получитьSystemProperty

public ListenableFuture<String> getSystemProperty (String name)

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

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

Возврат
`ListenableFuture<String>`	`ListenableFuture.` `ERROR(get/Future#get() get)` может вернуть null.

hasClients

public boolean hasClients ()

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

Возврат
`boolean`

installPackage

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`

installPackage

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

Параметры
`packageFilePath`	`String` : абсолютный путь в файловой системе к файлу на локальном хосте для установки.
`reinstall`	`boolean` : установите значение `true` , если необходимо выполнить переустановку приложения
`receiver`	`InstallReceiver` : `InstallReceiver` , который будет использоваться для мониторинга установки и получения окончательного статуса.
`extraArgs`	`String` : необязательные дополнительные аргументы для передачи. См. «adb shell pm install --help» для получения информации о доступных параметрах.

Броски
`InstallException`

installPackage

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

Параметры
`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 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 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 ( 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 boolean isBootLoader ()

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

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

isEmulator

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

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

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

Броски
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

убийство

public void kill (String applicationName)

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

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

pullFile

public void pullFile (String remote, 
                String local)

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

Параметры
`remote`	`String` : полный путь к удаленному файлу
`local`	`String` : Местный пункт назначения.

Броски
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

толкать

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

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

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

Броски
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

pushFile

public void pushFile (String local, 
                String remote)

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

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

Броски
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

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, поэтому любые данные, считываемые из сокета, могут поступать из любого из выходов и чередоваться.

Параметры
`executable`	`String`
`parameters`	`String`

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

Броски
`AdbCommandRejectedException`
`TimeoutException`

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

public void reboot (String into)

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

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

Броски
`AdbCommandRejectedException`
`TimeoutException`

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

public void removeForward (int localPort)

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

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

Броски
`AdbCommandRejectedException`
`TimeoutException`

removeRemotePackage

public void removeRemotePackage (String remoteFilePath)

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

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

Броски
`InstallException`

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

public void removeReverse (int remotePort)

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

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

Броски
`AdbCommandRejectedException`
`TimeoutException`

корень

public boolean root ()

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

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

Броски
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

startScreenRecorder

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

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

Параметры
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`
`receiver`	`IShellOutputReceiver`

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

uninstallPackage

public String uninstallPackage (String packageName)

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

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

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

Броски
`InstallException`