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

public class NativeDevice
extends Object implements IManagedTestDevice , IConfigurationReceiver , ITestLoggerReceiver

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


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

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

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

class NativeDevice.AdbAction

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

class NativeDevice.AdbShellAction

class NativeDevice.RebootDeviceAction

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

Константы

int INVALID_USER_ID

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

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

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

Поля

public static final String DEBUGFS_PATH

protected static final String SD_CARD

protected static final String STORAGE_EMULATED

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

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

NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Создает TestDevice .

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

void batchPrefetchStartupBuildProps ()

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

boolean canSwitchToHeadlessSystemUser ()

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

boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

boolean checkConnectivity ()

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

boolean clearErrorDialogs ()

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

void clearLastConnectedWifiNetwork ()

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

void clearLogcat ()

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

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

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

boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

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

boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

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

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

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

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

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

boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

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

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

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

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

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

int createUser (String name)

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

int createUserNoThrow (String name)

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

void deleteFile (String deviceFilePath, 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 ()

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

void disableKeyguard ()

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

boolean disableNetworkMonitor ()

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

boolean disconnectFromWifi ()

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

boolean doesFileExist (String deviceFilePath, int userId)

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

boolean doesFileExist (String deviceFilePath)

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

File dumpHeap (String process, String devicePath)

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

boolean enableAdbRoot ()

Включает adb root.

boolean enableNetworkMonitor ()

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

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

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

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

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

String executeAdbCommand (String... cmdArgs)

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

CommandResult executeFastbootCommand (String... cmdArgs)

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

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

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

CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

String executeShellCommand (String command)

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

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

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

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

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

void executeShellCommand (String command, IShellOutputReceiver receiver)

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

CommandResult executeShellV2Command (String cmd)

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

CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)

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

CommandResult executeShellV2Command (String cmd, File pipeAsInput)

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

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

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

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

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

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

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

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

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

CommandResult fastbootWipePartition (String partition)

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

getActiveApexes ()

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

getAllSettings (String namespace)

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

DeviceAllocationState getAllocationState ()

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

String getAndroidId (int userId)

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

getAndroidIds ()

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

int getApiLevel ()

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

PackageInfo getAppPackageInfo (String packageName)

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

getAppPackageInfos ()

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

String getBasebandVersion ()

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

Integer getBattery ()

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

boolean getBooleanProperty (String name, boolean defaultValue)

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

getBootHistory ()

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

getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)

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

String getBootloaderVersion ()

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

InputStreamSource getBugreport ()

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

InputStreamSource getBugreportz ()

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

String getBuildAlias ()

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

String getBuildFlavor ()

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

String getBuildId ()

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

String getBuildSigningKeys ()

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

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

DeviceDescriptor getCachedDeviceDescriptor ()

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

DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

String[] getChildren (String path)

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

AbstractConnection getConnection ()

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

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

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

getInstalledPackageNames ()

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

long getIntProperty (String name, long defaultValue)

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

String getIpAddress ()

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

KeyguardControllerState getKeyguardState ()

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

long getLastExpectedRebootTimeMillis ()

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

int getLaunchApiLevel ()

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

InputStreamSource getLogcat ()

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

InputStreamSource getLogcat (int maxBytes)

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

InputStreamSource getLogcatDump ()

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

InputStreamSource getLogcatSince (long date)

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

String getMacAddress ()

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

Integer getMainUserId ()

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

getMainlineModuleInfo ()

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

int getMaxNumberOfRunningUsersSupported ()

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

int getMaxNumberOfUsersSupported ()

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

Process getMicrodroidProcess ()
IDeviceStateMonitor getMonitor ()

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

String getMountPoint (String mountName)

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

ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

getMountPointInfo ()

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

TestDeviceOptions getOptions ()

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

long getPartitionFreeSpace (String partition)

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

Integer getPrimaryUserId ()

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

ProcessInfo getProcessByName (String processName)

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

String getProcessPid (String process)

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

String getProductType ()

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

String getProductVariant ()

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

String getProperty (String name)

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

ITestDevice.RecoveryMode getRecoveryMode ()

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

InputStreamSource getScreenshot (String format)

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

InputStreamSource getScreenshot (long displayId)

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

InputStreamSource getScreenshot (String format, boolean rescale)

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

InputStreamSource getScreenshot ()

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

String getSerialNumber ()

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

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

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

String getSetting (String namespace, String key)

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

String getSimOperator ()

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

String getSimState ()

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

getTombstones ()

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

long getTotalMemory ()

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

getUninstallablePackageNames ()

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

boolean getUseFastbootErase ()

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

int getUserFlags (int userId)

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

getUserInfos ()

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

int getUserSerialNumber (int userId)

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

IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

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

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

boolean hasFeature (String feature)

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

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

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

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

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

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

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

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

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

void invalidatePropertyCache ()
boolean isAdbRoot ()

boolean isAdbTcp ()
boolean isAppEnumerationSupported ()

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

boolean isBypassLowTargetSdkBlockSupported ()

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

boolean isDebugfsMounted ()

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

boolean isDeviceEncrypted ()

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

boolean isDirectory (String path)

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

boolean isEnableAdbRoot ()
boolean isEncryptionSupported ()

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

boolean isExecutable (String fullPath)

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

boolean isFastbootEnabled ()

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

boolean isHeadless ()

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

boolean isHeadlessSystemUserMode ()

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

boolean isMainUserPermanentAdmin ()

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

boolean isMultiUserSupported ()

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

boolean isPackageInstalled (String packageName, String userId)

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

boolean isPackageInstalled (String packageName)

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

boolean isRuntimePermissionSupported ()

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

boolean isStateBootloaderOrFastbootd ()

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

boolean isUserRunning (int userId)

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

boolean isUserSecondary (int userId)

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

boolean isUserVisible (int userId)

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

boolean isUserVisibleOnDisplay (int userId, int displayId)

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

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

boolean isVisibleBackgroundUsersSupported ()

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

boolean isWifiEnabled ()

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

listDisplayIds ()

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

listDisplayIdsForStartingVisibleBackgroundUsers ()

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

listUsers ()

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

boolean logAnrs ( ITestLogger logger)

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

boolean logBugreport (String dataName, ITestLogger listener)

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

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

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

void mountDebugfs ()

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

void nonBlockingReboot ()

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

void postAdbRootAction ()

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

void postAdbUnrootAction ()

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

void postBootSetup ()

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

void postInvocationTearDown (Throwable exception)

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

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

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

boolean pullDir (String deviceFilePath, File localDir, 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) 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 (обратите внимание, что это специальный режим в режиме восстановления)

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

void rebootIntoSideload (boolean autoReboot)

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

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

void rebootUntilOnline ()

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

void rebootUntilOnline (String reason)

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

void rebootUserspace ()

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

void rebootUserspaceUntilOnline ()

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

boolean recoverDevice ()

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

void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

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

void remountSystemReadOnly ()

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

void remountSystemWritable ()

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

void remountVendorReadOnly ()

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

void remountVendorWritable ()

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

boolean removeAdmin (String componentName, int userId)

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

void removeOwners ()

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

boolean removeUser (int userId)

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

void resetContentProviderSetup ()

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

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

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

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

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

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

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

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

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

void setConfiguration ( IConfiguration configuration)

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

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

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

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

boolean setDeviceOwner (String componentName, int userId)

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

void setDeviceState ( TestDeviceState deviceState)

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

void setEmulatorOutputStream ( SizeLimitedOutputStream output)

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

void setEmulatorProcess (Process p)

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

void setFastbootEnabled (boolean fastbootEnabled)

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

void setFastbootPath (String fastbootPath)

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

void setIDevice (IDevice newDevice)

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

void setLogStartDelay (int delay)

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

void setOptions ( TestDeviceOptions options)

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

boolean setProperty (String propKey, String propValue)

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

void setRecovery ( IDeviceRecovery recovery)

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

void setRecoveryMode ( ITestDevice.RecoveryMode mode)

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

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

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

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

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

void setTestLogger ( ITestLogger testLogger)

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

void setUseFastbootErase (boolean useFastbootErase)

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

void startLogcat ()

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

boolean startUser (int userId)

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

boolean startUser (int userId, boolean waitFlag)

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

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

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

void stopEmulatorOutput ()

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

void stopLogcat ()

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

boolean stopUser (int userId)

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

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

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

String switchToAdbTcp ()

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

boolean switchToAdbUsb ()

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

boolean switchUser (int userId)

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

boolean switchUser (int userId, long timeout)

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

boolean syncFiles (File localFileDir, String deviceFilePath)

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

Bugreport takeBugreport ()

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

String uninstallPackage (String packageName)

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

String uninstallPackageForUser (String packageName, int userId)

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

boolean unlockDevice ()

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

void unmountDebugfs ()

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

boolean waitForBootComplete (long timeOut)

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

boolean waitForDeviceAvailable ()

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

boolean waitForDeviceAvailable (long waitTime)

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

boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

void waitForDeviceBootloader ()

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

boolean waitForDeviceInRecovery (long waitTime)

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

boolean waitForDeviceInSideload (long waitTime)

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

boolean waitForDeviceNotAvailable (long waitTime)

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

void waitForDeviceOnline ()

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

void waitForDeviceOnline (long waitTime)

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

boolean waitForDeviceShell (long waitTime)

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

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

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

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

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

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

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

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

void ensureRuntimePermissionSupported ()

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

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

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

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

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

boolean isInRebootCallback ()

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

boolean isNewer (File localFile, IFileEntry entry)

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

void notifyRebootEnded ()

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

void notifyRebootStarted ()

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

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

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

void postAdbReboot ()

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

void prePostBootSetup ()

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

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

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

void setMicrodroidProcess (Process process)

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

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

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

CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)

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

boolean waitForDeviceNotAvailable (String operationDesc, long time)

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

Константы

INVALID_USER_ID

public static final int INVALID_USER_ID

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

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

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

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

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

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

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

Поля

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mОпции

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

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

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

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

Создает TestDevice .

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

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

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

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

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

public void batchPrefetchStartupBuildProps ()

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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

Возврат
boolean

Броски
DeviceNotAvailableException

проверкаApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

Броски
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity ()

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

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

Броски
DeviceNotAvailableException

ClearErrorDialogs

public boolean clearErrorDialogs ()

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

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

Броски
DeviceNotAvailableException

ClearLastConnectedWiFiNetwork

public void clearLastConnectedWifiNetwork ()

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

очиститьLogcat

public void clearLogcat ()

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

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

ConnectToWiFiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

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

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

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

Броски
DeviceNotAvailableException

ConnectToWiFiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

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

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

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

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

Броски
DeviceNotAvailableException

ConnectToWiFiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

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

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

Броски
DeviceNotAvailableException

ConnectToWiFiNetwork

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

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

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

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

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

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

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

Броски
DeviceNotAvailableException

ConnectToWifiNetworkIfNeeded

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

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

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

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

Броски
DeviceNotAvailableException

ConnectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

Броски
DeviceNotAvailableException

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

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

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

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

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

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

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

Броски
DeviceNotAvailableException

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

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

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

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

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

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

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

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

Броски
DeviceNotAvailableException

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

public int createUser (String name)

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

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

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

Броски
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

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

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

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

Броски
DeviceNotAvailableException

удалить файл

public void deleteFile (String deviceFilePath, 
                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 , который будет удален.

устройствоSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

Броски
DeviceNotAvailableException

устройствоSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

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

Броски
DeviceNotAvailableException

отключитьAdbRoot

public boolean disableAdbRoot ()

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

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

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

Броски
DeviceNotAvailableException

отключитьKeyguard

public void disableKeyguard ()

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

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

Броски
DeviceNotAvailableException

отключитьNetworkMonitor

public boolean disableNetworkMonitor ()

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

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

Броски
DeviceNotAvailableException

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

public boolean disconnectFromWifi ()

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

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

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

Броски
DeviceNotAvailableException

делаетFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

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

Броски
DeviceNotAvailableException

делаетFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

Броски
DeviceNotAvailableException

дампКуча

public File dumpHeap (String process, 
                String devicePath)

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

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

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

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

Броски
DeviceNotAvailableException

включитьAdbRoot

public boolean enableAdbRoot ()

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

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

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

Броски
DeviceNotAvailableException

включитьNetworkMonitor

public boolean enableNetworkMonitor ()

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

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

Броски
DeviceNotAvailableException

выполнитьAdbCommand

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

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

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

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

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

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

Броски
DeviceNotAvailableException

выполнитьAdbCommand

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

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

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

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

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

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

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

Броски
DeviceNotAvailableException

выполнитьAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

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

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

Броски
DeviceNotAvailableException

выполнитьFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

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

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

Броски
DeviceNotAvailableException

выполнитьFastbootCommand

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

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

Ожидается, что устройство уже находится в режиме 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 Версия BaseBand String или 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 (String format)

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

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

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

    Броски
    DeviceNotAvailableException

    GetScreenshot

    public InputStreamSource getScreenshot (long displayId)

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

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

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

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

    Броски
    DeviceNotAvailableException

    GetScreenshot

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

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

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

    rescale boolean : если скриншот следует изменить, чтобы уменьшить размер полученного изображения

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

    Броски
    DeviceNotAvailableException

    GetScreenshot

    public InputStreamSource getScreenshot ()

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

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

    Броски
    DeviceNotAvailableException

    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

    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

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

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

    Броски
    DeviceNotAvailableException

    почтовое обороты

    public void postAdbRootAction ()

    Переопределите, если устройству нужны определенные действия, которые необходимо предпринять после корня ADB, и до того, как устройство вернется в Интернет. Реализация по умолчанию не включает никаких действий с добавлением. На этом этапе корень ADB не гарантированно будет включен.

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

    почтовое обоснование

    public void postAdbUnrootAction ()

    Переопределите, если устройству нужны определенные действия, которые необходимо предпринять после ADB Unroot, и до того, как устройство вернется в Интернет. Реализация по умолчанию не включает никаких дополнительных действий. ADB Root не гарантированно будет отключен на этом этапе.

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

    postbootsetup

    public void postBootSetup ()

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

    Следует вызвать после того, как устройство полностью загружается/доступно

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

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

    Throws
    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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Throws
    DeviceNotAvailableException

    rebootIntoBootloader

    public void rebootIntoBootloader ()

    Reboots the device into bootloader mode.

    Blocks until device is in bootloader mode.

    Throws
    DeviceNotAvailableException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

    Reboots the device into fastbootd mode.

    Blocks until device is in fastbootd mode.

    Throws
    DeviceNotAvailableException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

    Reboots the device into adb recovery mode.

    Blocks until device enters recovery

    Throws
    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

    Throws
    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

    Throws
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline ()

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

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

    Throws
    DeviceNotAvailableException

    rebootUserspace

    public void rebootUserspace ()

    Reboots only userspace part of device.

    Blocks until device becomes available.

    ПРЕДУПРЕЖДЕНИЕ. Userspace reboot is currently under active development, use it on your own risk.

    Throws
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

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

    Throws
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

    Attempts to recover device communication.

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

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

    Throws
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

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

    Throws
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

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

    Throws
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

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

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

    Throws
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

    Remove all existing device profile owners with the best effort.

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

    Throws
    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

    Throws
    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

    Throws
    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

    Throws
    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

    Throws
    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

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

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

    Throws
    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

    Throws
    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

    Throws
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    Injects the ITestLogger instance

    Параметры
    testLogger ITestLogger

    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.

    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.

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

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

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

    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.

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

    Throws
    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

    Throws
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

    Switch device to adb over usb mode.

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

    Throws
    DeviceNotAvailableException

    поменять пользователя

    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.

    Throws
    DeviceNotAvailableException

    поменять пользователя

    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.

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

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

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

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

    Throws
    DeviceNotAvailableException

    unmountDebugfs

    public void unmountDebugfs ()

    Unmount debugfs.

    Throws
    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

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

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

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

    Throws
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

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

    Throws
    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

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

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

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

    Throws
    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

    initializeConnection

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

    Параметры
    info IBuildInfo

    attributes MultiMap

    Throws
    DeviceNotAvailableException
    TargetSetupError

    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

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

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    notifyRebootStarted

    protected void notifyRebootStarted ()

    Notifies all IDeviceActionReceiver about reboot start event.

    Throws
    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

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

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

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    pullFileInternal

    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    Параметры
    remoteFilePath String

    localFile File

    Возврат
    boolean

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