NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver , IManagedTestDevice , 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 ()

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

boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

boolean checkConnectivity ()

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

boolean clearErrorDialogs ()

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

void clearLastConnectedWifiNetwork ()

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

void clearLogcat ()

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

boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

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

boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

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

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

DeviceInspectionResult debugDeviceNotAvailable ()

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

void deleteFile (String deviceFilePath, int userId)

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

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

Отключает adb root.

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)

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

String executeAdbCommand (String... cmdArgs)

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

CommandResult executeFastbootCommand (String... cmdArgs)

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

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

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

CommandResult executeLongFastbootCommand (String... cmdArgs)

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

CommandResult executeLongFastbootCommand ( envVarMap, String... cmdArgs)

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

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 , правильно заполненного выводом статуса команды, stdout и stderr.

CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)

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

CommandResult executeShellV2Command (String cmd, File pipeAsInput)

Вспомогательный метод, который выполняет команду оболочки adb и возвращает результаты в виде CommandResult , правильно заполненного выводом статуса команды, stdout и 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-id, связанный с userId, или null, если не найден.

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

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

ContentProviderHandler getContentProvider (int userId)

Возвращает ContentProviderHandler или null, если недоступно.

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

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

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-адрес устройства или null, если запрос с устройства не удался.

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

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

InputStreamSource getScreenshot (String format)

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

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-карты или null, если он недоступен или устройство недоступно.

String getSimState ()

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

getTombstones ()

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

long getTotalMemory ()

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

String getTrackingSerial ()

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

getUninstallablePackageNames ()

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

boolean getUseFastbootErase ()

Узнайте, следует ли использовать fastboot erasure или 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)

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

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

Инициализируйте подключение к устройству.

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)

Запишите сообщение в журнал событий устройства.

void mountDebugfs ()

Смонтировать debugfs.

void nonBlockingReboot ()

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

void postAdbRootAction ()

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

void postAdbUnrootAction ()

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

void postBootSetup ()

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

void postInvocationTearDown (Throwable exception)

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

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

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

boolean pullDir (String deviceFilePath, File localDir, int userId)

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

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)

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

boolean pushDir (File localFileDir, String deviceFilePath)

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

boolean pushDir (File localFileDir, String deviceFilePath, int userId)

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

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

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

boolean pushFile (File localFile, String remoteFilePath)

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

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

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

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 sideload (обратите внимание, что это специальный режим при восстановлении)

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

void rebootIntoSideload (boolean autoReboot)

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

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

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)

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

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)) но запускает тест для данного пользователя.

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 setTrackingSerial (String trackingSerial)

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

void setUseFastbootErase (boolean useFastbootErase)

Укажите, следует ли использовать fastboot erasure или fastboot format для очистки раздела на устройстве.

void startLogcat ()

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

boolean startTradeInModeTesting (int timeoutMs)

Включить тестовый режим обмена.

boolean startUser (int userId)

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

boolean startUser (int userId, boolean waitFlag)

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

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

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

void stopEmulatorOutput ()

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

void stopLogcat ()

Остановите сбор выходных данных Logcat с устройства и удалите текущие сохраненные данные Logcat.

void stopTradeInModeTesting ()

Прекратить тестирование в режиме обмена.

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

Размонтируйте debugfs.

boolean waitForBootComplete (long timeOut)

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

boolean waitForDeviceAvailable ()

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

boolean waitForDeviceAvailable (long waitTime)

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

boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

void waitForDeviceBootloader ()

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

boolean waitForDeviceInRecovery (long waitTime)

Блокирует переход устройства в состояние «adb recovery» (обратите внимание, что это отличается от 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 для использования.

String internalGetProperty (String propName, String fastbootVar, String description)

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

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)

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

void setMicrodroidProcess (Process process)

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

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

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

CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)

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

boolean waitForDeviceNotAvailable (String operationDesc, long time)

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

Константы

НЕВЕРНЫЙ_ИД_ПОЛЬЗОВАТЕЛЯ

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_КАРТА

protected static final String SD_CARD

ХРАНЕНИЕ_ЭМУЛЯЦИЯ

protected static final String STORAGE_EMULATED

mОпции

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Публичные конструкторы

NativeDevice

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

Создает TestDevice .

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

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

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

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

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

Возвраты
boolean

Броски
DeviceNotAvailableException

проверкаApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

Броски
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity ()

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

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

Броски
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

Броски
DeviceNotAvailableException

очиститьПоследнееПодключениеWi-FiСеть

public void clearLastConnectedWifiNetwork ()

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

clearLogcat

public void clearLogcat ()

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

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

connectToWifiСеть

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

connectToWifiСеть

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

connectToWifiСеть

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

connectToWifiСеть

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

Подключиться к сети Wi-Fi, если необходимо

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

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

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

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

Броски
DeviceNotAvailableException

Подключиться к сети Wi-Fi, если необходимо

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

создатьUserNoThrow

public int createUserNoThrow (String name)

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

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

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

Броски
DeviceNotAvailableException

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

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

Возвраты
DeviceInspectionResult

удалитьФайл

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

userId int : идентификатор пользователя, которого нужно удалить

Броски
DeviceNotAvailableException

удалитьФайл

public void deleteFile (String deviceFilePath)

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

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

Броски
DeviceNotAvailableException

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

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

Броски
DeviceNotAvailableException

deviceSoftRestartedSince

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 root может привести к отключению устройства от adb. Этот метод будет блокироваться до тех пор, пока устройство не станет доступно.

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

Броски
DeviceNotAvailableException

отключитьKeyguard

public void disableKeyguard ()

Попытки отключить блокировку клавиатуры.

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

Броски
DeviceNotAvailableException

отключитьNetworkMonitor

public boolean disableNetworkMonitor ()

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

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

Броски
DeviceNotAvailableException

отключитьFromWiFi

public boolean disconnectFromWifi ()

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

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

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

Броски
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

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

Броски
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

Броски
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

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

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

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

Броски
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 stdout от команды. null если команда не была выполнена.

Броски
DeviceNotAvailableException

выполнитьAdbCommand

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

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

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

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

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

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

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

Броски
DeviceNotAvailableException

выполнитьAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

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

Возвраты
String stdout от команды. null если команда не удалось выполнить.

Броски
DeviceNotAvailableException

ExecutefastBootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

Ожидается, что устройство уже находится в режиме Fastboot.

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

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

Броски
DeviceNotAvailableException

ExecutefastBootCommand

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

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

Ожидается, что устройство уже находится в режиме Fastboot.

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

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

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

Броски
DeviceNotAvailableException

executongfastbootcommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

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

Броски
DeviceNotAvailableException

executongfastbootcommand

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

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

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

Параметры
envVarMap : Системная среда переменных, с которыми работает команда FastBoot

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

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

Броски
DeviceNotAvailableException

executeShellCommand

public String executeShellCommand (String command)

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

Параметры
command String : команда ADB Shell для запуска

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

Броски
DeviceNotAvailableException

executeShellCommand

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

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

Параметры
command String : команда ADB Shell для запуска

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

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

timeUnit TimeUnit : единица для maxTimeToOutputShellResponse

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

Броски
DeviceNotAvailableException

executeShellCommand

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

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

Параметры
command String : команда ADB Shell для запуска

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

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

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

timeUnit TimeUnit : единица для maxTimeToOutputShellResponse

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

Броски
DeviceNotAvailableException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

Параметры
command String : команда ADB Shell для запуска

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

Броски
DeviceNotAvailableException

executeShellv2command

public CommandResult executeShellV2Command (String cmd)

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

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

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

Броски
DeviceNotAvailableException

executeShellv2command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

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

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

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

Броски
DeviceNotAvailableException

executeShellv2command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Вспомогательный метод, который выполняет команду ADB Shell и возвращает результаты в качестве CommandResult заполненного заполненного выводом состояния команды, Stdout и Stderr.

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

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

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

Броски
DeviceNotAvailableException

executeShellv2command

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

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

Параметры
cmd String : команда ADB Shell для запуска

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

timeUnit TimeUnit : единица для maxTimeToOutputShellResponse

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

Возвраты
CommandResult

Броски
DeviceNotAvailableException

executeShellv2command

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

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

Параметры
cmd String : команда ADB Shell для запуска

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

timeUnit TimeUnit : единица для maxTimeToOutputShellResponse

Возвраты
CommandResult

Броски
DeviceNotAvailableException

executeShellv2command

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

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

Параметры
cmd String : команда ADB Shell для запуска

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

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

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

timeUnit TimeUnit : единица для maxTimeToOutputShellResponse

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

Возвраты
CommandResult

Броски
DeviceNotAvailableException

executeShellv2command

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

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

Параметры
cmd String : команда ADB Shell для запуска

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

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

pipeToError OutputStream : ERROR(/OutputStream) , где будет перенаправлена ​​ошибка STD или нулевой.

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

timeUnit TimeUnit : единица для maxTimeToOutputShellResponse

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

Возвраты
CommandResult

Броски
DeviceNotAvailableException

Fastbootwipepartition

public CommandResult fastbootWipePartition (String partition)

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

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

Ожидается, что устройство уже находится в режиме Fastboot.

Параметры
partition String : раздел, чтобы стереть

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

Броски
DeviceNotAvailableException

GetActiveApexes

public  getActiveApexes ()

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

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

Броски
DeviceNotAvailableException

GetallSettings

public  getAllSettings (String namespace)

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

Параметры
namespace String : должен быть один из {"Система", "Secure", "Global"}

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

Броски
DeviceNotAvailableException

getallocationstate

public DeviceAllocationState getAllocationState ()

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

Возвраты
DeviceAllocationState

GetAndroidid

public String getAndroidId (int userId)

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

Параметры
userId int

Возвраты
String

Броски
DeviceNotAvailableException

GetAndroidids

public  getAndroidIds ()

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

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

Броски
DeviceNotAvailableException

getapilevel

public int getApiLevel ()

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

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

Броски
DeviceNotAvailableException

getAppCpackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

Параметры
packageName String

Возвраты
PackageInfo PackageInfo или null , если информация не может быть извлечена

Броски
DeviceNotAvailableException

getapppackageinfos

public  getAppPackageInfos ()

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

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

Броски
DeviceNotAvailableException

GetBaseBandversion

public String getBasebandVersion ()

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

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

Броски
DeviceNotAvailableException

getbattery

public Integer getBattery ()

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

Возвраты
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 Time in Second As Epoch) и разум загрузки

Броски
DeviceNotAvailableException

GetBoothistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Helper Method собирает карту истории загрузки с временем загрузки и разумом загрузки с момента указанного эпохи с устройства и указанного временного блока. Текущее устройство Upcepochtime в миллисекунде может быть получено методом getDeviceDate() .

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

timeUnit TimeUnit : Time Unit TimeUnit .

Возвраты
Карта времени загрузки (UTC Time in Second As Epoch) и разум загрузки

Броски
DeviceNotAvailableException

GetBootloaderversion

public String getBootloaderVersion ()

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

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

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

Броски
DeviceNotAvailableException

GetBugReport

public InputStreamSource getBugreport ()

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

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

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

getbugreportz

public InputStreamSource getBugreportz ()

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

Поддерживается только для «версии ADB»> 1.0.36

Возвраты
InputStreamSource InputStreamSource of zip -файла, содержащий BugReportz, возвращайте NULL в случае сбоя.

getbuildalias

public String getBuildAlias ()

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

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

Возвраты
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 Ключ подписания, если найден, но иначе.

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

GetContentProvider

public ContentProviderHandler getContentProvider (int userId)

Возвращает ContentProviderHandler или NULL, если нет.

Поставщик контента может быть использован повторно, если он был построен ранее с тем же userId .

Параметры
userId int : идентификатор пользователя для инициализации поставщика контента.

Возвраты
ContentProviderHandler

Броски
DeviceNotAvailableException

GetCurrentFoldAbleState

public DeviceFoldableState getCurrentFoldableState ()

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

Возвраты
DeviceFoldableState

Броски
DeviceNotAvailableException

GetCurrentUser

public int getCurrentUser ()

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

Возвраты
int

Броски
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

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

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

getDevedate

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

GetFastBootPath

public String getFastbootPath ()

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

Возвраты
String

GetFastBootProductType

public String getFastbootProductType ()

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

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

Возвраты
String Имя типа String или null если оно не может быть определена

Броски
DeviceNotAvailableException

GetFastBootProductVariant

public String getFastbootProductVariant ()

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

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

Возвраты
String Имя типа String или null если оно не может быть определена

Броски
DeviceNotAvailableException

GetFastBootSerialNumber

public String getFastbootSerialNumber ()

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

Возвраты
String

GetFastBootVariable

public String getFastbootVariable (String variableName)

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

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

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

Броски
DeviceNotAvailableException

GetFastBootVersion

public String getFastbootVersion ()

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

Возвраты
String

GetFileEntry

public IFileEntry getFileEntry (String path)

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

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

Возвраты
IFileEntry IFileEntry или null , если файл на данном path не может быть найден

Броски
DeviceNotAvailableException

GetFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Неофициальный помощник, чтобы получить FileEntry из неровного пути. FixMe: Refactor Система файлов, чтобы она была доступна из любого пути. (даже не корень).

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

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

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

GetFoldablestates

public  getFoldableStates ()

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

Возвраты

Броски
DeviceNotAvailableException

getidevice

public IDevice getIDevice ()

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

Новый 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

getipaddress

public String getIpAddress ()

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

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

Броски
DeviceNotAvailableException

GetKeyGuardState

public KeyguardControllerState getKeyguardState ()

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

Возвраты
KeyguardControllerState KeyguardControllerState , содержащий снимок состояния KeyGuard, и возвращает NULL, если запрос KeyGuard не поддерживается.

Броски
DeviceNotAvailableException

getLastexpectedReboottimeMillis

public long getLastExpectedRebootTimeMillis ()

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

Возвраты
long

getlaunchapilevel

public int getLaunchApiLevel ()

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

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

Броски
DeviceNotAvailableException

getlogcat

public InputStreamSource getLogcat ()

Захватывает потоки снимков данных LogCat.

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

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

    Возвраты
    InputStreamSource

  • getlogcat

    public InputStreamSource getLogcat (int maxBytes)

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

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

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

    Возвраты
    InputStreamSource

    getlogcatdump

    public InputStreamSource getLogcatDump ()

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

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

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

    getLogcatsInce

    public InputStreamSource getLogcatSince (long date)

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

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

    Возвраты
    InputStreamSource

    getMacaddress

    public String getMacAddress ()

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

    Возвраты
    String

    getMainuserid

    public Integer getMainUserId ()

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

    Возвраты
    Integer ID пользователя основного пользователя, если он есть, и NULL, если нет основного пользователя.

    Броски
    DeviceNotAvailableException

    getMainLineModuleinfo

    public  getMainlineModuleInfo ()

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

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

    Броски
    DeviceNotAvailableException

    getMaxNumberOfrunningUserssUpported

    public int getMaxNumberOfRunningUsersSupported ()

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

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

    Броски
    DeviceNotAvailableException

    getMaxNumberOfusers поддерживает

    public int getMaxNumberOfUsersSupported ()

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

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

    Броски
    DeviceNotAvailableException

    getmicrodroidprocess

    public Process getMicrodroidProcess ()

    Возвраты
    Process Возвращает процесс Microdroid VM. Если TestDevice не является микродоидом, возвращает 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 соответствующую указанному пути MountPoint, или 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

    GetPrimaryUserid

    public Integer getPrimaryUserId ()

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

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

    Броски
    DeviceNotAvailableException

    GetProcessByName

    public ProcessInfo getProcessByName (String processName)

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

    Параметры
    processName String : строка имени Proces.

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

    Броски
    DeviceNotAvailableException

    GetProcessPid

    public String getProcessPid (String process)

    Возвращает пид Сервиса или NULL, если что -то пошло не так.

    Параметры
    process String : строка имени Proces.

    Возвраты
    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 (long displayId)

    Занимает скриншот с данного идентификатора дисплея. Формат PNG.

    TODO: расширить реализации выше, чтобы поддержать «формат» и «Rescale»

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

    Возвраты
    InputStreamSource InputStreamSource снимка экрана в формате или null , если скриншот не был успешным.

    Броски
    DeviceNotAvailableException

    GetScreenshot

    public InputStreamSource getScreenshot (String format)

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

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

    Возвраты
    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

    GetSerialNumber

    public String getSerialNumber ()

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

    Возвраты
    String String номер строки

    GetSetting

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

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

    Параметры
    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 -карты или NULL, если недоступно или если устройство недоступно.

    Возвраты
    String

    GetSimstate

    public String getSimState ()

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

    Возвраты
    String

    GetTombstones

    public  getTombstones ()

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

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

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

    Броски
    DeviceNotAvailableException

    GettotalMemory

    public long getTotalMemory ()

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

    Возвраты
    long

    GetTrackingSerial

    public String getTrackingSerial ()

    Для цели управления устройствами используйте последовательность для отслеживания устройства.

    Возвраты
    String

    GetUninStallablePackageNames

    public  getUninstallablePackageNames ()

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

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

    Броски
    DeviceNotAvailableException

    getusefastbooterase

    public boolean getUseFastbootErase ()

    Получите, использовать ли Fastboot Erase или Fastboot Format, чтобы вытирать раздел на устройстве.

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

    getuserflags

    public int getUserFlags (int userId)

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

    Параметры
    userId int

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

    Броски
    DeviceNotAvailableException

    getuserinfos

    public  getUserInfos ()

    Получает карту ssisiD для UserInfo на устройстве. Выбросит DeviceRuntimeException , если вывод с устройства не такой, как ожидалось.

    Возвраты
    Список объектов пользователя.

    Броски
    DeviceNotAvailableException

    getuserserialnumber

    public int getUserSerialNumber (int userId)

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

    Параметры
    userId int

    Возвраты
    int

    Броски
    DeviceNotAvailableException

    HandLeallocationEvent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

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

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

    Параметры
    event DeviceEvent

    Возвраты
    IManagedTestDevice.DeviceEventResponse

    HASFEATURE

    public boolean hasFeature (String feature)

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

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

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

    Броски
    DeviceNotAvailableException

    инициализоологичное соединение

    public void initializeConnection (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    Инициализируйте соединение с устройством. Это называется PreinvocationSetUp, но в редких случаях может потребоваться отдельно при создании соединения во время настройки устройства.

    Параметры
    info IBuildInfo

    attributes MultiMap

    Броски
    DeviceNotAvailableException
    TargetSetupError

    installPackage

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

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

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

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

    extraArgs String : необязательные дополнительные аргументы для прохождения. См. «ADB Shell PM -H» для доступных вариантов.

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

    Броски
    DeviceNotAvailableException

    installPackage

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

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

    ПРИМЕЧАНИЕ. Только использование вариантов, которые требуют явного управления предоставлением разрешения во время выполнения во время установки, должны вызвать эту функцию.

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

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

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

    extraArgs String : необязательные дополнительные аргументы для прохождения. См. «ADB Shell 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 : INTEGER ID пользователя для установки.

    extraArgs String : необязательные дополнительные аргументы для прохождения. См. «ADB Shell 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 : INTEGER ID пользователя для установки.

    extraArgs String : необязательные дополнительные аргументы для прохождения. См. «ADB Shell PM -H» для доступных вариантов.

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

    Броски
    DeviceNotAvailableException

    InvalidatePropertyCache

    public void invalidatePropertyCache ()

    Исадбрут

    public boolean isAdbRoot ()

    Возвраты
    boolean

    Броски
    DeviceNotAvailableException

    ISADBTCP

    public boolean isAdbTcp ()

    Возвраты
    boolean

    isappenumerationsupported

    public boolean isAppEnumerationSupported ()

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

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

    Броски
    DeviceNotAvailableException

    isbypasslowtargetsdkblocksupported

    public boolean isBypassLowTargetSdkBlockSupported ()

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

    Возвраты
    boolean Верно, если поддерживается обходной блок SDK с низким целевым

    Броски
    DeviceNotAvailableException

    isdebugfsmounted

    public boolean isDebugfsMounted ()

    Проверьте, устанавливаются ли отладки.

    Возвраты
    boolean true , если отладки установлены

    Броски
    DeviceNotAvailableException

    IsdeviceEncrypted

    public boolean isDeviceEncrypted ()

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

    Возвраты
    boolean true , если устройство зашифровано.

    Броски
    DeviceNotAvailableException

    Isdirectory

    public boolean isDirectory (String path)

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

    Параметры
    path String

    Возвраты
    boolean

    Броски
    DeviceNotAvailableException

    ISENABLEADBROOT

    public boolean isEnableAdbRoot ()

    Возвраты
    boolean true , если root ADB должен быть включен на устройстве

    ISENCRYPTIONSUPPODED

    public boolean isEncryptionSupported ()

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

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

    Броски
    DeviceNotAvailableException

    Испытательный

    public boolean isExecutable (String fullPath)

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

    Параметры
    fullPath String

    Возвраты
    boolean

    Броски
    DeviceNotAvailableException

    isfastbootenabled

    public boolean isFastbootEnabled ()

    Вернитесь, если Fastboot доступен для устройства.

    Возвраты
    boolean

    это безгона

    public boolean isHeadless ()

    Верните True, если устройство без головы (без экрана), false в противном случае.

    Возвраты
    boolean

    Броски
    DeviceNotAvailableException

    ishheadlesssystemusermode

    public boolean isHeadlessSystemUserMode ()

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

    Возвраты
    boolean

    Броски
    DeviceNotAvailableException

    IsmainuserpermanentAdmin

    public boolean isMainUserPermanentAdmin ()

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

    Возвраты
    boolean

    Броски
    DeviceNotAvailableException

    Ismultiusersupported

    public boolean isMultiUserSupported ()

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

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

    Броски
    DeviceNotAvailableException

    IspackageInstalled

    public boolean isPackageInstalled (String packageName, 
                    String userId)

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

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

    userId String : идентификатор пользователя, который мы проверяем, для пакета установлен. Если NULL, первичный пользователь Zero будет использоваться.

    Возвраты
    boolean Правда, если пакет сообщается, как установлен. Неверно иначе.

    Броски
    DeviceNotAvailableException

    IspackageInstalled

    public boolean isPackageInstalled (String packageName)

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

    Параметры
    packageName String

    Возвраты
    boolean Правда, если пакет сообщается, как установлен. Неверно иначе.

    Броски
    DeviceNotAvailableException

    isruntimepermissionsupported

    public boolean isRuntimePermissionSupported ()

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

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

    Броски
    DeviceNotAvailableException

    ISSTATEBOUTORORORFASTBOOTD

    public boolean isStateBootloaderOrFastbootd ()

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

    Возвраты
    boolean

    Isuserrunning

    public boolean isUserRunning (int userId)

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

    Параметры
    userId int

    Возвраты
    boolean Верно, если пользователь работает, ложь в любых других случаях.

    Броски
    DeviceNotAvailableException

    isusersecondator

    public boolean isUserSecondary (int userId)

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

    Параметры
    userId int

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

    Броски
    DeviceNotAvailableException

    ИСПОРТИВНО

    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

    Isvisiblebackgroundusers поддерживает

    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

    ListDisplayids

    public  listDisplayIds ()

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

    Возвраты
    Список дисплеев. По умолчанию всегда возвращает дисплей по умолчанию 0.

    Броски
    DeviceNotAvailableException

    ListDisplayidsforStartingVisibleBackgroundusers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

    Возвраты

    Броски
    DeviceNotAvailableException

    Listususers

    public  listUsers ()

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

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

    Броски
    DeviceNotAvailableException

    Loganrs

    public boolean logAnrs (ITestLogger logger)

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

    Параметры
    logger ITestLogger : ITestLogger для регистрации ANR.

    Возвраты
    boolean Правда, если журнал был успешным, в противном случае ложь.

    Броски
    DeviceNotAvailableException

    LogBugReport

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

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

    Параметры
    dataName String : Имя, под которым будет сообщено о Bugreport.

    listener ITestLogger : ITestLogger для регистрации Bugreport.

    Возвраты
    boolean Правда, если журнал был успешным, в противном случае ложь.

    логогад

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

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

    Параметры
    tag String : тег, при котором мы регистрируем наше сообщение в logCat.

    level Log.LogLevel : уровень отладки сообщения в logcat.

    format String : формат сообщения.

    args Object : ARG, которые должны быть заменены через string.format ().

    Mountdebugfs

    public void mountDebugfs ()

    Mount Debugfs.

    Броски
    DeviceNotAvailableException

    Неблокировка

    public void nonBlockingReboot ()

    Issues a command to reboot device and returns on command complete and when device is no longer visible to adb.

    Броски
    DeviceNotAvailableException

    postAdbRootAction

    public void postAdbRootAction ()

    Override if the device needs some specific actions to be taken after adb root and before the device is back online. Default implementation doesn't include any addition actions. adb root is not guaranteed to be enabled at this stage.

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

    postAdbUnrootAction

    public void postAdbUnrootAction ()

    Override if the device needs some specific actions to be taken after adb unroot and before the device is back online. Default implementation doesn't include any additional actions. adb root is not guaranteed to be disabled at this stage.

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

    postBootSetup

    public void postBootSetup ()

    Perform instructions to configure device for testing that after every boot.

    Should be called after device is fully booted/available

    In normal circumstances this method doesn't need to be called explicitly, as implementations should perform these steps automatically when performing a reboot.

    Where it may need to be called is when device reboots due to other events (eg when a fastboot update command has completed)

    Броски
    DeviceNotAvailableException

    postInvocationTearDown

    public void postInvocationTearDown (Throwable exception)

    Extra steps for device specific required clean up that will be executed after the invocation is done.

    Параметры
    exception Throwable : if any, the final exception raised by the invocation failure.

    preInvocationSetup

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

    Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.

    Параметры
    info IBuildInfo : The IBuildInfo of the device.

    attributes MultiMap : The attributes stored in the invocation context

    Броски
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir, 
                    int userId)

    Recursively pull directory contents from device.

    Параметры
    deviceFilePath String : the absolute file path of the remote source

    localDir File : the local directory to pull files into

    userId int : the user id to pull from

    Возвраты
    boolean true if file was pulled successfully. false otherwise.

    Броски
    DeviceNotAvailableException

    pullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Recursively pull directory contents from device.

    Параметры
    deviceFilePath String : the absolute file path of the remote source

    localDir File : the local directory to pull files into

    Возвраты
    boolean true if file was pulled successfully. false otherwise.

    Броски
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Retrieves a file off device.

    Параметры
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    Возвраты
    boolean true if file was retrieved successfully. false otherwise.

    Броски
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath, 
                    int userId)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    Параметры
    remoteFilePath String : the absolute path to file on device.

    userId int : The user id to pull from

    Возвраты
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Броски
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    Параметры
    remoteFilePath String : the absolute path to file on device.

    Возвраты
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Броски
    DeviceNotAvailableException

    pullFile

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

    Retrieves a file off device.

    Параметры
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    userId int : The user id to pull from

    Возвраты
    boolean true if file was retrieved successfully. false otherwise.

    Броски
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

    Retrieves a file off device, and returns the contents.

    Параметры
    remoteFilePath String : the absolute path to file on device.

    Возвраты
    String A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Броски
    DeviceNotAvailableException

    pullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

    A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

    Параметры
    remoteFilePath String : the path to file on device, relative to the device's external storage mountpoint

    Возвраты
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Броски
    DeviceNotAvailableException

    pushDir

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

    Recursively push directory contents to device while excluding some directories that are filtered.

    Параметры
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    excludedDirectories : Set of excluded directories names that shouldn't be pushed.

    Возвраты
    boolean true if file was pushed successfully. false otherwise.

    Броски
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

    Recursively push directory contents to device.

    Параметры
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    Возвраты
    boolean true if file was pushed successfully. false otherwise.

    Броски
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath, 
                    int userId)

    Recursively push directory contents to device.

    Параметры
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    userId int : the user id to push to

    Возвраты
    boolean true if file was pushed successfully. false otherwise.

    Броски
    DeviceNotAvailableException

    pushFile

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

    Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

    Параметры
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    evaluateContentProviderNeeded boolean : whether to check if we need the content provider

    Возвраты
    boolean true if file was pushed successfully. false otherwise.

    Броски
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    Push a file to device. By default using a content provider.

    Параметры
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    Возвраты
    boolean true if file was pushed successfully. false otherwise.

    Броски
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath, 
                    int userId)

    Push a file to device. By default using a content provider.

    Параметры
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    userId int : the userId to push to

    Возвраты
    boolean true if file was pushed successfully. false otherwise.

    Броски
    DeviceNotAvailableException

    pushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

    Push file created from a string to device

    Параметры
    contents String : the contents of the file to push

    remoteFilePath String : the remote destination absolute file path

    Возвраты
    boolean true if string was pushed successfully. false otherwise.

    Броски
    DeviceNotAvailableException

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

    public void reboot (String reason)

    Reboots the device into adb mode with given reason to be persisted across reboot.

    Blocks until device becomes available.

    Last reboot reason can be obtained by querying sys.boot.reason propety.

    Параметры
    reason String : a reason for this reboot, or null if no reason is specified.

    Броски
    DeviceNotAvailableException

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

    public void reboot ()

    Reboots the device into adb mode.

    Blocks until device becomes available.

    Броски
    DeviceNotAvailableException

    rebootIntoBootloader

    public void rebootIntoBootloader ()

    Reboots the device into bootloader mode.

    Blocks until device is in bootloader mode.

    Броски
    DeviceNotAvailableException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

    Reboots the device into fastbootd mode.

    Blocks until device is in fastbootd mode.

    Броски
    DeviceNotAvailableException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

    Reboots the device into adb recovery mode.

    Blocks until device enters recovery

    Броски
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload ()

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    Броски
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    Параметры
    autoReboot boolean : whether to automatically reboot the device after sideload

    Броски
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline ()

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    Броски
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline (String reason)

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    Параметры
    reason String : a reason for this reboot, or null if no reason is specified.

    Броски
    DeviceNotAvailableException

    rebootUserspace

    public void rebootUserspace ()

    Reboots only userspace part of device.

    Blocks until device becomes available.

    WARNING. Userspace reboot is currently under active development, use it on your own risk.

    Броски
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

    An alternate to rebootUserspace() ()} that only blocks until device is online ie visible to adb.

    Броски
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

    Attempts to recover device communication.

    Возвраты
    boolean True if recovery attempted and successful, returns False if recovery was skipped

    Броски
    DeviceNotAvailableException if device is no longer available

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Registers a IDeviceActionReceiver for this device.

    All registered IDeviceActionReceiver s will be notified before a device action starts and after the device action ends.

    Параметры
    deviceActionReceiver IDeviceActionReceiver : A IDeviceActionReceiver which will be registered.

    remountSystemReadOnly

    public void remountSystemReadOnly ()

    Make the system partition on the device read-only. May reboot the device.

    Броски
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

    Make the system partition on the device writable. May reboot the device.

    Броски
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

    Make the vendor partition on the device read-only. May reboot the device.

    Броски
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

    Make the vendor partition on the device writable. May reboot the device.

    Броски
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                    int userId)

    Remove given device admin in given user and return true if it is successful, false otherwise.

    Параметры
    componentName String : of device admin to be removed.

    userId int : of user that the device admin lives in.

    Возвраты
    boolean True if it is successful, false otherwise.

    Броски
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

    Remove all existing device profile owners with the best effort.

    Броски
    DeviceNotAvailableException

    removeUser

    public boolean removeUser (int userId)

    Remove a given user from the device.

    Параметры
    userId int : of the user to remove

    Возвраты
    boolean true if we were successful in removing the user, false otherwise.

    Броски
    DeviceNotAvailableException

    resetContentProviderSetup

    public void resetContentProviderSetup ()

    Reset the flag for content provider setup in order to trigger it again.

    runInstrumentationTests

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

    Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

    Параметры
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners ITestLifeCycleReceiver : the test result listener(s)

    Возвраты
    boolean true if test command completed. false if it failed to complete, but recovery succeeded

    Броски
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Runs instrumentation tests, and provides device recovery.

    If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.

    If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.

    Параметры
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners : the test result listeners

    Возвраты
    boolean true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded

    Броски
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

    Same as ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

    Параметры
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Возвраты
    boolean

    Броски
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

    Same as ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

    Параметры
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Возвраты
    boolean

    Броски
    DeviceNotAvailableException

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    Injects the IConfiguration in use.

    Параметры
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    Параметры
    avdInfo GceAvdInfo

    setDate

    public void setDate (Date date)

    Sets the date on device

    Note: setting date on device requires root

    Параметры
    date Date : specify a particular date; will use host date if null

    Броски
    DeviceNotAvailableException

    setDeviceOwner

    public boolean setDeviceOwner (String componentName, 
                    int userId)

    Set a device admin component as device owner in given user.

    Параметры
    componentName String : of device admin to be device owner.

    userId int : of the user that the device owner lives in.

    Возвраты
    boolean True if it is successful, false otherwise.

    Броски
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    Update the device's state.

    Параметры
    deviceState TestDeviceState : the TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    For emulator set SizeLimitedOutputStream to log output

    Параметры
    output SizeLimitedOutputStream : to log the output

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

    Sets the Process , when this device is an emulator.

    Параметры
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

    Set the fastboot option for the device. Should be set when device is first allocated.

    Параметры
    fastbootEnabled boolean : whether fastboot is available for the device or not

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    Sets the path to the fastboot binary that should be used. Still requires isFastbootEnabled() to be true, to have fastboot functions enabled.

    Параметры
    fastbootPath String

    setIDevice

    public void setIDevice (IDevice newDevice)

    Update the IDevice associated with this ITestDevice.

    The new IDevice must refer the same physical device as the current reference. This method will be called if DDMS has allocated a new IDevice

    Параметры
    newDevice IDevice : the IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

    Sets the time in ms to wait before starting logcat capture for a online device.

    Параметры
    delay int : the delay in ms

    setOptions

    public void setOptions (TestDeviceOptions options)

    Set the TestDeviceOptions for the device

    Параметры
    options TestDeviceOptions

    setProperty

    public boolean setProperty (String propKey, 
                    String propValue)

    Sets the given property value on the device. Requires adb root is true.

    Параметры
    propKey String : The key targeted to be set.

    propValue String : The property value to be set.

    Возвраты
    boolean returns True if the setprop command was successful, False otherwise.

    Броски
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

    Set the IDeviceRecovery to use for this device. Should be set when device is first allocated.

    Параметры
    recovery IDeviceRecovery : the IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Set the current recovery mode to use for the device.

    Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc

    Параметры
    mode ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not.

    setSetting

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

    See setSetting(int, String, String, String) and performed on system user.

    Параметры
    namespace String

    key String

    value String

    Броски
    DeviceNotAvailableException

    setSetting

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

    Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}

    Параметры
    userId int

    namespace String

    key String

    value String

    Броски
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    Injects the ITestLogger instance

    Параметры
    testLogger ITestLogger

    setTrackingSerial

    public void setTrackingSerial (String trackingSerial)

    For device management purpose track the serial we use for referencing the device.

    Параметры
    trackingSerial String

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

    Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

    Параметры
    useFastbootErase boolean : true if fastboot erase should be used or false if fastboot format should be used.

    startLogcat

    public void startLogcat ()

    Start capturing logcat output from device in the background.

    Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.

    When the device is no longer in use, stopLogcat() must be called.

    startLogcat() and stopLogcat() do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.

    startTradeInModeTesting

    public boolean startTradeInModeTesting (int timeoutMs)

    Enable testing trade-in mode. The device will be wiped and will reboot.

    Параметры
    timeoutMs int

    Возвраты
    boolean True if we were successful, false otherwise

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

    startUser

    public boolean startUser (int userId)

    Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.

    Параметры
    userId int : of the user to start in the background

    Возвраты
    boolean true if the user was successfully started in the background.

    Броски
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId, 
                    boolean waitFlag)

    Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.

    Параметры
    userId int : of the user to start in the background

    waitFlag boolean : will make the command wait until user is started and unlocked.

    Возвраты
    boolean true if the user was successfully started in the background.

    Броски
    DeviceNotAvailableException

    startVisibleBackgroundUser

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

    Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).

    NOTE: this command doesn't check if the user exists, display is available, device supports such feature , etc.

    Параметры
    userId int : of the user to start in the background

    displayId int : display to start user visible on

    waitFlag boolean : will make the command wait until user is started and unlocked.

    Возвраты
    boolean true if the user was successfully started visible in the background.

    Броски
    DeviceNotAvailableException

    stopEmulatorOutput

    public void stopEmulatorOutput ()

    Close and delete the emulator output.

    stopLogcat

    public void stopLogcat ()

    Stop capturing logcat output from device, and discard currently saved logcat data.

    Will have no effect if logcat output is not being captured.

    stopTradeInModeTesting

    public void stopTradeInModeTesting ()

    Stop trade-in mode testing.

    Броски
    DeviceNotAvailableException

    stopUser

    public boolean stopUser (int userId)

    Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.

    Параметры
    userId int : of the user to stop.

    Возвраты
    boolean true if the user was successfully stopped.

    Броски
    DeviceNotAvailableException

    stopUser

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

    Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.

    Параметры
    userId int : of the user to stop.

    waitFlag boolean : will make the command wait until user is stopped.

    forceFlag boolean : will force stop the user.

    Возвраты
    boolean true if the user was successfully stopped.

    Броски
    DeviceNotAvailableException

    switchToAdbTcp

    public String switchToAdbTcp ()

    Switch device to adb-over-tcp mode.

    Возвраты
    String the tcp serial number or null if device could not be switched

    Броски
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

    Switch device to adb over usb mode.

    Возвраты
    boolean true if switch was successful, false otherwise.

    Броски
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId)

    Switch to another userId with a default timeout. switchUser(int, long) .

    Параметры
    userId int

    Возвраты
    boolean True if the new userId matches the userId provider. False otherwise.

    Броски
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId, 
                    long timeout)

    Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.

    Параметры
    userId int

    timeout long : to wait before returning false for switch-user failed.

    Возвраты
    boolean True if the new userId matches the userId provider. False otherwise.

    Броски
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Incrementally syncs the contents of a local file directory to device.

    Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.

    Hidden files (with names starting with ".") will be ignored.

    Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.

    Параметры
    localFileDir File : the local file directory containing files to recursively push.

    deviceFilePath String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail

    Возвраты
    boolean true if files were synced successfully. false otherwise.

    Броски
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

    Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close() .

    Возвраты
    Bugreport

    uninstallPackage

    public String uninstallPackage (String packageName)

    Uninstall an Android package from device.

    Параметры
    packageName String : the Android package to uninstall

    Возвраты
    String a String with an error code, or null if success.

    Броски
    DeviceNotAvailableException

    uninstallPackageForUser

    public String uninstallPackageForUser (String packageName, 
                    int userId)

    Uninstall an Android package from device for a given user.

    Параметры
    packageName String : the Android package to uninstall

    userId int : the integer user id to uninstall for.

    Возвраты
    String a String with an error code, or null if success.

    Броски
    DeviceNotAvailableException

    unlockDevice

    public boolean unlockDevice ()

    Unlocks the device if the device is in an encrypted state.

    This method may restart the framework but will not call postBootSetup() . Therefore, the device might not be fully ready to be tested when this method returns.

    Возвраты
    boolean true if successful or if the device is unencrypted.

    Броски
    DeviceNotAvailableException

    unmountDebugfs

    public void unmountDebugfs ()

    Unmount debugfs.

    Броски
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

    Blocks until the device's boot complete flag is set.

    Параметры
    timeOut long : time in msecs to wait for the flag to be set

    Возвраты
    boolean true if device's boot complete flag is set within the timeout

    Броски
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

    Waits for the device to be responsive and available for testing. Uses default timeout.

    Возвраты
    boolean True if device is available, False if recovery is disabled and unavailable.

    Броски
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

    Waits for the device to be responsive and available for testing.

    Параметры
    waitTime long : the time in ms to wait

    Возвраты
    boolean True if device is available, False if recovery is disabled and unavailable.

    Броски
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Waits for the device to be responsive and available without considering recovery path.

    Параметры
    waitTime long

    Возвраты
    boolean True if device is available, False if unavailable.

    Броски
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

    Blocks until device is visible via fastboot. Use default timeout.

    Броски
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

    Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

    Параметры
    waitTime long : the time in ms to wait

    Возвраты
    boolean true if device boots into recovery before time expires. false otherwise

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

    Blocks for the device to be in the 'adb sideload' state

    Параметры
    waitTime long : the time in ms to wait

    Возвраты
    boolean true if device boots into sideload before time expires. false otherwise

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

    Blocks for the device to be not available ie missing from adb

    Параметры
    waitTime long : the time in ms to wait

    Возвраты
    boolean true if device becomes not available before time expires. false otherwise

    waitForDeviceOnline

    public void waitForDeviceOnline ()

    Blocks until device is visible via adb. Uses default timeout

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    Броски
    DeviceNotAvailableException

    waitForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

    Blocks until device is visible via adb.

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    Параметры
    waitTime long : the time in ms to wait

    Броски
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

    Waits for device to be responsive to a basic adb shell command.

    Параметры
    waitTime long : the time in ms to wait

    Возвраты
    boolean true if device becomes responsive before waitTime elapses.

    Protected methods

    addExtraConnectionBuilderArgs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    Параметры
    builder DefaultConnection.ConnectionBuilder

    buildAdbShellCommand

    protected String[] buildAdbShellCommand (String command, 
                    boolean forceExitStatusDetection)

    Builds the OS command for the given adb shell command session and args

    Параметры
    command String

    forceExitStatusDetection boolean

    Возвраты
    String[]

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    Параметры
    feature String

    strictMinLevel int

    createRebootDeviceAction

    protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Create a RebootDeviceAction to be used when performing a reboot action.

    Параметры
    rebootMode NativeDevice.RebootMode : a mode of this reboot.

    reason String : for this reboot.

    Возвраты
    NativeDevice.RebootDeviceAction the created RebootDeviceAction .

    createRunUtil

    protected IRunUtil createRunUtil ()

    Возвраты
    IRunUtil

    doAdbReboot

    protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Perform a adb reboot.

    Параметры
    rebootMode NativeDevice.RebootMode : a mode of this reboot.

    reason String : for this reboot.

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

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

    helper method to throw exception if runtime permission isn't supported

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

    getApiLevelSafe

    protected int getApiLevelSafe ()

    Возвраты
    int

    getLogger

    protected ITestLogger getLogger ()

    Возвраты
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

    Get the RunUtil instance to use.

    Возвраты
    IRunUtil

    internalGetProperty

    protected String internalGetProperty (String propName, 
                    String fastbootVar, 
                    String description)

    Fetch a device property, from the ddmlib cache by default, and falling back to either `adb shell getprop` or `fastboot getvar` depending on whether the device is in Fastboot or not.

    Параметры
    propName String : The name of the device property as returned by `adb shell getprop`

    fastbootVar String : The name of the equivalent fastboot variable to query. if null , fastboot query will not be attempted

    description String : A simple description of the variable. First letter should be capitalized.

    Возвраты
    String A string, possibly null or empty, containing the value of the given property

    Броски
    DeviceNotAvailableException

    isInRebootCallback

    protected boolean isInRebootCallback ()

    Returns whether reboot callbacks is currently being executed or not. All public api's for reboot should be disabled if true.

    Возвраты
    boolean

    isNewer

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    Return true if local file is newer than remote file. IFileEntry being accurate to the minute, in case of equal times, the file will be considered newer.

    Параметры
    localFile File

    entry IFileEntry

    Возвраты
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

    Notifies all IDeviceActionReceiver about reboot end event.

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

    notifyRebootStarted

    protected void notifyRebootStarted ()

    Notifies all IDeviceActionReceiver about reboot start event.

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

    performDeviceAction

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

    Performs an action on this device. Attempts to recover device and optionally retry command if action fails.

    Параметры
    actionDescription String : a short description of action to be performed. Used for logging purposes only.

    action NativeDevice.DeviceAction : the action to be performed

    retryAttempts int : the retry attempts to make for action if it fails but recovery succeeds

    Возвраты
    boolean true if action was performed successfully

    Броски
    DeviceNotAvailableException if recovery attempt fails or max attempts done without success

    postAdbReboot

    protected void postAdbReboot ()

    Possible extra actions that can be taken after a reboot.

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

    prePostBootSetup

    protected void prePostBootSetup ()

    Allows each device type (AndroidNativeDevice, TestDevice) to override this method for specific post boot setup.

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

    Set the Clock instance to use.

    Параметры
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Marks the TestDevice as microdroid and sets its CID.

    Параметры
    process Process : Process of the Microdroid VM.

    setTestDeviceOptions

    protected void setTestDeviceOptions ( deviceOptions)

    Параметры
    deviceOptions

    simpleFastbootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                     envVarMap, 
                    String[] fullCmd)

    Executes a simple fastboot command with environment variables and report the status of the command.

    Параметры
    timeout long

    envVarMap

    fullCmd String

    Возвраты
    CommandResult

    simpleFastbootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                    String[] fullCmd)

    Executes a simple fastboot command and report the status of the command.

    Параметры
    timeout long

    fullCmd String

    Возвраты
    CommandResult

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

    Wait to see the device going unavailable (stop reporting to adb).

    Параметры
    operationDesc String : The name of the operation that is waiting for unavailable.

    time long : The time to wait for unavailable to occur.

    Возвраты
    boolean True if device did become unavailable.