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 () Возвращает |
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 . Это аналогично вызову функции |
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 () Возвращает диапазон плотности экрана устройства, считывая значение системного свойства |
FileListingService | getFileListingService () Возвращает объект |
String | getLanguage ()Возвращает язык пользователя. |
InstallMetrics | getLastInstallMetrics ()Получает информацию о последней установке на этом устройстве. |
String | getMountPoint (String name)Возвращает точку монтирования. |
String | getName ()Возвращает (очеловеченное) название для этого устройства. |
Map<String, String> | getProperties ()Возвращает кэшированные свойства устройства. |
String | getProperty (String name) Удобный метод, который пытается получить свойство с помощью |
String | getPropertyCacheOrSync (String name) Комбинация методов |
int | getPropertyCount ()Возвращает номер свойства для данного устройства. |
String | getPropertySync (String name) Вариант метода |
String | getRegion ()Возвращает регион пользователя. |
static String | getScreenRecorderCommand (String remoteFilePath, ScreenRecorderOptions options) |
RawImage | getScreenshot () Делает снимок экрана устройства и возвращает его в формате |
RawImage | getScreenshot (long timeout, TimeUnit unit) |
String | getSerialNumber ()Возвращает серийный номер устройства. |
IDevice.DeviceState | getState ()Возвращает состояние устройства. |
SyncService | getSyncService () Возвращает объект |
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 () Возвращает |
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) Запускает запись экрана на устройстве, если устройство поддерживает |
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 | |