РодноеУстройство

public class NativeDevice
extends Object implements IManagedTestDevice , IConfigurationReceiver , ITestLoggerReceiver

java.lang.Объект
com.android.tradefed.device.NativeDevice


Реализация по умолчанию ITestDevice Неполноценные устройства Android.

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

Вложенные классы

class NativeDevice.AdbAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) для запуска команды ОС «adb ....».

class NativeDevice.AdbShellAction

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) для перезагрузки устройства.

Константы

int INVALID_USER_ID

Значение, возвращаемое для любого недействительного/не найденного идентификатора пользователя: UserHandle определил значение -10000.

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

количество попыток повтора команды по умолчанию

Поля

public static final String DEBUGFS_PATH

protected static final String SD_CARD

protected static final String STORAGE_EMULATED

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

Общественные конструкторы

NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Создает TestDevice .

Публичные методы

void batchPrefetchStartupBuildProps ()

Микрооптимизация (около 400 миллис) путем предварительной выборки всех необходимых нам реквизитов вместо вызова adb getprop для каждого из них.

boolean canSwitchToHeadlessSystemUser ()

Возвращает, разрешено ли переключение на безголового пользователя системы.

boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

boolean checkConnectivity ()

Убедитесь, что устройство имеет подключение к сети.

boolean clearErrorDialogs ()

Попытайтесь закрыть все диалоговые окна ошибок, отображаемые в настоящее время в пользовательском интерфейсе устройства.

void clearLastConnectedWifiNetwork ()

Очищает последнюю подключенную сеть Wi-Fi.

void clearLogcat ()

Удаляет все накопленные данные logcat.

boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

Подключается к сети Wi-Fi.

boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Подключается к сети Wi-Fi.

boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

Подключается к сети Wi-Fi.f

boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)

Подключается к сети Wi-Fi.

boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)

Вариант connectToWifiNetwork(String, String) , который подключается только в том случае, если устройство в данный момент не имеет подключения к сети.

boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

Вариант connectToWifiNetwork(String, String) , который подключается только в том случае, если устройство в данный момент не имеет подключения к сети.

int createUser (String name, boolean guest, boolean ephemeral)

Создайте пользователя с заданным именем и предоставленными флагами.

int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)

Создайте пользователя с заданным именем и предоставленными флагами.

int createUser (String name)

Создайте пользователя с заданным именем и флагами по умолчанию 0.

int createUserNoThrow (String name)

Создайте пользователя с заданным именем и флагами по умолчанию 0.

void deleteFile (String deviceFilePath)

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

void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Удаляет зарегистрированный IDeviceActionReceiver .

boolean deviceSoftRestarted ( ProcessInfo prevSystemServerProcess)

Вспомогательный метод для проверки плавного перезапуска устройства путем сравнения текущего system_server с предыдущим system_server ProcessInfo .

boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

Вспомогательный метод для проверки того, был ли выполнен программный перезапуск устройства с момента времени UTC, начиная с эпохи устройства и его ERROR(/TimeUnit) .

boolean disableAdbRoot ()

Отключает адб рут.

void disableKeyguard ()

Пытается отключить защиту клавиатуры.

boolean disableNetworkMonitor ()

Отключает мониторинг сети на устройстве.

boolean disconnectFromWifi ()

Отключается от сети Wi-Fi.

boolean doesFileExist (String deviceFilePath, int userId)

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

boolean doesFileExist (String deviceFilePath)

Вспомогательный метод для определения существования файла на устройстве.

File dumpHeap (String process, String devicePath)

Попытайтесь сбросить кучу с system_server.

boolean enableAdbRoot ()

Включает adb root.

boolean enableNetworkMonitor ()

Включает сетевой мониторинг на устройстве.

String executeAdbCommand (long timeout, String... cmdArgs)

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

String executeAdbCommand (long timeout, envMap, String... cmdArgs) executeAdbCommand (long timeout, envMap, String... cmdArgs)

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

String executeAdbCommand (String... cmdArgs)

Вспомогательный метод, который выполняет команду adb как системную команду.

CommandResult executeFastbootCommand (String... cmdArgs)

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

CommandResult executeFastbootCommand (long timeout, String... cmdArgs)

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

CommandResult executeLongFastbootCommand (String... cmdArgs)

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

CommandResult executeLongFastbootCommand ( envVarMap, String... cmdArgs) executeLongFastbootCommand ( envVarMap, String... cmdArgs)

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

String executeShellCommand (String command)

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

void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

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

void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

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

void executeShellCommand (String command, IShellOutputReceiver receiver)

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

CommandResult executeShellV2Command (String cmd)

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

CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)

Вспомогательный метод, который выполняет команду оболочки adb и возвращает результаты в виде CommandResult , правильно заполненного выводом состояния команды и стандартным потоком stderr.

CommandResult executeShellV2Command (String cmd, File pipeAsInput)

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

CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

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

CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)

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

CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

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

CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

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

CommandResult fastbootWipePartition (String partition)

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

getActiveApexes ()

Получите информацию об APEX, активированных на устройстве.

getAllSettings (String namespace)

Возвращает пары ключ-значение запрошенного пространства имен.

DeviceAllocationState getAllocationState ()

Вернуть текущее состояние распределения устройства

String getAndroidId (int userId)

Найдите и верните идентификатор Android, связанный с идентификатором пользователя, нулевой, если он не найден.

getAndroidIds ()

Создайте карту идентификаторов Android, найденных совпадающими с идентификаторами пользователей.

int getApiLevel ()

Получите уровень API устройства.

PackageInfo getAppPackageInfo (String packageName)

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

getAppPackageInfos ()

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

String getBasebandVersion ()

Удобный способ получить базовую (радио) версию этого устройства.

Integer getBattery ()

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

boolean getBooleanProperty (String name, boolean defaultValue)

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

getBootHistory ()

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

getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)

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

String getBootloaderVersion ()

Удобный способ получить версию загрузчика этого устройства.

InputStreamSource getBugreport ()

Получает отчет об ошибке с устройства.

InputStreamSource getBugreportz ()

Получает отчет об ошибке с устройства.

String getBuildAlias ()

Получите псевдоним сборки, которую в данный момент выполняет устройство.

String getBuildFlavor ()

Получите версию сборки для устройства.

String getBuildId ()

Получите сборку, на которой в данный момент работает устройство.

String getBuildSigningKeys ()

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

Обычно устройства Android могут быть подписаны с помощью тестовых ключей (например, в AOSP) или ключей выпуска (контролируемых отдельными производителями устройств).

DeviceDescriptor getCachedDeviceDescriptor ()

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

DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

String[] getChildren (String path)

Альтернатива использованию IFileEntry , которая иногда не работает из-за разрешений.

AbstractConnection getConnection ()

Текущее соединение, связанное с устройством.

DeviceFoldableState getCurrentFoldableState ()

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

int getCurrentUser ()

Возвращает идентификатор текущего работающего пользователя.

String getDeviceClass ()

Получите класс устройства.

long getDeviceDate ()

Возвращает дату устройства в миллисекундах с начала эпохи.

DeviceDescriptor getDeviceDescriptor ()

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

DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

TestDeviceState getDeviceState ()

Получите состояние устройства.

long getDeviceTimeOffset (Date date)

Помощник для получения разницы во времени между устройством и заданной ERROR(/Date) .

InputStreamSource getEmulatorOutput ()

Получите поток stdout и stderr эмулятора.

Process getEmulatorProcess ()

Верните Process , соответствующий этому эмулятору.

final File getExecuteShellCommandLog ()

Журнал, содержащий все журналы executeShellCommand(String) .

long getExternalStoreFreeSpace ()

Вспомогательный метод для определения объема свободного места на внешнем хранилище устройства.

String getFastbootPath ()

Возвращает путь к используемому двоичному файлу fastboot.

String getFastbootProductType ()

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

String getFastbootProductVariant ()

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

String getFastbootSerialNumber ()

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

String getFastbootVariable (String variableName)

Получите заданное значение переменной fastboot с устройства.

String getFastbootVersion ()

Возвращает строку версии используемого двоичного файла fastboot.

IFileEntry getFileEntry (String path)

Получить ссылку на удаленный файл на устройстве.

IFileEntry getFileEntry (FileListingService.FileEntry entry)

Неофициальный помощник для получения FileEntry по некорневому пути.

getFoldableStates ()

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

IDevice getIDevice ()

Возвращает ссылку на связанный IDevice ddmlib.

getInstalledPackageNames ()

Получите имена пакетов приложений, присутствующих на устройстве.

long getIntProperty (String name, long defaultValue)

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

String getIpAddress ()

Получает IP-адрес устройства.

KeyguardControllerState getKeyguardState ()

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

long getLastExpectedRebootTimeMillis ()

Возвращает последний раз, когда API-интерфейсы Tradefed запускали перезагрузку в миллисекундах с момента EPOCH, как возвращается System.currentTimeMillis() .

int getLaunchApiLevel ()

Получите первый запущенный уровень API устройства.

InputStreamSource getLogcat ()

Получает поток снимков данных logcat.

InputStreamSource getLogcat (int maxBytes)

Получает поток снимков последних maxBytes захваченных данных logcat.

InputStreamSource getLogcatDump ()

Получите дамп текущего логарифма устройства.

InputStreamSource getLogcatSince (long date)

Получает поток снимков записанных данных logcat, начиная с указанной даты.

String getMacAddress ()

Возвращает MAC-адрес устройства, нулевой, если не удалось выполнить запрос с устройства.

Integer getMainUserId ()

Возвращает основной идентификатор пользователя.

getMainlineModuleInfo ()

Получите информацию об основных модулях, установленных на устройстве.

int getMaxNumberOfRunningUsersSupported ()

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

int getMaxNumberOfUsersSupported ()

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

Process getMicrodroidProcess ()
IDeviceStateMonitor getMonitor ()

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

String getMountPoint (String mountName)

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

ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Возвращает MountPointInfo соответствующий указанному пути к точке монтирования, или null , если по этому пути ничего не смонтировано или по какой-либо причине не отображается в /proc/mounts как точка монтирования.

getMountPointInfo ()

Возвращает проанализированную версию информации в /proc/mounts на устройстве.

TestDeviceOptions getOptions ()

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

long getPartitionFreeSpace (String partition)

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

Integer getPrimaryUserId ()

Возвращает основной идентификатор пользователя.

ProcessInfo getProcessByName (String processName)

Вспомогательный метод запускает команды «pidof» и «stat» и возвращает объект ProcessInfo с PID и временем запуска данного процесса.

String getProcessPid (String process)

Возвращает pid службы или значение null, если что-то пошло не так.

String getProductType ()

Удобный способ узнать тип продукта этого устройства.

String getProductVariant ()

Удобный способ получить вариант продукта этого устройства.

String getProperty (String name)

Получите заданное значение свойства с устройства.

ITestDevice.RecoveryMode getRecoveryMode ()

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

InputStreamSource getScreenshot (String format)

Делает скриншот с устройства.

InputStreamSource getScreenshot (long displayId)

Делает снимок экрана с устройства с заданным идентификатором дисплея.

InputStreamSource getScreenshot (String format, boolean rescale)

Делает скриншот с устройства.

InputStreamSource getScreenshot ()

Делает скриншот с устройства.

String getSerialNumber ()

Удобный способ получить серийный номер этого устройства.

String getSetting (int userId, String namespace, String key)

Верните значение запрошенного параметра.

String getSetting (String namespace, String key)

См. getSetting(int, String, String) и выполняется для системного пользователя.

String getSimOperator ()

Верните оператора SIM-карты или ноль, если он недоступен или устройство недоступно.

String getSimState ()

Верните состояние SIM-карты или нулевое значение, если оно недоступно или устройство недоступно.

getTombstones ()

Получите и верните список надгробий с устройств.

long getTotalMemory ()

Возвращает общий размер физической памяти в байтах или -1 в случае внутренней ошибки.

getUninstallablePackageNames ()

Получите имена пакетов приложений, которые можно удалить.

boolean getUseFastbootErase ()

Узнайте, следует ли использовать Fastboot Erase или Fastboot Format для очистки раздела на устройстве.

int getUserFlags (int userId)

Найдите и верните флаги данного пользователя.

getUserInfos ()

Получает сопоставление useId с UserInfo на устройстве.

int getUserSerialNumber (int userId)

Возвращает серийный номер, связанный с идентификатором пользователя, если он найден, -10000 в любых других случаях.

IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Обработать данное DeviceEvent.

Обработайте DeviceEvent, который может перевести или не перевести это устройство в новое состояние распределения.

boolean hasFeature (String feature)

Проверьте, доступна ли функция на устройстве.

String installPackage (File packageFile, boolean reinstall, String... extraArgs)

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

String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

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

String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)

Установите пакет Android на устройство для данного пользователя.

String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

Установите пакет Android на устройство для данного пользователя.

void invalidatePropertyCache ()
boolean isAdbRoot ()

boolean isAdbTcp ()
boolean isAppEnumerationSupported ()

Проверьте, поддерживает ли платформа на устройстве перечисление приложений.

boolean isBypassLowTargetSdkBlockSupported ()

Проверьте, поддерживает ли платформа на устройстве обход блокировки SDK с низкой целью при установке приложения.

boolean isDebugfsMounted ()

Проверьте, смонтирован ли debugfs.

boolean isDeviceEncrypted ()

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

boolean isDirectory (String path)

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

boolean isEnableAdbRoot ()
boolean isEncryptionSupported ()

Возвращается, если на устройстве поддерживается шифрование.

boolean isExecutable (String fullPath)

Возвращает true, если путь к файлу на устройстве является исполняемым файлом, в противном случае — false.

boolean isFastbootEnabled ()

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

boolean isHeadless ()

Возвращайте true, если устройство не имеет дисплея (без экрана), в противном случае — false.

boolean isHeadlessSystemUserMode ()

Возвращает, использует ли устройство пользовательский режим безголовой системы.

boolean isMainUserPermanentAdmin ()

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

boolean isMultiUserSupported ()

Определяет, поддерживается ли многопользовательский режим.

boolean isPackageInstalled (String packageName, String userId)

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

boolean isPackageInstalled (String packageName)

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

boolean isRuntimePermissionSupported ()

Проверьте, поддерживает ли платформа на устройстве предоставление разрешений во время выполнения.

boolean isStateBootloaderOrFastbootd ()

Возвращает true, если устройство находится в TestDeviceState#FASTBOOT или TestDeviceState.FASTBOOTD .

boolean isUserRunning (int userId)

Проверьте, работает ли данный пользователь.

boolean isUserSecondary (int userId)

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

boolean isUserVisible (int userId)

Проверяет, виден ли данный пользователь.

boolean isUserVisibleOnDisplay (int userId, int displayId)

Проверяет, виден ли данный пользователь на данном дисплее.

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Возвращает, позволяет ли устройство запускать пользователей видимыми в фоновом режиме в ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

boolean isVisibleBackgroundUsersSupported ()

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

boolean isWifiEnabled ()

Проверьте, включен ли Wi-Fi.

listDisplayIds ()

Соберите список доступных идентификаторов дисплеев на устройстве, как сообщает «dumpsys SurfaceFlinger».

listDisplayIdsForStartingVisibleBackgroundUsers ()

Получает список дисплеев, которые можно использовать, чтобы start a user visible in the background .

listUsers ()

Получает список пользователей на устройстве.

boolean logAnrs ( ITestLogger logger)

Собирает и регистрирует ошибки ANR с устройства.

boolean logBugreport (String dataName, ITestLogger listener)

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

void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)

Зарегистрируйте сообщение в logcat устройства.

void mountDebugfs ()

Смонтируйте отладочную файлы.

void nonBlockingReboot ()

Выдает команду на перезагрузку устройства и возвращает результат после завершения команды и когда устройство больше не отображается в adb.

void postAdbRootAction ()

Переопределить, если устройству необходимо выполнить какие-то определенные действия после получения root-доступа adb и до того, как устройство снова подключится к сети.

void postAdbUnrootAction ()

Переопределить, если устройству необходимо выполнить какие-то определенные действия после отключения adb и до того, как устройство снова подключится к сети.

void postBootSetup ()

Выполняйте инструкции по настройке устройства для тестирования после каждой загрузки.

void postInvocationTearDown (Throwable exception)

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

void preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes)

Дополнительные шаги для необходимой настройки конкретного устройства, которые будут выполняться на устройстве перед потоком вызова.

boolean pullDir (String deviceFilePath, File localDir)

Рекурсивно извлекать содержимое каталога с устройства.

boolean pullFile (String remoteFilePath, File localFile)

Извлекает файл с устройства.

File pullFile (String remoteFilePath, int userId)

Извлекает файл с устройства, сохраняет его в локальной временной ERROR(/File) и возвращает этот File .

File pullFile (String remoteFilePath)

Извлекает файл с устройства, сохраняет его в локальной временной ERROR(/File) и возвращает этот File .

boolean pullFile (String remoteFilePath, File localFile, int userId)

Извлекает файл с устройства.

String pullFileContents (String remoteFilePath)

Извлекает файл с устройства и возвращает его содержимое.

File pullFileFromExternal (String remoteFilePath)

Удобный метод получения файла из внешнего хранилища устройства, сохранения его в локальной временной ERROR(/File) и возврата ссылки на этот File .

boolean pushDir (File localFileDir, String deviceFilePath, excludedDirectories) pushDir (File localFileDir, String deviceFilePath, excludedDirectories)

Рекурсивно отправлять содержимое каталога на устройство, исключая некоторые фильтруемые каталоги.

boolean pushDir (File localFileDir, String deviceFilePath)

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

boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)

Вариант pushFile(File, String) , который может дополнительно учитывать необходимость оценки потребности в поставщике контента.

boolean pushFile (File localFile, String remoteFilePath)

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

boolean pushString (String contents, String remoteFilePath)

Отправить файл, созданный из строки, на устройство

void reboot (String reason)

Перезагружает устройство в режиме adb с указанием reason , которая будет сохраняться при перезагрузке.

void reboot ()

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

void rebootIntoBootloader ()

Перезагружает устройство в режим загрузчика.

void rebootIntoFastbootd ()

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

void rebootIntoRecovery ()

Перезагружает устройство в режим восстановления adb.

void rebootIntoSideload ()

Перезагружает устройство в режим боковой загрузки adb (обратите внимание, что это специальный режим в режиме восстановления)

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

void rebootIntoSideload (boolean autoReboot)

Перезагружает устройство в режим боковой загрузки adb (обратите внимание, что это специальный режим в режиме восстановления)

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

void rebootUntilOnline ()

Альтернатива reboot() , которая блокируется только до тех пор, пока устройство не будет подключено к сети, т.е. не станет видимым для adb.

void rebootUntilOnline (String reason)

Альтернатива reboot() , которая блокируется только до тех пор, пока устройство не будет подключено к сети, т.е. не станет видимым для adb.

void rebootUserspace ()

Перезагружает только часть пользовательского пространства устройства.

void rebootUserspaceUntilOnline ()

Альтернатива rebootUserspace() ()}, которая блокируется только до тех пор, пока устройство не окажется в сети, т. е. не станет видимым для adb.

boolean recoverDevice ()

Попытки восстановить связь с устройством.

void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Регистрирует IDeviceActionReceiver для этого устройства.

void remountSystemReadOnly ()

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

void remountSystemWritable ()

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

void remountVendorReadOnly ()

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

void remountVendorWritable ()

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

boolean removeAdmin (String componentName, int userId)

Удалите данного администратора устройства у данного пользователя и верните true , если операция прошла успешно, в противном случае false .

void removeOwners ()

Удалите всех существующих владельцев профилей устройств, приложив все усилия.

boolean removeUser (int userId)

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

void resetContentProviderSetup ()

Сбросьте флаг настройки поставщика контента, чтобы активировать его снова.

boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)

Удобный метод для выполнения ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) с одним или несколькими прослушивателями, переданными в качестве параметров.

boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)

Запускает инструментальные тесты и обеспечивает восстановление устройства.

boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners)

То же самое, что ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) тест для данного пользователя.

boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)

То же, что ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) но запускает тест для данного пользователя.

void setConfiguration ( IConfiguration configuration)

Внедряет используемый IConfiguration .

final void setConnectionAvdInfo ( GceAvdInfo avdInfo)
void setDate (Date date)

Устанавливает дату на устройстве

Примечание: для установки даты на устройстве требуется root

boolean setDeviceOwner (String componentName, int userId)

Установите компонент администратора устройства в качестве владельца устройства для данного пользователя.

void setDeviceState ( TestDeviceState deviceState)

Обновите состояние устройства.

void setEmulatorOutputStream ( SizeLimitedOutputStream output)

Для эмулятора установите SizeLimitedOutputStream для регистрации вывода

void setEmulatorProcess (Process p)

Устанавливает Process , если это устройство является эмулятором.

void setFastbootEnabled (boolean fastbootEnabled)

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

void setFastbootPath (String fastbootPath)

Устанавливает путь к двоичному файлу fastboot, который следует использовать.

void setIDevice (IDevice newDevice)

Обновите IDevice, связанный с этим ITestDevice.

void setLogStartDelay (int delay)

Устанавливает время ожидания в мс перед началом захвата logcat для подключенного к сети устройства.

void setOptions ( TestDeviceOptions options)

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

boolean setProperty (String propKey, String propValue)

Устанавливает заданное значение свойства на устройстве.

void setRecovery ( IDeviceRecovery recovery)

Установите IDeviceRecovery , который будет использоваться для этого устройства.

void setRecoveryMode ( ITestDevice.RecoveryMode mode)

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

void setSetting (String namespace, String key, String value)

См. setSetting(int, String, String, String) и выполняется для системного пользователя.

void setSetting (int userId, String namespace, String key, String value)

Добавьте значение параметра в пространство имен данного пользователя.

void setTestLogger ( ITestLogger testLogger)

Внедряет экземпляр ITestLogger

void setUseFastbootErase (boolean useFastbootErase)

Укажите, следует ли использовать Fastboot Erase или Fastboot Format для очистки раздела на устройстве.

void startLogcat ()

Начните захват вывода logcat с устройства в фоновом режиме.

boolean startUser (int userId)

Запускает данного пользователя в фоновом режиме, если он в данный момент остановлен.

boolean startUser (int userId, boolean waitFlag)

Запускает данного пользователя в фоновом режиме, если он в данный момент остановлен.

boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)

Запускает данного пользователя в фоновом режиме, видимом на данном дисплее (т. е. позволяя пользователю запускать действия на этом дисплее).

void stopEmulatorOutput ()

Закройте и удалите вывод эмулятора.

void stopLogcat ()

Прекратите захват вывода logcat с устройства и удалите текущие сохраненные данные logcat.

boolean stopUser (int userId)

Останавливает данного пользователя.

boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)

Остановить данного пользователя.

String switchToAdbTcp ()

Переключите устройство в режим adb-over-tcp.

boolean switchToAdbUsb ()

Переключите устройство в режим adb через USB.

boolean switchUser (int userId)

Переключитесь на другой идентификатор пользователя с таймаутом по умолчанию.

boolean switchUser (int userId, long timeout)

Переключитесь на другой идентификатор пользователя с указанным тайм-аутом в качестве крайнего срока.

boolean syncFiles (File localFileDir, String deviceFilePath)

Поэтапно синхронизирует содержимое локального каталога файлов с устройством.

Bugreport takeBugreport ()

Возьмите отчет об ошибке и верните его в объект Bugreport для его обработки.

String uninstallPackage (String packageName)

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

String uninstallPackageForUser (String packageName, int userId)

Удалите пакет Android с устройства для данного пользователя.

boolean unlockDevice ()

Разблокирует устройство, если оно находится в зашифрованном состоянии.

void unmountDebugfs ()

Отмонтируйте отладочные файлы.

boolean waitForBootComplete (long timeOut)

Блокируется до тех пор, пока не будет установлен флаг завершения загрузки устройства.

boolean waitForDeviceAvailable ()

Ожидает, пока устройство ответит и будет доступно для тестирования.

boolean waitForDeviceAvailable (long waitTime)

Ожидает, пока устройство ответит и будет доступно для тестирования.

boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Ожидает, пока устройство ответит и станет доступным, не учитывая путь восстановления.

void waitForDeviceBootloader ()

Блокируется до тех пор, пока устройство не станет видимым через fastboot.

boolean waitForDeviceInRecovery (long waitTime)

Блокирует нахождение устройства в состоянии «восстановление adb» (обратите внимание, что это отличается от IDeviceRecovery ).

boolean waitForDeviceInSideload (long waitTime)

Блокирует нахождение устройства в состоянии «adb Sideload».

boolean waitForDeviceNotAvailable (long waitTime)

Блоки для устройства недоступны т.е. отсутствуют в adb

void waitForDeviceOnline ()

Блокируется до тех пор, пока устройство не станет видимым через adb.

void waitForDeviceOnline (long waitTime)

Блокируется до тех пор, пока устройство не станет видимым через adb.

boolean waitForDeviceShell (long waitTime)

Ожидает, пока устройство отреагирует на базовую команду оболочки adb.

Защищенные методы

void addExtraConnectionBuilderArgs ( DefaultConnection.ConnectionBuilder builder)
String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)

Создает команду ОС для данного сеанса команд оболочки adb и аргументов.

void checkApiLevelAgainst (String feature, int strictMinLevel)
NativeDevice.RebootDeviceAction createRebootDeviceAction ( NativeDevice.RebootMode rebootMode, String reason)

Создайте RebootDeviceAction , который будет использоваться при выполнении действия перезагрузки.

IRunUtil createRunUtil ()
void doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)

Выполните перезагрузку adb.

void ensureRuntimePermissionSupported ()

вспомогательный метод для создания исключения, если разрешение времени выполнения не поддерживается

int getApiLevelSafe ()
ITestLogger getLogger ()
IRunUtil getRunUtil ()

Получите экземпляр RunUtil для использования.

void initializeConnection ( IBuildInfo info, MultiMap <String, String> attributes)
String internalGetProperty (String propName, String fastbootVar, String description)

Получите свойство устройства из кэша ddmlib по умолчанию и вернитесь к `adb Shell getprop` или `fastboot getvar` в зависимости от того, находится ли устройство в режиме Fastboot или нет.

boolean isInRebootCallback ()

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

boolean isNewer (File localFile, IFileEntry entry)

Возвращайте true если локальный файл новее удаленного файла.

void notifyRebootEnded ()

Уведомляет все IDeviceActionReceiver о событии завершения перезагрузки.

void notifyRebootStarted ()

Уведомляет все IDeviceActionReceiver о событии начала перезагрузки.

boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)

Выполняет действие на этом устройстве.

void postAdbReboot ()

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

void prePostBootSetup ()

Позволяет каждому типу устройства (AndroidNativeDevice, TestDevice) переопределить этот метод для конкретной настройки после загрузки.

boolean pullFileInternal (String remoteFilePath, File localFile)
void setClock (Clock clock)

Установите экземпляр Clock для использования.

void setMicrodroidProcess (Process process)

Помечает TestDevice как microdroid и устанавливает его CID.

void setTestDeviceOptions ( deviceOptions) setTestDeviceOptions ( deviceOptions)
CommandResult simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd)

Выполняет простую команду быстрой загрузки с переменными среды и сообщает о состоянии команды.

CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)

Выполняет простую команду быстрой загрузки и сообщает о состоянии команды.

boolean waitForDeviceNotAvailable (String operationDesc, long time)

Подождите, пока устройство станет недоступным (прекратите отправлять отчеты в adb).

Константы

INVALID_USER_ID

public static final int INVALID_USER_ID

Значение, возвращаемое для любого недействительного/не найденного идентификатора пользователя: UserHandle определил значение -10000.

Постоянное значение: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Постоянное значение: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

количество попыток повтора команды по умолчанию

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

Поля

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mОпции

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Общественные конструкторы

РодноеУстройство

public NativeDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Создает TestDevice .

Параметры
device IDevice : связанный IDevice

stateMonitor IDeviceStateMonitor : используемый механизм IDeviceStateMonitor .

allocationMonitor IDeviceMonitor : IDeviceMonitor для информирования об изменениях состояния распределения. Может быть нулевым

Публичные методы

Пакетная сборкаPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Микрооптимизация (около 400 миллис) путем предварительной выборки всех необходимых нам реквизитов вместо вызова adb getprop для каждого из них. т.е. получение всех свойств происходит так же быстро, как и получение одного. Такие вещи, как device.getApiLevel(), checkApiLevelAgainstNextRelease и getBuildAlias, все «под капотом» вызывают adb getprop. Мы извлекаем их одним вызовом и вызываем NativeDevice.setProperty. Даже если мы этого не сделаем, NativeDevice сам вызовет setProperty и кэширует результат для будущих вызовов. Просто мы делаем это немного раньше. Если устройство находится в процессе восстановления или есть другие ошибки при получении реквизитов, мы просто игнорируем их.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Возвращает, разрешено ли переключение на безголового пользователя системы.

Возврат
boolean

Броски
DeviceNotAvailableException

проверкаApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

Параметры
strictMinLevel int : строгий минимальный возможный уровень, поддерживающий эту функцию.

Возврат
boolean Истинно, если уровень поддерживается. В противном случае неверно.

Броски
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity ()

Убедитесь, что устройство имеет подключение к сети.

Возврат
boolean true если устройство имеет работающее сетевое соединение, в противном случае false .

Броски
DeviceNotAvailableException

ClearErrorDialogs

public boolean clearErrorDialogs ()

Попытайтесь закрыть все диалоговые окна ошибок, отображаемые в настоящее время в пользовательском интерфейсе устройства.

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

Броски
DeviceNotAvailableException

ClearLastConnectedWiFiNetwork

public void clearLastConnectedWifiNetwork ()

Очищает последнюю подключенную сеть Wi-Fi. Это следует вызывать при запуске нового вызова, чтобы избежать подключения к сети Wi-Fi, использованной в предыдущем тесте, после перезагрузки устройства.

очиститьLogcat

public void clearLogcat ()

Удаляет все накопленные данные logcat.

Это полезно в тех случаях, когда вы хотите, чтобы ITestDevice#getLogcat() возвращал данные журнала, созданные после определенного момента (например, после прошивки новой сборки устройства и т. д.).

ConnectToWiFiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Подключается к сети Wi-Fi.

Включает Wi-Fi и блокирует его до тех пор, пока не будет установлено успешное соединение с одной из сетей Wi-Fi, указанных на карте wifiSsidToPsk. После установления соединения экземпляр будет пытаться восстановить соединение после каждой перезагрузки, пока не будет вызван ITestDevice#disconnectFromWifi() или ITestDevice#clearLastConnectedWifiNetwork() .

Параметры
wifiSsidToPsk : сопоставление SSID Wi-Fi с паролями.

scanSsid boolean : следует ли сканировать скрытые SSID для этой сети.

Возврат
boolean true , если подключение к сети Wi-Fi успешно. false в противном случае

Броски
DeviceNotAvailableException

ConnectToWiFiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Подключается к сети Wi-Fi.

Включает Wi-Fi и блокирует его до тех пор, пока не будет установлено успешное соединение с указанной сетью Wi-Fi. После установления соединения экземпляр будет пытаться восстановить соединение после каждой перезагрузки, пока не будет вызван ITestDevice#disconnectFromWifi() или ITestDevice#clearLastConnectedWifiNetwork() .

Параметры
wifiSsid String : SSID Wi-Fi для подключения.

wifiPsk String : парольная фраза PSK или ноль, если она не зашифрована.

Возврат
boolean true , если подключение к сети Wi-Fi успешно. false в противном случае

Броски
DeviceNotAvailableException

ConnectToWiFiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Подключается к сети Wi-Fi.

Включает Wi-Fi и блокирует его до тех пор, пока не будет установлено успешное соединение с одной из сетей Wi-Fi, указанных на карте wifiSsidToPsk. После установления соединения экземпляр будет пытаться восстановить соединение после каждой перезагрузки, пока не будет вызван ITestDevice#disconnectFromWifi() или ITestDevice#clearLastConnectedWifiNetwork()

Параметры
wifiSsidToPsk : сопоставление SSID Wi-Fi с паролями.

Возврат
boolean true , если подключение к сети Wi-Fi успешно. false в противном случае

Броски
DeviceNotAvailableException

ConnectToWiFiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Подключается к сети Wi-Fi.

Включает Wi-Fi и блокирует его до тех пор, пока не будет установлено успешное соединение с указанной сетью Wi-Fi. После установления соединения экземпляр будет пытаться восстановить соединение после каждой перезагрузки, пока не будет вызван ITestDevice#disconnectFromWifi() или ITestDevice#clearLastConnectedWifiNetwork() .

Параметры
wifiSsid String : SSID Wi-Fi для подключения.

wifiPsk String : парольная фраза PSK или ноль, если она не зашифрована.

scanSsid boolean : следует ли сканировать скрытый SSID для этой сети.

Возврат
boolean true , если подключение к сети Wi-Fi успешно. false в противном случае

Броски
DeviceNotAvailableException

ConnectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Вариант connectToWifiNetwork(String, String) , который подключается только в том случае, если устройство в данный момент не имеет подключения к сети.

Параметры
scanSsid boolean : следует ли сканировать скрытый SSID для этой сети.

Возврат
boolean true , если подключение к сети Wi-Fi успешно. false в противном случае

Броски
DeviceNotAvailableException

ConnectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Вариант connectToWifiNetwork(String, String) , который подключается только в том случае, если устройство в данный момент не имеет подключения к сети.

Возврат
boolean true , если подключение к сети Wi-Fi успешно. false в противном случае

Броски
DeviceNotAvailableException

Создать пользователя

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Создайте пользователя с заданным именем и предоставленными флагами.

Параметры
name String : пользователя, которого нужно создать на устройстве.

guest boolean : включить пользовательский флаг --guest во время создания

ephemeral boolean : включить пользовательский флаг --ephemeral во время создания

Возврат
int идентификатор созданного пользователя

Броски
DeviceNotAvailableException

Создать пользователя

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

Создайте пользователя с заданным именем и предоставленными флагами.

Параметры
name String : пользователя, которого нужно создать на устройстве.

guest boolean : включить пользовательский флаг --guest во время создания

ephemeral boolean : включить пользовательский флаг --ephemeral во время создания

forTesting boolean : включить тестовый флаг --for-testing во время создания

Возврат
int идентификатор созданного пользователя

Броски
DeviceNotAvailableException

Создать пользователя

public int createUser (String name)

Создайте пользователя с заданным именем и флагами по умолчанию 0.

Параметры
name String : пользователя, которого нужно создать на устройстве.

Возврат
int целое число для созданного идентификатора пользователя

Броски
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

Создайте пользователя с заданным именем и флагами по умолчанию 0.

Параметры
name String : пользователя, которого нужно создать на устройстве.

Возврат
int целое число для созданного идентификатора пользователя или -1 в случае ошибки.

Броски
DeviceNotAvailableException

удалить файл

public void deleteFile (String deviceFilePath)

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

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

Броски
DeviceNotAvailableException

отменить регистрациюDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Удаляет зарегистрированный IDeviceActionReceiver .

Параметры
deviceActionReceiver IDeviceActionReceiver : IDeviceActionReceiver , который будет удален.

устройствоSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Вспомогательный метод для проверки плавного перезапуска устройства путем сравнения текущего system_server с предыдущим system_server ProcessInfo . Используйте getProcessByName(String) для получения ProcessInfo .

Параметры
prevSystemServerProcess ProcessInfo : предыдущий процесс system_server ProcessInfo .

Возврат
boolean true , если устройство перезапущено

Броски
DeviceNotAvailableException

устройствоSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Вспомогательный метод для проверки того, был ли выполнен программный перезапуск устройства с момента времени UTC, начиная с эпохи устройства и его ERROR(/TimeUnit) . Мягкий перезапуск относится к перезапуску system_server без полной перезагрузки устройства (например: запрошенная перезагрузка). Текущее значение utcEpochTime устройства в миллисекундах можно получить методом getDeviceDate() .

Параметры
utcEpochTime long : время устройства в секундах с начала эпохи.

timeUnit TimeUnit : единица времени TimeUnit для данного utcEpochTime.

Возврат
boolean true , если устройство перезапущено

Броски
DeviceNotAvailableException

отключитьAdbRoot

public boolean disableAdbRoot ()

Отключает адб рут.

Отключение adb root может привести к отключению устройства от adb. Этот метод будет заблокирован до тех пор, пока устройство не станет доступным.

Возврат
boolean true в случае успеха.

Броски
DeviceNotAvailableException

отключитьKeyguard

public void disableKeyguard ()

Пытается отключить защиту клавиатуры.

Сначала дождитесь готовности отправки ввода. Это происходит примерно в то же время, когда устройство сообщает BOOT_COMPLETE, по-видимому, асинхронно, поскольку в текущей реализации платформы время от времени возникает состояние гонки. Затем отправляется команда для отключения защиты клавиатуры (работает только на незащищенных устройствах).

Броски
DeviceNotAvailableException

отключитьNetworkMonitor

public boolean disableNetworkMonitor ()

Отключает мониторинг сети на устройстве.

Возврат
boolean true , если мониторинг успешно отключен. false , если это не удалось.

Броски
DeviceNotAvailableException

отключить от Wi-Fi

public boolean disconnectFromWifi ()

Отключается от сети Wi-Fi.

Удаляет все сети из списка известных сетей и отключает Wi-Fi.

Возврат
boolean true , если успешно отключено от сети Wi-Fi. false , если отключение не удалось.

Броски
DeviceNotAvailableException

делаетFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

userId int : идентификатор пользователя, по которому можно проверить существование файла.

Возврат
boolean true , если файл существует, в противном случае false .

Броски
DeviceNotAvailableException

делаетFileExist

public boolean doesFileExist (String deviceFilePath)

Вспомогательный метод для определения существования файла на устройстве.

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

Возврат
boolean true , если файл существует, в противном случае false .

Броски
DeviceNotAvailableException

дампКуча

public File dumpHeap (String process, 
                String devicePath)

Попытайтесь сбросить кучу с system_server. Ответственность за очистку сброшенного файла лежит на вызывающей стороне.

Параметры
process String : имя процесса устройства, на который создается дамп кучи.

devicePath String : путь на устройстве, куда поместить дамп. Это должно быть место, где разрешения позволяют это.

Возврат
File ERROR(/File) , содержащая отчет. Нуль, если что-то не удалось.

Броски
DeviceNotAvailableException

включитьAdbRoot

public boolean enableAdbRoot ()

Включает adb root. Если параметр «enable-root» имеет значение «false», зарегистрирует сообщение и вернется без включения root.

Включение adb root может привести к отключению устройства от adb. Этот метод будет заблокирован до тех пор, пока устройство не станет доступным.

Возврат
boolean true в случае успеха.

Броски
DeviceNotAvailableException

включитьNetworkMonitor

public boolean enableNetworkMonitor ()

Включает сетевой мониторинг на устройстве.

Возврат
boolean true , если мониторинг включен успешно. false , если это не удалось.

Броски
DeviceNotAvailableException

выполнитьAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

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

Вместо этого, где это возможно, следует использовать executeShellCommand(String) , поскольку этот метод обеспечивает лучшее обнаружение сбоев и производительность.

Параметры
timeout long : время в миллисекундах, по истечении которого устройство считается не отвечающим, 0L — без тайм-аута.

cmdArgs String : команда adb и аргументы для запуска.

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

Броски
DeviceNotAvailableException

выполнитьAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

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

Вместо этого, где это возможно, следует использовать executeShellCommand(String) , поскольку этот метод обеспечивает лучшее обнаружение сбоев и производительность.

Параметры
timeout long : время в миллисекундах, по истечении которого устройство считается не отвечающим, 0L — без тайм-аута.

envMap : среда, устанавливаемая для команды

cmdArgs String : команда adb и аргументы для запуска.

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

Броски
DeviceNotAvailableException

выполнитьAdbCommand

public String executeAdbCommand (String... cmdArgs)

Вспомогательный метод, который выполняет команду adb как системную команду.

Вместо этого, где это возможно, следует использовать executeShellCommand(String) , поскольку этот метод обеспечивает лучшее обнаружение сбоев и производительность.

Параметры
cmdArgs String : команда adb и аргументы для запуска.

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

Броски
DeviceNotAvailableException

выполнитьFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

Параметры
cmdArgs String : команда fastboot и аргументы для запуска.

Возврат
CommandResult CommandResult, содержащий вывод команды

Броски
DeviceNotAvailableException

выполнитьFastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

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

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

Параметры
timeout long : время в миллисекундах до истечения срока действия команды.

cmdArgs String : команда fastboot и аргументы для запуска.

Возврат
CommandResult CommandResult, содержащий вывод команды

Броски
DeviceNotAvailableException

выполнитьLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

Идентичен executeFastbootCommand(String) за исключением того, что используется более длительный тайм-аут.

Параметры
cmdArgs String : команда fastboot и аргументы для запуска.

Возврат
CommandResult CommandResult, содержащий вывод команды

Броски
DeviceNotAvailableException

выполнитьLongFastbootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

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

Идентичен executeFastbootCommand(String) за исключением того, что используется более длительный тайм-аут.

Параметры
envVarMap : переменные системной среды, с которыми запускается команда fastboot.

cmdArgs String : команда fastboot и аргументы для запуска.

Возврат
CommandResult CommandResult, содержащий вывод команды

Броски
DeviceNotAvailableException

выполнитьShellCommand

public String executeShellCommand (String command)

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

Параметры
command String : команда оболочки adb для запуска.

Возврат
String вывод оболочки

Броски
DeviceNotAvailableException

выполнитьShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

Параметры
command String : команда оболочки adb для запуска.

receiver IShellOutputReceiver : IShellOutputReceiver для направления вывода оболочки.

maxTimeToOutputShellResponse long : максимальное время, в течение которого команде разрешено не выводить никакого ответа; единица измерения, указанная в timeUnit

timeUnit TimeUnit : единица измерения maxTimeToOutputShellResponse .

retryAttempts int : максимальное количество повторов команды, если она не удалась из-за исключения. DeviceNotResponsiveException будет выброшено, если retryAttempts будут выполнены безуспешно.

Броски
DeviceNotAvailableException

выполнитьShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

Параметры
command String : команда оболочки adb для запуска.

receiver IShellOutputReceiver : IShellOutputReceiver для направления вывода оболочки.

maxTimeoutForCommand long : максимальный тайм-аут выполнения команды; единица измерения, указанная в timeUnit

maxTimeToOutputShellResponse long : максимальное время, в течение которого команде разрешено не выводить никакого ответа; единица измерения, указанная в timeUnit

timeUnit TimeUnit : единица измерения maxTimeToOutputShellResponse .

retryAttempts int : максимальное количество повторов команды, если она не удалась из-за исключения. DeviceNotResponsiveException будет выброшено, если retryAttempts будут выполнены безуспешно.

Броски
DeviceNotAvailableException

выполнитьShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

Упрощенная форма executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) со значениями по умолчанию.

Параметры
command String : команда оболочки adb для запуска.

receiver IShellOutputReceiver : IShellOutputReceiver для направления вывода оболочки.

Броски
DeviceNotAvailableException

выполнитьShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

Параметры
cmd String : команда, которую следует выполнить.

Возврат
CommandResult Результат в CommandResult .

Броски
DeviceNotAvailableException

выполнитьShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Вспомогательный метод, который выполняет команду оболочки adb и возвращает результаты в виде CommandResult , правильно заполненного выводом состояния команды и стандартным потоком stderr. stdout направляется в указанный поток.

Параметры
cmd String : команда, которую следует выполнить.

pipeToOutput OutputStream : ERROR(/OutputStream) , где стандартный вывод будет перенаправлен, или null.

Возврат
CommandResult Результат в CommandResult .

Броски
DeviceNotAvailableException

выполнитьShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

Параметры
cmd String : команда, которую следует выполнить.

pipeAsInput File : ERROR(/File) , которая будет передана в качестве входных данных для команды, или значение NULL.

Возврат
CommandResult Результат в CommandResult .

Броски
DeviceNotAvailableException

выполнитьShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

Параметры
cmd String : команда оболочки adb для запуска.

maxTimeoutForCommand long : максимальный тайм-аут выполнения команды; единица измерения, указанная в timeUnit

timeUnit TimeUnit : единица измерения maxTimeToOutputShellResponse .

retryAttempts int : максимальное количество повторов команды, если она не удалась из-за исключения. DeviceNotResponsiveException будет выброшено, если retryAttempts будут выполнены безуспешно.

Возврат
CommandResult

Броски
DeviceNotAvailableException

выполнитьShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

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

Параметры
cmd String : команда оболочки adb для запуска.

maxTimeoutForCommand long : максимальный тайм-аут выполнения команды; единица измерения, указанная в timeUnit

timeUnit TimeUnit : единица измерения maxTimeToOutputShellResponse .

Возврат
CommandResult

Броски
DeviceNotAvailableException

выполнитьShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

Параметры
cmd String : команда оболочки adb для запуска.

pipeAsInput File : ERROR(/File) , которая будет передана в качестве входных данных для команды, или значение NULL.

pipeToOutput OutputStream : ERROR(/OutputStream) , где стандартный вывод будет перенаправлен, или null.

maxTimeoutForCommand long : максимальный тайм-аут выполнения команды; единица измерения, указанная в timeUnit

timeUnit TimeUnit : единица измерения maxTimeToOutputShellResponse .

retryAttempts int : максимальное количество повторов команды, если она не удалась из-за исключения. DeviceNotResponsiveException будет выброшено, если retryAttempts будут выполнены безуспешно.

Возврат
CommandResult

Броски
DeviceNotAvailableException

выполнитьShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

Параметры
cmd String : команда оболочки adb для запуска.

pipeAsInput File : ERROR(/File) , которая будет передана в качестве входных данных для команды, или значение NULL.

pipeToOutput OutputStream : ERROR(/OutputStream) , где стандартный вывод будет перенаправлен, или null.

pipeToError OutputStream : ERROR(/OutputStream) , где будет перенаправлена ​​стандартная ошибка, или значение null.

maxTimeoutForCommand long : максимальный тайм-аут выполнения команды; единица измерения, указанная в timeUnit

timeUnit TimeUnit : единица измерения maxTimeToOutputShellResponse .

retryAttempts int : максимальное количество повторов команды, если она не удалась из-за исключения. DeviceNotResponsiveException будет выброшено, если retryAttempts будут выполнены безуспешно.

Возврат
CommandResult

Броски
DeviceNotAvailableException

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

Если getUseFastbootErase() имеет значение true , то для очистки раздела будет использоваться быстрая загрузка. Затем устройство должно создать файловую систему при следующей загрузке устройства. В противном случае используется формат fastboot, который создаст новую файловую систему на устройстве.

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

Параметры
partition String : раздел, который нужно стереть.

Возврат
CommandResult CommandResult, содержащий вывод команды

Броски
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

Получите информацию об APEX, активированных на устройстве.

Возврат
ERROR(/Set) ApexInfo , активированного в данный момент на устройстве

Броски
DeviceNotAvailableException

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

public  getAllSettings (String namespace)

Возвращает пары ключ-значение запрошенного пространства имен.

Параметры
namespace String : должна быть одной из {"системных", "безопасных", "глобальных"}.

Возврат
карта пар ключ-значение. Значение NULL, если пространство имен не поддерживается.

Броски
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

Вернуть текущее состояние распределения устройства

Возврат
DeviceAllocationState

получитьAndroidId

public String getAndroidId (int userId)

Найдите и верните идентификатор Android, связанный с идентификатором пользователя, нулевой, если он не найден.

Параметры
userId int

Возврат
String

Броски
DeviceNotAvailableException

получитьAndroidIds

public  getAndroidIds ()

Создайте карту идентификаторов Android, найденных совпадающими с идентификаторами пользователей. Нет никакой гарантии, что каждый идентификатор пользователя найдет идентификатор Android, связанный с этой функцией, поэтому некоторые идентификаторы пользователей могут соответствовать нулю.

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

Броски
DeviceNotAvailableException

getApiLevel

public int getApiLevel ()

Получите уровень API устройства. По умолчанию UNKNOWN_API_LEVEL .

Возврат
int целое число, указывающее уровень API устройства

Броски
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

Параметры
packageName String

Возврат
PackageInfo PackageInfo или null , если информацию невозможно получить.

Броски
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

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

Возврат
ERROR(/List) PackageInfo , установленного на устройстве.

Броски
DeviceNotAvailableException

getBasebandVersion

public String getBasebandVersion ()

Удобный способ получить базовую (радио) версию этого устройства. Получение версии радио зависит от конкретного устройства, поэтому оно может не возвращать правильную информацию для всех устройств. Этот метод использует свойство gsm.version.baseband для возврата правильной информации о версии. Это неверно для некоторых устройств CDMA, и возвращаемая здесь версия может не совпадать с версией, полученной при быстрой загрузке, и может не возвращать версию для радио CDMA. TL;DR этот метод сообщает точную версию только в том случае, если свойство gsm.version.baseband совпадает с версией, возвращаемой fastboot getvar version-baseband .

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

Броски
DeviceNotAvailableException

getBattery

public Integer getBattery ()

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

Возврат
Integer

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

Параметры
name String : имя свойства.

defaultValue boolean : значение по умолчанию, которое возвращается, если свойство пусто или не существует.

Возврат
boolean true , если свойство имеет значение "1" , "y" , "yes" , "on" или "true" , false , если свойство имеет значение "0" , "n" , "no" , "off" , "false" или в противном случае defaultValue .

Броски
DeviceNotAvailableException

getBootHistory

public  getBootHistory ()

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

Возврат
Карта времени загрузки (время UTC в секундах с начала эпохи) и причина загрузки

Броски
DeviceNotAvailableException

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Вспомогательный метод собирает карту истории загрузки со временем загрузки и причиной загрузки с заданного времени, начиная с эпохи с устройства и указанной единицы времени. Текущее значение utcEpochTime устройства в миллисекундах можно получить методом getDeviceDate() .

Параметры
utcEpochTime long : время устройства с момента Epoch.

timeUnit TimeUnit : единица времени TimeUnit .

Возврат
Карта времени загрузки (время UTC в секундах с начала эпохи) и причина загрузки

Броски
DeviceNotAvailableException

getBootloaderVersion

public String getBootloaderVersion ()

Удобный способ получить версию загрузчика этого устройства.

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

Возврат
String String версия загрузчика или null , если ее невозможно найти

Броски
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

Получает отчет об ошибке с устройства.

Реализация этого гарантированно продолжит работать на устройстве без SD-карты (или где SD-карта еще не смонтирована).

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

getBugreportz

public InputStreamSource getBugreportz ()

Получает отчет об ошибке с устройства. Отчет об ошибках в формате ZIP содержит основной отчет об ошибках и другие файлы журналов, полезные для отладки.

Поддерживается только для версии adb > 1.0.36.

Возврат
InputStreamSource InputStreamSource zip-файла, содержащего bugreportz, в случае сбоя возвращает значение null.

getBuildAlias

public String getBuildAlias ()

Получите псевдоним сборки, которую в данный момент выполняет устройство.

Псевдоним сборки обычно представляет собой более удобочитаемую строку, чем идентификатор сборки (обычно число для сборок Nexus). Например, финальная версия Android 4.2 имеет псевдоним сборки JDQ39 и идентификатор сборки 573038.

Возврат
String псевдоним сборки или вернуться к идентификатору сборки, если его не удалось получить

Броски
DeviceNotAvailableException

getBuildFlavor

public String getBuildFlavor ()

Получите версию сборки для устройства.

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

Броски
DeviceNotAvailableException

getBuildId

public String getBuildId ()

Получите сборку, на которой в данный момент работает устройство.

Возврат
String идентификатор сборки или IBuildInfo#UNKNOWN_BUILD_ID , если его не удалось получить

Броски
DeviceNotAvailableException

getBuildSigningKeys

public String getBuildSigningKeys ()

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

Обычно устройства Android могут быть подписаны с помощью тестовых ключей (например, в AOSP) или ключей выпуска (контролируемых отдельными производителями устройств).

Возврат
String Ключ подписи, если он найден, в противном случае — значение NULL.

Броски
DeviceNotAvailableException

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

Возврат
DeviceDescriptor

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

Параметры
shortDescriptor boolean : следует ли ограничивать дескриптор минимальной информацией.

Возврат
DeviceDescriptor

getChildren

public String[] getChildren (String path)

Альтернатива использованию IFileEntry , которая иногда не работает из-за разрешений.

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

Возврат
String[] Массив строк, содержащий все файлы по пути на устройстве.

Броски
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

Текущее соединение, связанное с устройством.

Возврат
AbstractConnection

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

Возврат
DeviceFoldableState

Броски
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

Возвращает идентификатор текущего работающего пользователя. В случае ошибки верните -10000.

Возврат
int

Броски
DeviceNotAvailableException

GetDeviceClass

public String getDeviceClass ()

Получите класс устройства.

Возврат
String класс устройства String .

getDeviceDate

public long getDeviceDate ()

Возвращает дату устройства в миллисекундах с начала эпохи.

Возврат
long дата устройства в формате эпохи.

Броски
DeviceNotAvailableException

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

Возврат
DeviceDescriptor

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

Параметры
shortDescriptor boolean : следует ли ограничивать дескриптор минимальной информацией.

Возврат
DeviceDescriptor

getDeviceState

public TestDeviceState getDeviceState ()

Получите состояние устройства.

Возврат
TestDeviceState

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Помощник для получения разницы во времени между устройством и заданной ERROR(/Date) . Используйте время эпохи для внутренних целей.

Параметры
date Date

Возврат
long разница в миллисекундах

Броски
DeviceNotAvailableException

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Получите поток stdout и stderr эмулятора.

Возврат
InputStreamSource выход эмулятора

GetEmulatorProcess

public Process getEmulatorProcess ()

Верните Process , соответствующий этому эмулятору.

Возврат
Process Process или null

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

Журнал, содержащий все журналы executeShellCommand(String) .

Возврат
File

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

Вспомогательный метод для определения объема свободного места на внешнем хранилище устройства.

Возврат
long объем свободного места в КБ

Броски
DeviceNotAvailableException

получитьFastbootPath

public String getFastbootPath ()

Возвращает путь к используемому двоичному файлу fastboot. По-прежнему требуется, чтобы isFastbootEnabled() имело значение true, чтобы функции быстрой загрузки были включены.

Возврат
String

getFastbootProductType

public String getFastbootProductType ()

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

Этот метод следует использовать только в том случае, если устройство должно находиться в режиме быстрой загрузки. В данном случае это немного более безопасный вариант, чем общий метод getProductType() , поскольку ITestDevice будет знать, что нужно восстановить устройство в режиме быстрой загрузки, если устройство находится в неправильном состоянии или не отвечает.

Возврат
String имя типа продукта String или null , если его невозможно определить.

Броски
DeviceNotAvailableException

получитьFastbootProductVariant

public String getFastbootProductVariant ()

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

Этот метод следует использовать только в том случае, если устройство должно находиться в режиме быстрой загрузки. В данном случае это немного более безопасный вариант, чем общий метод getProductType() , поскольку ITestDevice будет знать, что нужно восстановить устройство в режиме быстрой загрузки, если устройство находится в неправильном состоянии или не отвечает.

Возврат
String имя типа продукта String или null , если его невозможно определить.

Броски
DeviceNotAvailableException

ПолучитьFastbootSerialNumber

public String getFastbootSerialNumber ()

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

Возврат
String

получитьFastbootVariable

public String getFastbootVariable (String variableName)

Получите заданное значение переменной fastboot с устройства.

Параметры
variableName String : имя переменной.

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

Броски
DeviceNotAvailableException

получитьFastbootVersion

public String getFastbootVersion ()

Возвращает строку версии используемого двоичного файла fastboot. Или ноль, если что-то пойдет не так.

Возврат
String

getFileEntry

public IFileEntry getFileEntry (String path)

Получить ссылку на удаленный файл на устройстве.

Параметры
path String : путь к файлу для получения. Может быть абсолютным путем или путем относительно '/'. (т.е. поддерживается синтаксис «/system» и «system»)

Возврат
IFileEntry IFileEntry или null , если файл по заданному path не найден

Броски
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Неофициальный помощник для получения FileEntry по некорневому пути. ИСПРАВЛЕНИЕ: Реорганизуйте систему FileEntry, чтобы она была доступна по любому пути. (даже без root).

Параметры
entry FileListingService.FileEntry : FileEntry не обязательно является корневым, как того требует Ddmlib.

Возврат
IFileEntry FileEntryWrapper, представляющий FileEntry.

Броски
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

Возвращает список складных состояний на устройстве. Можно получить с помощью «cmd device_state print-states».

Возврат

Броски
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

Возвращает ссылку на связанный IDevice ddmlib.

Новый IDevice может выделяться DDMS каждый раз, когда устройство отключается и повторно подключается к adb. Таким образом, вызывающие объекты не должны сохранять ссылку на IDevice , поскольку эта ссылка может устареть.

Возврат
IDevice IDevice

getInstalledPackageNames

public  getInstalledPackageNames ()

Получите имена пакетов приложений, присутствующих на устройстве.

Возврат
ERROR(/Set) имен String пакетов, установленных в данный момент на устройстве.

Броски
DeviceNotAvailableException

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

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

Параметры
name String : имя свойства.

defaultValue long : значение по умолчанию, которое возвращается, если свойство пусто или не существует.

Возврат
long значение свойства или defaultValue если свойство пусто, не существует или не имеет целочисленного значения.

Броски
DeviceNotAvailableException

получитьIpAddress

public String getIpAddress ()

Получает IP-адрес устройства.

Возврат
String IP-адрес устройства или null , если у устройства нет IP-адреса

Броски
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

Возврат
KeyguardControllerState KeyguardControllerState , содержащий снимок состояния Keyguard и возвращает значение Null, если запрос Keyguard не поддерживается.

Броски
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

Возвращает последний раз, когда API-интерфейсы Tradefed запускали перезагрузку в миллисекундах с момента EPOCH, как возвращается System.currentTimeMillis() .

Возврат
long

getLaunchApiLevel

public int getLaunchApiLevel ()

Получите первый запущенный уровень API устройства. По умолчанию UNKNOWN_API_LEVEL .

Возврат
int целое число, указывающее первый запущенный уровень API устройства

Броски
DeviceNotAvailableException

getLogcat

public InputStreamSource getLogcat ()

Получает поток снимков данных logcat.

Работает в двух режимах:

  • Если логарифмический кот в настоящее время захватывается в фоновом режиме, возвращается до байтов TestDeviceOptions.getMaxLogcatDataSize() текущего содержимого фонового захвата логарифмического кота.
  • В противном случае будет возвращен статический дамп данных logcat, если устройство в данный момент отвечает.

    Возврат
    InputStreamSource

  • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

    Получает поток снимков последних maxBytes захваченных данных logcat.

    Полезно в случаях, когда вы хотите часто делать снимки захваченных данных logcat, не подвергаясь потенциально большому штрафу за дисковое пространство, связанному с получением всего снимка getLogcat() .

    Параметры
    maxBytes int : максимальный объем возвращаемых данных. Должно быть количество, которое может удобно поместиться в памяти.

    Возврат
    InputStreamSource

    getLogcatDump

    public InputStreamSource getLogcatDump ()

    Получите дамп текущего логарифма устройства. В отличие от getLogcat() , этот метод всегда будет возвращать статический дамп logcat.

    Имеет тот недостаток, что ничего не будет возвращено, если устройство недоступно.

    Возврат
    InputStreamSource InputStreamSource данных logcat. Пустой поток возвращается, если не удается захватить данные logcat.

    getLogcatSince

    public InputStreamSource getLogcatSince (long date)

    Получает поток снимков записанных данных logcat, начиная с указанной даты. Для времени на устройстве следует использовать getDeviceDate() .

    Параметры
    date long : формат в миллисекундах с момента начала создания моментального снимка до настоящего момента. (можно получить, используя «дата +%s»)

    Возврат
    InputStreamSource

    получитьMacAddress

    public String getMacAddress ()

    Возвращает MAC-адрес устройства, нулевой, если не удалось выполнить запрос с устройства.

    Возврат
    String

    getMainUserId

    public Integer getMainUserId ()

    Возвращает основной идентификатор пользователя.

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

    Броски
    DeviceNotAvailableException

    getMainlineModuleInfo

    public  getMainlineModuleInfo ()

    Получите информацию об основных модулях, установленных на устройстве.

    Возврат
    ERROR(/Set) основных модулей String , установленных в данный момент на устройстве.

    Броски
    DeviceNotAvailableException

    getMaxNumberOfRunningUsersSupported

    public int getMaxNumberOfRunningUsersSupported ()

    Получите максимальное количество поддерживаемых одновременно работающих пользователей. По умолчанию 0.

    Возврат
    int целое число, указывающее количество одновременно работающих пользователей

    Броски
    DeviceNotAvailableException

    getMaxNumberOfUsersSupported

    public int getMaxNumberOfUsersSupported ()

    Получите максимальное количество поддерживаемых пользователей. По умолчанию 0.

    Возврат
    int целое число, указывающее количество поддерживаемых пользователей

    Броски
    DeviceNotAvailableException

    GetMicroroidProcess

    public Process getMicrodroidProcess ()

    Возврат
    Process Возвращает процесс виртуальной машины Microdroid. Если TestDevice не является Microdroid, возвращает значение null.

    getMonitor

    public IDeviceStateMonitor getMonitor ()

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

    Возврат
    IDeviceStateMonitor

    getMountPoint

    public String getMountPoint (String mountName)

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

    Запрашивает устройство напрямую, если кэшированная информация в IDevice недоступна.

    TODO: переместите это поведение в IDevice#getMountPoint(String)

    Параметры
    mountName String : имя точки монтирования.

    Возврат
    String точка монтирования или null

    getMountPointInfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Возвращает MountPointInfo соответствующий указанному пути к точке монтирования, или null , если по этому пути ничего не смонтировано или по какой-либо причине не отображается в /proc/mounts как точка монтирования.

    Параметры
    mountpoint String

    Возврат
    ITestDevice.MountPointInfo ERROR(/List) MountPointInfo , содержащая информацию в "/proc/mounts"

    Броски
    DeviceNotAvailableException

    getMountPointInfo

    public  getMountPointInfo ()

    Возвращает проанализированную версию информации в /proc/mounts на устройстве.

    Возврат
    ERROR(/List) MountPointInfo , содержащая информацию в "/proc/mounts"

    Броски
    DeviceNotAvailableException

    getOptions

    public TestDeviceOptions getOptions ()

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

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

    getPartitionFreeSpace

    public long getPartitionFreeSpace (String partition)

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

    Параметры
    partition String

    Возврат
    long объем свободного места в КБ

    Броски
    DeviceNotAvailableException

    получитьPrimaryUserId

    public Integer getPrimaryUserId ()

    Возвращает основной идентификатор пользователя.

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

    Броски
    DeviceNotAvailableException

    getProcessByName

    public ProcessInfo getProcessByName (String processName)

    Вспомогательный метод запускает команды «pidof» и «stat» и возвращает объект ProcessInfo с PID и временем запуска данного процесса.

    Параметры
    processName String : имя процесса String.

    Возврат
    ProcessInfo Информация о процессе данного имени процесса

    Броски
    DeviceNotAvailableException

    getProcessPid

    public String getProcessPid (String process)

    Возвращает pid службы или значение null, если что-то пошло не так.

    Параметры
    process String : имя процесса String.

    Возврат
    String

    Броски
    DeviceNotAvailableException

    getProductType

    public String getProductType ()

    Удобный способ узнать тип продукта этого устройства.

    Этот метод будет работать, если устройство находится в режиме adb или fastboot.

    Возврат
    String String название типа продукта. Не будет нулевым

    Броски
    DeviceNotAvailableException

    GetProductVariant

    public String getProductVariant ()

    Удобный способ получить вариант продукта этого устройства.

    Этот метод будет работать, если устройство находится в режиме adb или fastboot.

    Возврат
    String имя варианта продукта String или null , если его невозможно определить.

    Броски
    DeviceNotAvailableException

    getProperty

    public String getProperty (String name)

    Получите заданное значение свойства с устройства.

    Параметры
    name String : имя свойства.

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

    Броски
    DeviceNotAvailableException

    getRecoveryMode

    public ITestDevice.RecoveryMode getRecoveryMode ()

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

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

    getScreenshot

    public InputStreamSource getScreenshot (String format)

    Делает скриншот с устройства. Рекомендуется использовать getScreenshot(format) вместо кодировки JPEG для меньшего размера.

    Параметры
    format String : поддерживается PNG, JPEG.

    Возврат
    InputStreamSource InputStreamSource снимка экрана в формате или null , если снимок экрана не удался.

    Броски
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (long displayId)

    Делает снимок экрана с устройства с заданным идентификатором дисплея. Формат: PNG.

    ЗАДАЧА: расширить приведенные выше реализации для поддержки «форматирования» и «масштабирования».

    Параметры
    displayId long : идентификатор экрана, с которого нужно получить снимок экрана.

    Возврат
    InputStreamSource InputStreamSource снимка экрана в формате или null , если снимок экрана не удался.

    Броски
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

    Делает скриншот с устройства. Рекомендуется использовать getScreenshot(String) вместо кодировки JPEG для меньшего размера.

    Параметры
    format String : поддерживается PNG, JPEG.

    rescale boolean : если снимок экрана необходимо масштабировать, чтобы уменьшить размер результирующего изображения.

    Возврат
    InputStreamSource InputStreamSource снимка экрана в формате или null , если снимок экрана не удался.

    Броски
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot ()

    Делает скриншот с устройства.

    Возврат
    InputStreamSource InputStreamSource снимка экрана в формате png или null , если снимок экрана не удался.

    Броски
    DeviceNotAvailableException

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

    public String getSerialNumber ()

    Удобный способ получить серийный номер этого устройства.

    Возврат
    String Серийный номер String

    getSetting

    public String getSetting (int userId, 
                    String namespace, 
                    String key)

    Верните значение запрошенного параметра. пространство имен должно быть одним из: {"системный", "безопасный", "глобальный"}

    Параметры
    userId int

    namespace String

    key String

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

    Броски
    DeviceNotAvailableException

    getSetting

    public String getSetting (String namespace, 
                    String key)

    См. getSetting(int, String, String) и выполняется для системного пользователя.

    Параметры
    namespace String

    key String

    Возврат
    String

    Броски
    DeviceNotAvailableException

    getSimOperator

    public String getSimOperator ()

    Верните оператора SIM-карты или ноль, если он недоступен или устройство недоступно.

    Возврат
    String

    getSimState

    public String getSimState ()

    Верните состояние SIM-карты или нулевое значение, если оно недоступно или устройство недоступно.

    Возврат
    String

    получить надгробия

    public  getTombstones ()

    Получите и верните список надгробий с устройств. Требуется рут.

    Этот метод является максимально эффективным, поэтому, если одно надгробие по какой-либо причине не удастся извлечь, оно будет отсутствовать в списке. Только исключение DeviceNotAvailableException приведет к досрочному завершению метода.

    Возврат
    Список файлов-захоронений, пустой, если надгробий нет.

    Броски
    DeviceNotAvailableException

    getTotalMemory

    public long getTotalMemory ()

    Возвращает общий размер физической памяти в байтах или -1 в случае внутренней ошибки.

    Возврат
    long

    getUninstallablePackageNames

    public  getUninstallablePackageNames ()

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

    Возврат
    ERROR(/Set) имен неустановимых String пакетов, установленных в настоящее время на устройстве.

    Броски
    DeviceNotAvailableException

    getUseFastbootErase

    public boolean getUseFastbootErase ()

    Узнайте, следует ли использовать Fastboot Erase или Fastboot Format для очистки раздела на устройстве.

    Возврат
    boolean true , если будет использоваться стирание fastboot, или false если будет использоваться формат fastboot.

    getUserFlags

    public int getUserFlags (int userId)

    Найдите и верните флаги данного пользователя. Флаги определяются в классе «android.content.pm.UserInfo» в проекте Android с открытым исходным кодом.

    Параметры
    userId int

    Возврат
    int флаги, связанные с предоставленным идентификатором пользователя, если они найдены, -10000 в любых других случаях.

    Броски
    DeviceNotAvailableException

    getUserInfos

    public  getUserInfos ()

    Получает сопоставление useId с UserInfo на устройстве. Вызовет DeviceRuntimeException , если вывод с устройства не соответствует ожиданиям.

    Возврат
    список объектов UserInfo.

    Броски
    DeviceNotAvailableException

    getUserSerialNumber

    public int getUserSerialNumber (int userId)

    Возвращает серийный номер, связанный с идентификатором пользователя, если он найден, -10000 в любых других случаях.

    Параметры
    userId int

    Возврат
    int

    Броски
    DeviceNotAvailableException

    handleAllocationEvent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    Обработать данное DeviceEvent. Может перевести устройство в новое состояние. Сообщает IDeviceMonitor о любых переходах состояний.

    Обработайте DeviceEvent, который может перевести или не перевести это устройство в новое состояние распределения.

    Параметры
    event DeviceEvent

    Возврат
    IManagedTestDevice.DeviceEventResponse

    имеет особенность

    public boolean hasFeature (String feature)

    Проверьте, доступна ли функция на устройстве.

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

    Возврат
    boolean True, если функция найдена, в противном случае — false.

    Броски
    DeviceNotAvailableException

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

    public String installPackage (File packageFile, 
                    boolean reinstall, 
                    String... extraArgs)

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

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

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

    extraArgs String : необязательные дополнительные аргументы для передачи. Доступные параметры см. в «adbshell pm -h».

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

    Броски
    DeviceNotAvailableException

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

    public String installPackage (File packageFile, 
                    boolean reinstall, 
                    boolean grantPermissions, 
                    String... extraArgs)

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

    Примечание. Эту функцию следует вызывать только в тех случаях, когда требуется явный контроль предоставления разрешений среды выполнения во время установки.

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

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

    grantPermissions boolean : если все разрешения времени выполнения должны быть предоставлены во время установки

    extraArgs String : необязательные дополнительные аргументы для передачи. Доступные параметры см. в «adbshell pm -h».

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

    Броски
    DeviceNotAvailableException

    installPackageForUser

    public String installPackageForUser (File packageFile, 
                    boolean reinstall, 
                    int userId, 
                    String... extraArgs)

    Установите пакет Android на устройство для данного пользователя.

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

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

    userId int : целочисленный идентификатор пользователя для установки.

    extraArgs String : необязательные дополнительные аргументы для передачи. Доступные параметры см. в «adbshell pm -h».

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

    Броски
    DeviceNotAvailableException

    installPackageForUser

    public String installPackageForUser (File packageFile, 
                    boolean reinstall, 
                    boolean grantPermissions, 
                    int userId, 
                    String... extraArgs)

    Установите пакет Android на устройство для данного пользователя.

    Примечание. Эту функцию следует вызывать только в тех случаях, когда требуется явный контроль предоставления разрешений среды выполнения во время установки.

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

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

    grantPermissions boolean : если все разрешения времени выполнения должны быть предоставлены во время установки

    userId int : целочисленный идентификатор пользователя для установки.

    extraArgs String : необязательные дополнительные аргументы для передачи. Доступные параметры см. в «adbshell pm -h».

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

    Броски
    DeviceNotAvailableException

    недействительныйPropertyCache

    public void invalidatePropertyCache ()

    isAdbRoot

    public boolean isAdbRoot ()

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    isAdbTcp

    public boolean isAdbTcp ()

    Возврат
    boolean

    isAppEnumerationSupported

    public boolean isAppEnumerationSupported ()

    Проверьте, поддерживает ли платформа на устройстве перечисление приложений.

    Возврат
    boolean True, если перечисление приложений поддерживается, в противном случае — false.

    Броски
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public boolean isBypassLowTargetSdkBlockSupported ()

    Проверьте, поддерживает ли платформа на устройстве обход блокировки SDK с низкой целью при установке приложения.

    Возврат
    boolean True, если поддерживается обход блока SDK с низким целевым значением, в противном случае — false.

    Броски
    DeviceNotAvailableException

    isDebugfsMounted

    public boolean isDebugfsMounted ()

    Проверьте, смонтирован ли debugfs.

    Возврат
    boolean true , если debugfs смонтирован

    Броски
    DeviceNotAvailableException

    isDeviceEncrypted

    public boolean isDeviceEncrypted ()

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

    Возврат
    boolean true , если устройство зашифровано.

    Броски
    DeviceNotAvailableException

    isDirectory

    public boolean isDirectory (String path)

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

    Параметры
    path String

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    исенаблеадбрут

    public boolean isEnableAdbRoot ()

    Возврат
    boolean true , если на устройстве должен быть включен adb root

    isEncryptionSupported

    public boolean isEncryptionSupported ()

    Возвращается, если на устройстве поддерживается шифрование.

    Возврат
    boolean true , если устройство поддерживает шифрование.

    Броски
    DeviceNotAvailableException

    isExecutable

    public boolean isExecutable (String fullPath)

    Возвращает true, если путь к файлу на устройстве является исполняемым файлом, в противном случае — false.

    Параметры
    fullPath String

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    isFastbootEnabled

    public boolean isFastbootEnabled ()

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

    Возврат
    boolean

    isHeadless

    public boolean isHeadless ()

    Возвращайте true, если устройство не имеет дисплея (без экрана), в противном случае — false.

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    isHeadlessSystemUserMode

    public boolean isHeadlessSystemUserMode ()

    Возвращает, использует ли устройство пользовательский режим безголовой системы.

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    isMainUserPermanentAdmin

    public boolean isMainUserPermanentAdmin ()

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

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    isMultiUserSupported

    public boolean isMultiUserSupported ()

    Определяет, поддерживается ли многопользовательский режим.

    Возврат
    boolean true, если поддерживается многопользовательский режим, в противном случае — false

    Броски
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName, 
                    String userId)

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

    Параметры
    packageName String : пакет, который мы проверяем, установлен ли он.

    userId String : идентификатор пользователя, для которого мы проверяем пакет, установлен. Если значение равно нулю, будет использоваться нулевой основной пользователь.

    Возврат
    boolean Истинно, если пакет указан как установленный. В противном случае неверно.

    Броски
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName)

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

    Параметры
    packageName String

    Возврат
    boolean Истинно, если пакет указан как установленный. В противном случае неверно.

    Броски
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public boolean isRuntimePermissionSupported ()

    Проверьте, поддерживает ли платформа на устройстве предоставление разрешений во время выполнения.

    Возврат
    boolean True, если поддерживаются разрешения во время выполнения, в противном случае — false.

    Броски
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public boolean isStateBootloaderOrFastbootd ()

    Возвращает true, если устройство находится в TestDeviceState#FASTBOOT или TestDeviceState.FASTBOOTD .

    Возврат
    boolean

    isUserRunning

    public boolean isUserRunning (int userId)

    Проверьте, работает ли данный пользователь.

    Параметры
    userId int

    Возврат
    boolean True, если пользователь работает, и false во всех остальных случаях.

    Броски
    DeviceNotAvailableException

    isUserSecondary

    public boolean isUserSecondary (int userId)

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

    Параметры
    userId int

    Возврат
    boolean true, если пользователь является второстепенным, в противном случае — false.

    Броски
    DeviceNotAvailableException

    isUserVisible

    public boolean isUserVisible (int userId)

    Проверяет, виден ли данный пользователь.

    «Видимый» пользователь — это пользователь, который взаимодействует с «человеком» и, следовательно, может запускать действия по запуску (обычно на дисплее по умолчанию).

    Параметры
    userId int

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    isUserVisibleOnDisplay

    public boolean isUserVisibleOnDisplay (int userId, 
                    int displayId)

    Проверяет, виден ли данный пользователь на данном дисплее.

    «Видимый» пользователь — это пользователь, который взаимодействует с «человеком»-пользователем и, следовательно, может запускать действия по запуску на этом дисплее.

    Параметры
    userId int

    displayId int

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    isVisibleBackgroundUsersOnDefaultDisplaySupported

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

    Возвращает, позволяет ли устройство запускать пользователей видимыми в фоновом режиме в ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

    Если это так, вы можете вызвать startVisibleBackgroundUser(int, int, boolean) , передав отображение, возвращаемое listDisplayIdsForStartingVisibleBackgroundUsers() (который должен включать ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    isVisibleBackgroundUsersSupported

    public boolean isVisibleBackgroundUsersSupported ()

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

    Если это так, вы можете вызвать startVisibleBackgroundUser(int, int, boolean) , передав отображение, возвращаемое listDisplayIdsForStartingVisibleBackgroundUsers() .

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    isWiFiEnabled

    public boolean isWifiEnabled ()

    Проверьте, включен ли Wi-Fi.

    Проверяет, включен ли Wi-Fi на устройстве. Полезно для подтверждения статуса Wi-Fi перед тестами, которые не должны выполняться с Wi-Fi, например, тестами мобильных данных.

    Возврат
    boolean true , если Wi-Fi включен. false , если отключено

    Броски
    DeviceNotAvailableException

    списокдисплейидс

    public  listDisplayIds ()

    Соберите список доступных идентификаторов дисплеев на устройстве, как сообщает «dumpsys SurfaceFlinger».

    Возврат
    Список дисплеев. Default всегда возвращает отображение по умолчанию 0.

    Броски
    DeviceNotAvailableException

    listDisplayIdsForStartingVisibleBackgroundUsers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

    Получает список дисплеев, которые можно использовать, чтобы start a user visible in the background .

    Возврат

    Броски
    DeviceNotAvailableException

    списокПользователи

    public  listUsers ()

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

    Возврат
    список идентификаторов пользователей.

    Броски
    DeviceNotAvailableException

    logAnrs

    public boolean logAnrs (ITestLogger logger)

    Собирает и регистрирует ошибки ANR с устройства.

    Параметры
    logger ITestLogger : ITestLogger для регистрации ошибок ANR.

    Возврат
    boolean True, если регистрация прошла успешно, в противном случае — false.

    Броски
    DeviceNotAvailableException

    журнал ошибок

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

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

    Параметры
    dataName String : имя, под которым будет сообщаться об ошибке.

    listener ITestLogger : ITestLogger для регистрации отчета об ошибке.

    Возврат
    boolean True, если регистрация прошла успешно, в противном случае — false.

    войти надевице

    public void logOnDevice (String tag, 
                    Log.LogLevel level, 
                    String format, 
                    Object... args)

    Зарегистрируйте сообщение в logcat устройства. Это безопасный вызов, который не выдастся даже в случае сбоя ведения журнала.

    Параметры
    tag String : тег, под которым мы записываем наше сообщение в logcat.

    level Log.LogLevel : уровень отладки сообщения в logcat.

    format String : формат сообщения.

    args Object : аргументы, которые необходимо заменить с помощью String.format().

    mountDebugfs

    public void mountDebugfs ()

    Смонтируйте отладочную файлы.

    Броски
    DeviceNotAvailableException

    неблокирующая перезагрузка

    public void nonBlockingReboot ()

    Выдает команду на перезагрузку устройства и возвращает результат после завершения команды и когда устройство больше не отображается в adb.

    Броски
    DeviceNotAvailableException

    постAdbRootAction

    public void postAdbRootAction ()

    Переопределить, если устройству необходимо выполнить какие-то определенные действия после получения root-доступа adb и до того, как устройство снова подключится к сети. Реализация по умолчанию не включает никаких дополнительных действий. На этом этапе не гарантируется, что adb root будет включен.

    Броски
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    постAdbUnrootAction

    public void postAdbUnrootAction ()

    Переопределить, если устройству необходимо выполнить какие-то определенные действия после отключения adb и до того, как устройство снова подключится к сети. Реализация по умолчанию не включает никаких дополнительных действий. На этом этапе adb root не обязательно будет отключен.

    Броски
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    постBootSetup

    public void postBootSetup ()

    Выполняйте инструкции по настройке устройства для тестирования после каждой загрузки.

    Должен вызываться после того, как устройство полностью загрузится/доступно.

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

    Его может потребоваться вызвать, когда устройство перезагружается из-за других событий (например, после завершения команды обновления fastboot).

    Броски
    DeviceNotAvailableException

    постПризывСнос

    public void postInvocationTearDown (Throwable exception)

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

    Параметры
    exception Throwable : если есть, последнее исключение, вызванное сбоем вызова.

    предвызовНастройка

    public void preInvocationSetup (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    Дополнительные шаги для необходимой настройки конкретного устройства, которые будут выполняться на устройстве перед потоком вызова.

    Параметры
    info IBuildInfo : IBuildInfo устройства.

    attributes MultiMap : атрибуты, хранящиеся в контексте вызова.

    Броски
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Рекурсивно извлекать содержимое каталога с устройства.

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

    localDir File : локальный каталог для извлечения файлов.

    Возврат
    boolean true , если файл был успешно извлечен. false в противном случае.

    Броски
    DeviceNotAvailableException

    вытащить файл

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Извлекает файл с устройства.

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

    localFile File : локальный файл для хранения содержимого. Если не пусто, содержимое будет заменено.

    Возврат
    boolean true , если файл был успешно получен. false в противном случае.

    Броски
    DeviceNotAvailableException

    вытащить файл

    public File pullFile (String remoteFilePath, 
                    int userId)

    Извлекает файл с устройства, сохраняет его в локальной временной ERROR(/File) и возвращает этот File .

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

    userId int : идентификатор пользователя, из которого нужно извлечь

    Возврат
    File ERROR(/File) , содержащий содержимое файла устройства, или null если копирование не удалось по какой-либо причине (включая проблемы с файловой системой хоста).

    Броски
    DeviceNotAvailableException

    вытащить файл

    public File pullFile (String remoteFilePath)

    Извлекает файл с устройства, сохраняет его в локальной временной ERROR(/File) и возвращает этот File .

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

    Возврат
    File ERROR(/File) , содержащий содержимое файла устройства, или null если копирование не удалось по какой-либо причине (включая проблемы с файловой системой хоста).

    Броски
    DeviceNotAvailableException

    вытащить файл

    public boolean pullFile (String remoteFilePath, 
                    File localFile, 
                    int userId)

    Извлекает файл с устройства.

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

    localFile File : локальный файл для хранения содержимого. Если не пусто, содержимое будет заменено.

    userId int : идентификатор пользователя, из которого нужно извлечь

    Возврат
    boolean true , если файл был успешно получен. false в противном случае.

    Броски
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

    Извлекает файл с устройства и возвращает его содержимое.

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

    Возврат
    String String , содержащая содержимое файла устройства, или null , если копирование не удалось по какой-либо причине (включая проблемы с файловой системой хоста).

    Броски
    DeviceNotAvailableException

    вытащить филефромекстернал

    public File pullFileFromExternal (String remoteFilePath)

    Удобный метод получения файла из внешнего хранилища устройства, сохранения его в локальной временной ERROR(/File) и возврата ссылки на этот File .

    Параметры
    remoteFilePath String : путь к файлу на устройстве относительно точки монтирования внешнего хранилища устройства.

    Возврат
    File ERROR(/File) , содержащий содержимое файла устройства, или null если копирование не удалось по какой-либо причине (включая проблемы с файловой системой хоста).

    Броски
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath, 
                     excludedDirectories)

    Рекурсивно отправлять содержимое каталога на устройство, исключая некоторые фильтруемые каталоги.

    Параметры
    localFileDir File : локальный каталог для отправки

    deviceFilePath String : абсолютный путь к файлу удаленного пункта назначения.

    excludedDirectories : Набор имен исключенных каталогов, которые не следует пересылать.

    Возврат
    boolean true , если файл был успешно отправлен. false в противном случае.

    Броски
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

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

    Параметры
    localFileDir File : локальный каталог для отправки

    deviceFilePath String : абсолютный путь к файлу удаленного пункта назначения.

    Возврат
    boolean true , если файл был успешно отправлен. false в противном случае.

    Броски
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath, 
                    boolean evaluateContentProviderNeeded)

    Вариант pushFile(File, String) , который может дополнительно учитывать необходимость оценки потребности в поставщике контента.

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

    remoteFilePath String : абсолютный путь к файлу удаленного пункта назначения.

    evaluateContentProviderNeeded boolean : нужно ли проверять, нужен ли нам поставщик контента

    Возврат
    boolean true , если файл был успешно отправлен. false в противном случае.

    Броски
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    Отправьте файл на устройство. По умолчанию используется поставщик контента.

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

    remoteFilePath String : абсолютный путь к файлу удаленного пункта назначения.

    Возврат
    boolean true , если файл был успешно отправлен. false в противном случае.

    Броски
    DeviceNotAvailableException

    pushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

    Отправить файл, созданный из строки, на устройство

    Параметры
    contents String : содержимое файла для отправки.

    remoteFilePath String : абсолютный путь к файлу удаленного пункта назначения.

    Возврат
    boolean true , если строка была успешно отправлена. false в противном случае.

    Броски
    DeviceNotAvailableException

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

    public void reboot (String reason)

    Перезагружает устройство в режиме adb с указанием reason , которая будет сохраняться при перезагрузке.

    Блокируется до тех пор, пока устройство не станет доступным.

    Причину последней перезагрузки можно узнать, запросив свойство sys.boot.reason .

    Параметры
    reason String : причина перезагрузки или null , если причина не указана.

    Броски
    DeviceNotAvailableException

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

    public void reboot ()

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

    Блокируется до тех пор, пока устройство не станет доступным.

    Броски
    DeviceNotAvailableException

    перезагрузкаIntoBootloader

    public void rebootIntoBootloader ()

    Перезагружает устройство в режим загрузчика.

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

    Броски
    DeviceNotAvailableException

    перезагрузкаIntoFastbootd

    public void rebootIntoFastbootd ()

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

    Блокируется до тех пор, пока устройство не перейдет в режим fastbootd.

    Броски
    DeviceNotAvailableException

    перезагрузкаIntoRecovery

    public void rebootIntoRecovery ()

    Перезагружает устройство в режим восстановления adb.

    Блокируется до тех пор, пока устройство не войдет в режим восстановления.

    Броски
    DeviceNotAvailableException

    перезагрузкаIntoSideload

    public void rebootIntoSideload ()

    Перезагружает устройство в режим боковой загрузки adb (обратите внимание, что это специальный режим в режиме восстановления)

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

    Броски
    DeviceNotAvailableException

    перезагрузкаIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

    Перезагружает устройство в режим боковой загрузки adb (обратите внимание, что это специальный режим в режиме восстановления)

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

    Параметры
    autoReboot boolean : следует ли автоматически перезагружать устройство после загрузки неопубликованных приложений.

    Броски
    DeviceNotAvailableException

    перезагрузкаUntilOnline

    public void rebootUntilOnline ()

    Альтернатива reboot() , которая блокируется только до тех пор, пока устройство не будет подключено к сети, т.е. не станет видимым для adb.

    Броски
    DeviceNotAvailableException

    перезагрузкаUntilOnline

    public void rebootUntilOnline (String reason)

    Альтернатива reboot() , которая блокируется только до тех пор, пока устройство не будет подключено к сети, т.е. не станет видимым для adb.

    Параметры
    reason String : причина перезагрузки или null , если причина не указана.

    Броски
    DeviceNotAvailableException

    перезагрузкаПространство пользователя

    public void rebootUserspace ()

    Перезагружает только часть пользовательского пространства устройства.

    Блокируется до тех пор, пока устройство не станет доступным.

    ПРЕДУПРЕЖДЕНИЕ. Перезагрузка пользовательского пространства в настоящее время находится в активной разработке, используйте ее на свой страх и риск.

    Броски
    DeviceNotAvailableException

    перезагрузкаUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

    Альтернатива rebootUserspace() ()}, которая блокируется только до тех пор, пока устройство не окажется в сети, т. е. не станет видимым для adb.

    Броски
    DeviceNotAvailableException

    восстановить устройство

    public boolean recoverDevice ()

    Попытки восстановить связь с устройством.

    Возврат
    boolean True, если попытка восстановления прошла успешно, возвращает False, если восстановление было пропущено.

    Броски
    DeviceNotAvailableException если устройство больше не доступно

    регистрдевицеактионрекивер

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Регистрирует IDeviceActionReceiver для этого устройства.

    Все зарегистрированные IDeviceActionReceiver будут уведомлены перед началом действия устройства и после его завершения.

    Параметры
    deviceActionReceiver IDeviceActionReceiver : IDeviceActionReceiver , который будет зарегистрирован.

    перемонтироватьсистемеридонли

    public void remountSystemReadOnly ()

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

    Броски
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

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

    Броски
    DeviceNotAvailableException

    перемонтироватьVendorReadOnly

    public void remountVendorReadOnly ()

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

    Броски
    DeviceNotAvailableException

    перемонтироватьVendorWritable

    public void remountVendorWritable ()

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

    Броски
    DeviceNotAvailableException

    удалить администратора

    public boolean removeAdmin (String componentName, 
                    int userId)

    Удалите данного администратора устройства у данного пользователя и верните true , если операция прошла успешно, в противном случае false .

    Параметры
    componentName String : администратора устройства, который необходимо удалить.

    userId int : пользователя, у которого живет администратор устройства.

    Возврат
    boolean Истина, если операция успешна, и ложь в противном случае.

    Броски
    DeviceNotAvailableException

    удалить владельцев

    public void removeOwners ()

    Удалите всех существующих владельцев профилей устройств, приложив все усилия.

    Броски
    DeviceNotAvailableException

    удалить пользователя

    public boolean removeUser (int userId)

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

    Параметры
    userId int : пользователя, которого нужно удалить

    Возврат
    boolean true, если нам удалось удалить пользователя, в противном случае — false.

    Броски
    DeviceNotAvailableException

    сбросКонтентпровидерсетуп

    public void resetContentProviderSetup ()

    Сбросьте флаг настройки поставщика контента, чтобы активировать его снова.

    запуститьInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                    ITestLifeCycleReceiver... listeners)

    Удобный метод для выполнения ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) с одним или несколькими прослушивателями, переданными в качестве параметров.

    Параметры
    runner IRemoteAndroidTestRunner : IRemoteAndroidTestRunner , который запускает тесты.

    listeners ITestLifeCycleReceiver : прослушиватель результатов теста.

    Возврат
    boolean true , если тестовая команда завершена. false , если его не удалось завершить, но восстановление удалось

    Броски
    DeviceNotAvailableException

    запуститьInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Запускает инструментальные тесты и обеспечивает восстановление устройства.

    Если соединение с устройством потеряно до завершения тестового запуска и восстановление прошло успешно, все прослушиватели будут проинформированы о testRunFailed и будет возвращено значение «false». Тестовая команда не будет повторно выполняться. При необходимости вызывающим абонентам предоставляется возможность повторить попытку.

    Если соединение с устройством потеряно до завершения тестового запуска и восстановление не удалось, все прослушиватели будут проинформированы о testRunFailed и будет выдано исключение DeviceNotAvailableException.

    Параметры
    runner IRemoteAndroidTestRunner : IRemoteAndroidTestRunner , который запускает тесты.

    listeners : слушатели результатов теста

    Возврат
    boolean true , если тестовая команда завершена. false , если его не удалось завершить из-за исключения связи с устройством, но восстановление выполнено успешно

    Броски
    DeviceNotAvailableException

    запуститьInstrumentationTestsAsUser

    public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                     listeners)

    То же самое, что ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) тест для данного пользователя.

    Параметры
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    запуститьInstrumentationTestsAsUser

    public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                    ITestLifeCycleReceiver... listeners)

    То же, что ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) но запускает тест для данного пользователя.

    Параметры
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    Внедряет используемый IConfiguration .

    Параметры
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    Параметры
    avdInfo GceAvdInfo

    УстановитьДата

    public void setDate (Date date)

    Устанавливает дату на устройстве

    Примечание: для установки даты на устройстве требуется root

    Параметры
    date Date : укажите конкретную дату; будет использовать дату хоста, если null

    Броски
    DeviceNotAvailableException

    setDeviceOwner

    public boolean setDeviceOwner (String componentName, 
                    int userId)

    Установите компонент администратора устройства в качестве владельца устройства для данного пользователя.

    Параметры
    componentName String : администратор устройства будет владельцем устройства.

    userId int : пользователя, под которым живет владелец устройства.

    Возврат
    boolean Истина, если операция успешна, и ложь в противном случае.

    Броски
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    Обновите состояние устройства.

    Параметры
    deviceState TestDeviceState : TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    Для эмулятора установите SizeLimitedOutputStream для регистрации вывода

    Параметры
    output SizeLimitedOutputStream : для регистрации вывода

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

    Устанавливает Process , если это устройство является эмулятором.

    Параметры
    p Process

    установитьFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

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

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

    установитьFastbootPath

    public void setFastbootPath (String fastbootPath)

    Устанавливает путь к двоичному файлу fastboot, который следует использовать. По-прежнему требуется, чтобы isFastbootEnabled() имело значение true, чтобы функции быстрой загрузки были включены.

    Параметры
    fastbootPath String

    setIDevice

    public void setIDevice (IDevice newDevice)

    Обновите IDevice, связанный с этим ITestDevice.

    Новый IDevice должен ссылаться на то же физическое устройство, что и текущая ссылка. Этот метод будет вызван, если DDMS выделил новый IDevice.

    Параметры
    newDevice IDevice : IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

    Устанавливает время ожидания в мс перед началом захвата logcat для подключенного к сети устройства.

    Параметры
    delay int : задержка в мс

    УстановитьОпции

    public void setOptions (TestDeviceOptions options)

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

    Параметры
    options TestDeviceOptions

    setProperty

    public boolean setProperty (String propKey, 
                    String propValue)

    Устанавливает заданное значение свойства на устройстве. Требуется adb root, это правда.

    Параметры
    propKey String : ключ, который необходимо установить.

    propValue String : значение свойства, которое необходимо установить.

    Возврат
    boolean возвращает True , если команда setprop прошла успешно, в противном случае — False.

    Броски
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

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

    Параметры
    recovery IDeviceRecovery : IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

    Используется для управления тем, какой метод восстановления следует использовать при возникновении проблемы со связью устройства. Рекомендуется использовать этот метод только в случае необходимости (например, когда платформа не работает и т. д.).

    Параметры
    mode ITestDevice.RecoveryMode : должен ли быть включен режим «восстановление только онлайн» или нет.

    УстановитьНастройки

    public void setSetting (String namespace, 
                    String key, 
                    String value)

    См. setSetting(int, String, String, String) и выполняется для системного пользователя.

    Параметры
    namespace String

    key String

    value String

    Броски
    DeviceNotAvailableException

    УстановитьНастройки

    public void setSetting (int userId, 
                    String namespace, 
                    String key, 
                    String value)

    Добавьте значение параметра в пространство имен данного пользователя. Некоторые настройки будут доступны только после перезагрузки. пространство имен должно быть одним из: {"системный", "безопасный", "глобальный"}

    Параметры
    userId int

    namespace String

    key String

    value String

    Броски
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    Внедряет экземпляр ITestLogger

    Параметры
    testLogger ITestLogger

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

    Укажите, следует ли использовать Fastboot Erase или Fastboot Format для очистки раздела на устройстве.

    Параметры
    useFastbootErase boolean : true , если следует использовать стирание fastboot, или false если следует использовать формат fastboot.

    startLogcat

    public void startLogcat ()

    Начните захват вывода logcat с устройства в фоновом режиме.

    Не будет иметь никакого эффекта, если вывод logcat уже записывается. Данные можно позже получить с помощью getLogcat.

    Когда устройство больше не используется, необходимо вызвать stopLogcat() .

    startLogcat() и stopLogcat() обычно не требуют вызова в контексте вызова TF, поскольку платформа TF запускает и останавливает logcat.

    startUser

    public boolean startUser (int userId)

    Запускает данного пользователя в фоновом режиме, если он в данный момент остановлен. Если пользователь уже работает в фоновом режиме, этот метод является NOOP.

    Параметры
    userId int : пользователя, который запускается в фоновом режиме

    Возврат
    boolean true, если пользователь был успешно запущен в фоновом режиме.

    Броски
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId, 
                    boolean waitFlag)

    Запускает данного пользователя в фоновом режиме, если он в данный момент остановлен. Если пользователь уже работает в фоновом режиме, этот метод является NOOP. Можно указать дополнительный флаг для ожидания эффекта операции.

    Параметры
    userId int : пользователя, который запускается в фоновом режиме

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

    Возврат
    boolean true, если пользователь был успешно запущен в фоновом режиме.

    Броски
    DeviceNotAvailableException

    startVisibleBackgroundUser

    public boolean startVisibleBackgroundUser (int userId, 
                    int displayId, 
                    boolean waitFlag)

    Запускает данного пользователя в фоновом режиме, видимом на данном дисплее (т. е. позволяя пользователю запускать действия на этом дисплее).

    Примечание. Эта команда не проверяет, существует ли пользователь, доступен дисплей, device supports such feature и т. Д.

    Параметры
    userId int : пользователя начать в фоновом режиме

    displayId int : отображать, чтобы запустить пользователя видимым на

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

    Возврат
    boolean true , если пользователь был успешно начал заметить в фоновом режиме.

    Броски
    DeviceNotAvailableException

    остановитьEmulatorOutput

    public void stopEmulatorOutput ()

    Закройте и удалите вывод эмулятора.

    стопLogcat

    public void stopLogcat ()

    Прекратите захват вывода logcat с устройства и удалите текущие сохраненные данные logcat.

    Не будет иметь никакого эффекта, если вывод logcat не захватывается.

    стоп -инжир

    public boolean stopUser (int userId)

    Останавливает данного пользователя. Если пользователь уже остановлен, этот метод является полным. Не может остановить ток и пользователя системы.

    Параметры
    userId int : пользователя остановиться.

    Возврат
    boolean Правда, если пользователь был успешно остановлен.

    Броски
    DeviceNotAvailableException

    стоп -инжир

    public boolean stopUser (int userId, 
                    boolean waitFlag, 
                    boolean forceFlag)

    Остановите данного пользователя. Возможно предоставить дополнительные флаги, чтобы дождаться действия операции, и заставит заставать прекратить пользователя. Не может остановить ток и пользователя системы.

    Параметры
    userId int : пользователя остановиться.

    waitFlag boolean : заставит команду ждать, пока пользователь не остановится.

    forceFlag boolean : заставит остановить пользователя.

    Возврат
    boolean Правда, если пользователь был успешно остановлен.

    Броски
    DeviceNotAvailableException

    переключательToAdbTcp

    public String switchToAdbTcp ()

    Переключите устройство в режим adb-over-tcp.

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

    Броски
    DeviceNotAvailableException

    переключательToAdbUsb

    public boolean switchToAdbUsb ()

    Переключите устройство в режим adb через USB.

    Возврат
    boolean true , если переключение прошло успешно, в противном случае false .

    Броски
    DeviceNotAvailableException

    поменять пользователя

    public boolean switchUser (int userId)

    Переключитесь на другой иид пользователя с временем ожидания по умолчанию. switchUser(int, long) .

    Параметры
    userId int

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

    Броски
    DeviceNotAvailableException

    поменять пользователя

    public boolean switchUser (int userId, 
                    long timeout)

    Переключитесь на другой UserId с предоставленным тайм -аутом в качестве крайнего срока. Попытка отключить KeyGuard после успешного изменения пользователя.

    Параметры
    userId int

    timeout long : подождать, прежде чем вернуть False для выключения коммутатора.

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

    Броски
    DeviceNotAvailableException

    синхронизировать файлы

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Поэтапно синхронизирует содержимое локального каталога файлов с устройством.

    Решает, какие файлы отправлять, путем сравнения временных меток локальных файлов с их удаленными эквивалентами. На устройство будут перенесены только «более новые» или несуществующие файлы. Таким образом, накладные расходы должны быть относительно небольшими, если файл, установленный на устройстве, уже обновлен.

    Скрытые файлы (имена которых начинаются с «.») будут игнорироваться.

    Пример использования: syncFiles("/tmp/files", "/sdcard") создаст каталог /sdcard/files, если он еще не существует, и рекурсивно отправит содержимое /tmp/files в /sdcard/files.

    Параметры
    localFileDir File : локальный файловый каталог, содержащий файлы для рекурсивной отправки.

    deviceFilePath String : абсолютный корень пути к удаленному файлу. Все каталоги в этом пути к файлу должны быть доступны для чтения. т.е. нажатие на /data/local/tmp, когда adb не является root, завершится неудачно.

    Возврат
    boolean true , если файлы были успешно синхронизированы. false в противном случае.

    Броски
    DeviceNotAvailableException

    TakeBugReport

    public Bugreport takeBugreport ()

    Возьмите BugReport и возвращает его в объект Bugreport , чтобы справиться с ним. Вернуть ноль в случае выпуска. Файл, упомянутый в объекте Bugreport, должен быть очищен через Bugreport.close() .

    Возврат
    Bugreport

    uninstallPackage

    public String uninstallPackage (String packageName)

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

    Параметры
    packageName String : пакет Android с удалением

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

    Броски
    DeviceNotAvailableException

    uninstallPackageForuser

    public String uninstallPackageForUser (String packageName, 
                    int userId)

    Удалите пакет Android от устройства для данного пользователя.

    Параметры
    packageName String : пакет Android с удалением

    userId int : целочисленный идентификатор пользователя для удаления.

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

    Броски
    DeviceNotAvailableException

    разблокировать устройство

    public boolean unlockDevice ()

    Разблокирует устройство, если оно находится в зашифрованном состоянии.

    Этот метод может перезапустить платформу, но не вызовет postBootSetup() . Таким образом, устройство может быть не полностью готово к тестированию, когда этот метод вернется.

    Возврат
    boolean true в случае успеха или если устройство не зашифровано.

    Броски
    DeviceNotAvailableException

    размонтироватьDebugfs

    public void unmountDebugfs ()

    Отмонтируйте отладочные файлы.

    Броски
    DeviceNotAvailableException

    ждатьForBootComplete

    public boolean waitForBootComplete (long timeOut)

    Блокируется до тех пор, пока не будет установлен флаг завершения загрузки устройства.

    Параметры
    timeOut long : время в мсек для ожидания установки флага.

    Возврат
    boolean true, если флаг завершения загрузки устройства установлен в течение таймаута

    Броски
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

    Ожидает, пока устройство ответит и будет доступно для тестирования. Использует тайм-аут по умолчанию.

    Возврат
    boolean True, если устройство доступно, False, если восстановление отключено и недоступно.

    Броски
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

    Ожидает, пока устройство ответит и будет доступно для тестирования.

    Параметры
    waitTime long : время ожидания в мс.

    Возврат
    boolean True, если устройство доступно, False, если восстановление отключено и недоступно.

    Броски
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Ожидает, пока устройство ответит и станет доступным, не учитывая путь восстановления.

    Параметры
    waitTime long

    Возврат
    boolean True, если устройство доступно, False, если недоступно.

    Броски
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

    Блокируется до тех пор, пока устройство не станет видимым через fastboot. Используйте тайм-аут по умолчанию.

    Броски
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

    Блокирует нахождение устройства в состоянии «восстановление adb» (обратите внимание, что это отличается от IDeviceRecovery ).

    Параметры
    waitTime long : время ожидания в мс.

    Возврат
    boolean true , если устройство загружается в режим восстановления до истечения времени. false в противном случае

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

    Блокирует нахождение устройства в состоянии «adb Sideload».

    Параметры
    waitTime long : время ожидания в мс.

    Возврат
    boolean true , если устройство загружается в режим неопубликованной загрузки до истечения времени. false в противном случае

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

    Блоки для устройства недоступны т.е. отсутствуют в adb

    Параметры
    waitTime long : время ожидания в мс.

    Возврат
    boolean true , если устройство становится недоступным до истечения времени. false в противном случае

    ждатьForDeviceOnline

    public void waitForDeviceOnline ()

    Блокируется до тех пор, пока устройство не станет видимым через adb. Использует тайм-аут по умолчанию

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

    Броски
    DeviceNotAvailableException

    ждатьForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

    Блокируется до тех пор, пока устройство не станет видимым через adb.

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

    Параметры
    waitTime long : время ожидания в мс.

    Броски
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

    Ожидает, пока устройство отреагирует на базовую команду оболочки adb.

    Параметры
    waitTime long : время ожидания в мс.

    Возврат
    boolean true , если устройство начинает реагировать до истечения waitTime .

    Защищенные методы

    addextraconnectionbuilderargs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    Параметры
    builder DefaultConnection.ConnectionBuilder

    BUILDADBSHELLCOMMAND

    protected String[] buildAdbShellCommand (String command, 
                    boolean forceExitStatusDetection)

    Создает команду ОС для данного сеанса команды ADB Shell и ARGS

    Параметры
    command String

    forceExitStatusDetection boolean

    Возврат
    String[]

    checkapilevagainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    Параметры
    feature String

    strictMinLevel int

    CreatereBootDeviceAction

    protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Создайте RebootDeviceAction , который будет использоваться при выполнении действия перезагрузки.

    Параметры
    rebootMode NativeDevice.RebootMode : режим этой перезагрузки.

    reason String : для этой перезагрузки.

    Возврат
    NativeDevice.RebootDeviceAction Созданный RebootDeviceAction .

    CreateRunutil

    protected IRunUtil createRunUtil ()

    Возврат
    IRunUtil

    Doadbreboot

    protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Выполните перезагрузку ADB.

    Параметры
    rebootMode NativeDevice.RebootMode : режим этой перезагрузки.

    reason String : для этой перезагрузки.

    Броски
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    HearnureRuntImePermissionsUpported

    protected void ensureRuntimePermissionSupported ()

    вспомогательный метод, чтобы добавить исключение, если разрешение на время выполнения не поддерживается

    Броски
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getapilevelsafe

    protected int getApiLevelSafe ()

    Возврат
    int

    getLogger

    protected ITestLogger getLogger ()

    Возврат
    ITestLogger

    getrunutil

    protected IRunUtil getRunUtil ()

    Получите экземпляр RunUtil для использования.

    Возврат
    IRunUtil

    инициализоологичное соединение

    protected void initializeConnection (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    Параметры
    info IBuildInfo

    attributes MultiMap

    Броски
    DeviceNotAvailableException
    TargetSetupError

    InternalGetProperty

    protected String internalGetProperty (String propName, 
                    String fastbootVar, 
                    String description)

    По умолчанию принесите свойство устройства из кэша ddmlib и возвращаются к `adb shell getprop` или` fastboot getvar` в зависимости от того, находится ли устройство в Fastboot или нет.

    Параметры
    propName String : имя свойства устройства, возвращаемое `adb shell getProp`

    fastbootVar String : имя эквивалентной переменной Fastboot к запросу. Если null , запрос FastBoot не будет предпринят

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

    Возврат
    String Строка, возможно, null или пустая, содержащая значение данного свойства

    Броски
    DeviceNotAvailableException

    IsinrebootCallback

    protected boolean isInRebootCallback ()

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

    Возврат
    boolean

    ISNEWER

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    Вернуть true если локальный файл новее удаленный файл. IFileEntry точна до минуты, в случае равных времен файл будет считаться новым.

    Параметры
    localFile File

    entry IFileEntry

    Возврат
    boolean

    notifyRebooteded

    protected void notifyRebootEnded ()

    Уведомляет все IDeviceActionReceiver о событии End Revity End.

    Броски
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    NotifyRebootStarted

    protected void notifyRebootStarted ()

    Уведомляет все IDeviceActionReceiver о событии Start Reboot.

    Броски
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Выполнение девичника

    protected boolean performDeviceAction (String actionDescription, 
                    NativeDevice.DeviceAction action, 
                    int retryAttempts)

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

    Параметры
    actionDescription String : краткое описание действия, которое нужно выполнить. Используется только в целях ведения журнала.

    action NativeDevice.DeviceAction : действие, которое нужно выполнить

    retryAttempts int : попытки повторной попытки принять действие, если оно не удается, но восстановление добивается успеха

    Возврат
    boolean true , если действие было успешно выполнено

    Броски
    DeviceNotAvailableException Если попытка восстановления не удается или максимально выполняет попытки без успеха

    PostAdbreboot

    protected void postAdbReboot ()

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

    Броски
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    prefostbootsetup

    protected void prePostBootSetup ()

    Позволяет каждому типу устройства (AndroidNativeVice, TestDevice) переопределить этот метод для конкретной настройки загрузки.

    Броски
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Pullfileinternal

    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    Параметры
    remoteFilePath String

    localFile File

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    SetClock

    protected void setClock (Clock clock)

    Установите экземпляр часов на использование.

    Параметры
    clock Clock

    SetMiCrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Оценка TestDevice как микродоид и устанавливает свой CID.

    Параметры
    process Process : процесс микродоидного виртуальной машины.

    SetteStEviceOptions

    protected void setTestDeviceOptions ( deviceOptions)

    Параметры
    deviceOptions

    SimpleBastBootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                     envVarMap, 
                    String[] fullCmd)

    Выполняет простую команду Fastboot с переменными среды и сообщит о статусе команды.

    Параметры
    timeout long

    envVarMap

    fullCmd String

    Возврат
    CommandResult

    SimpleBastBootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                    String[] fullCmd)

    Выполняет простую команду Fastboot и сообщите о статусе команды.

    Параметры
    timeout long

    fullCmd String

    Возврат
    CommandResult

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

    Подождите, чтобы увидеть, что устройство не будет доступно (прекрати сообщать о ADB).

    Параметры
    operationDesc String : имя операции, которая ждет недоступной.

    time long : время ждать недоступного.

    Возврат
    boolean Правда, если устройство действительно стало недоступным.