INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


Предоставляет надежный API немного более высокого уровня для IDevice ddmlib.

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

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

Константы

int UNKNOWN_API_LEVEL

Значение по умолчанию, если уровень API не может быть обнаружен

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

abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

abstract void clearLogcat ()

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

abstract void deleteFile (String deviceFilePath)

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

abstract boolean deviceSoftRestarted ( ProcessInfo prevSystemServerProcess)

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

abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

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

abstract boolean disableAdbRoot ()

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

abstract boolean doesFileExist (String deviceFilePath)

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

abstract boolean enableAdbRoot ()

Включает adb root.

abstract String executeAdbCommand (long timeout, String... commandArgs)

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

abstract String executeAdbCommand (String... commandArgs)

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

abstract String executeAdbCommand (long timeout, envMap, String... commandArgs) executeAdbCommand (long timeout, envMap, String... commandArgs)

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

abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)

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

abstract CommandResult executeFastbootCommand (String... commandArgs)

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

abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

abstract CommandResult executeLongFastbootCommand ( envVarMap, String... commandArgs) executeLongFastbootCommand ( envVarMap, String... commandArgs)

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

abstract String executeShellCommand (String command)

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

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

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

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

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

abstract void executeShellCommand (String command, IShellOutputReceiver receiver)

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

abstract CommandResult executeShellV2Command (String command)

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

abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)

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

abstract CommandResult executeShellV2Command (String command, File pipeAsInput)

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

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

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

abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)

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

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

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

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

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

abstract CommandResult fastbootWipePartition (String partition)

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

abstract int getApiLevel ()

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

abstract String getBasebandVersion ()

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

abstract Integer getBattery ()

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

abstract boolean getBooleanProperty (String name, boolean defaultValue)

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

abstract getBootHistory ()

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

abstract getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)

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

abstract String getBootloaderVersion ()

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

abstract String getBuildAlias ()

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

abstract String getBuildFlavor ()

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

abstract String getBuildId ()

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

abstract String getBuildSigningKeys ()

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

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

abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

abstract String[] getChildren (String deviceFilePath)

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

abstract AbstractConnection getConnection ()

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

abstract String getDeviceClass ()

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

abstract long getDeviceDate ()

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

abstract DeviceDescriptor getDeviceDescriptor ()

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

abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

abstract TestDeviceState getDeviceState ()

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

abstract long getDeviceTimeOffset (Date date)

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

abstract InputStreamSource getEmulatorOutput ()

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

abstract long getExternalStoreFreeSpace ()

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

abstract String getFastbootProductType ()

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

abstract String getFastbootProductVariant ()

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

abstract String getFastbootSerialNumber ()

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

abstract String getFastbootVariable (String variableName)

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

abstract IFileEntry getFileEntry (String path)

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

abstract IDevice getIDevice ()

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

abstract long getIntProperty (String name, long defaultValue)

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

abstract long getLastExpectedRebootTimeMillis ()

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

abstract int getLaunchApiLevel ()

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

abstract InputStreamSource getLogcat ()

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

abstract InputStreamSource getLogcat (int maxBytes)

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

abstract InputStreamSource getLogcatDump ()

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

abstract InputStreamSource getLogcatSince (long date)

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

abstract String getMountPoint (String mountName)

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

abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

abstract getMountPointInfo ()

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

abstract long getPartitionFreeSpace (String partition)

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

abstract ProcessInfo getProcessByName (String processName)

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

abstract String getProcessPid (String process)

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

abstract String getProductType ()

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

abstract String getProductVariant ()

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

abstract String getProperty (String name)

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

abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

abstract String getSerialNumber ()

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

abstract getTombstones ()

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

abstract long getTotalMemory ()

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

abstract boolean getUseFastbootErase ()

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

abstract boolean isAdbRoot ()
abstract boolean isAdbTcp ()
abstract boolean isAppEnumerationSupported ()

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

abstract boolean isBypassLowTargetSdkBlockSupported ()

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

abstract boolean isDebugfsMounted ()

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

abstract boolean isDeviceEncrypted ()

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

abstract boolean isDirectory (String deviceFilePath)

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

abstract boolean isEncryptionSupported ()

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

abstract boolean isExecutable (String fullPath)

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

abstract boolean isHeadless ()

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

abstract boolean isRuntimePermissionSupported ()

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

abstract boolean isStateBootloaderOrFastbootd ()

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

abstract boolean logAnrs ( ITestLogger logger)

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

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

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

abstract void mountDebugfs ()

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

abstract void nonBlockingReboot ()

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

abstract void postBootSetup ()

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

default void postInvocationTearDown ()

Этот метод устарел. Вместо этого используйте postInvocationTearDown(Throwable) .

abstract void postInvocationTearDown (Throwable invocationException)

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

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

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

abstract boolean pullDir (String deviceFilePath, File localDir)

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

abstract File pullFile (String remoteFilePath, int userId)

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

abstract File pullFile (String remoteFilePath)

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

abstract boolean pullFile (String remoteFilePath, File localFile)

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

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

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

abstract String pullFileContents (String remoteFilePath)

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

abstract File pullFileFromExternal (String remoteFilePath)

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

abstract boolean pushDir (File localDir, String deviceFilePath, excludedDirectories) pushDir (File localDir, String deviceFilePath, excludedDirectories)

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

abstract boolean pushDir (File localDir, String deviceFilePath)

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

abstract boolean pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)

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

abstract boolean pushFile (File localFile, String deviceFilePath)

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

abstract boolean pushString (String contents, String deviceFilePath)

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

abstract void reboot ()

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

abstract void reboot (String reason)

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

abstract void rebootIntoBootloader ()

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

abstract void rebootIntoFastbootd ()

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

abstract void rebootIntoRecovery ()

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

abstract void rebootIntoSideload (boolean autoReboot)

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

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

abstract void rebootIntoSideload ()

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

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

abstract void rebootUntilOnline ()

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

abstract void rebootUntilOnline (String reason)

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

abstract void rebootUserspace ()

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

abstract void rebootUserspaceUntilOnline ()

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

abstract void remountSystemReadOnly ()

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

abstract void remountSystemWritable ()

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

abstract void remountVendorReadOnly ()

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

abstract void remountVendorWritable ()

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

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

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

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

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

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

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

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

abstract void setDate (Date date)

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

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

abstract void setOptions ( TestDeviceOptions options)

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

abstract boolean setProperty (String propKey, String propValue)

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

abstract void setRecovery ( IDeviceRecovery recovery)

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

abstract void setRecoveryMode ( ITestDevice.RecoveryMode mode)

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

abstract void setUseFastbootErase (boolean useFastbootErase)

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

abstract void startLogcat ()

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

abstract void stopEmulatorOutput ()

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

abstract void stopLogcat ()

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

abstract String switchToAdbTcp ()

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

abstract boolean switchToAdbUsb ()

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

abstract boolean syncFiles (File localFileDir, String deviceFilePath)

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

abstract boolean unlockDevice ()

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

abstract void unmountDebugfs ()

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

abstract boolean waitForBootComplete (long timeOut)

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

abstract boolean waitForDeviceAvailable ()

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

abstract boolean waitForDeviceAvailable (long waitTime)

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

abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

abstract void waitForDeviceBootloader ()

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

abstract boolean waitForDeviceInRecovery (long waitTime)

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

abstract boolean waitForDeviceInSideload (long waitTime)

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

abstract boolean waitForDeviceNotAvailable (long waitTime)

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

abstract void waitForDeviceOnline ()

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

abstract void waitForDeviceOnline (long waitTime)

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

abstract boolean waitForDeviceShell (long waitTime)

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

Константы

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Значение по умолчанию, если уровень API не может быть обнаружен

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

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

проверкаApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

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

очиститьLogcat

public abstract void clearLogcat ()

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

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

удалить файл

public abstract void deleteFile (String deviceFilePath)

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

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

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

устройствоSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

Броски
RuntimeException если у устройства причина ненормальной загрузки
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

устройствоSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

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

Броски
RuntimeException если у устройства причина ненормальной загрузки
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

отключитьAdbRoot

public abstract boolean disableAdbRoot ()

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

делаетFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

включитьAdbRoot

public abstract boolean enableAdbRoot ()

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

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

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

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьAdbCommand

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

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

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

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

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьFastbootCommand

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

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

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

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

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

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

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьShellCommand

public abstract String executeShellCommand (String command)

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьShellCommand

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

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

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

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

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьShellCommand

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

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

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

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

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

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

выполнитьShellV2Command

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

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

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

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

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

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

Возврат
CommandResult

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

Смотрите также:

выполнитьShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

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

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

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

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

Возврат
CommandResult

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

Смотрите также:

выполнитьShellV2Command

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

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

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

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

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

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

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

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

Возврат
CommandResult

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

Смотрите также:

выполнитьShellV2Command

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

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

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

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

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

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

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

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

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

Возврат
CommandResult

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

Смотрите также:

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

getApiLevel

public abstract int getApiLevel ()

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

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

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

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не подлежит восстановлению.

getBattery

public abstract Integer getBattery ()

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

Возврат
Integer

getBooleanProperty

public abstract 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 abstract  getBootHistory ()

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

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

Броски
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

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

Броски
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

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

getBuildId

public abstract String getBuildId ()

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

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

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

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

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

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

Возврат
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

Возврат
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

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

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

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

getConnection

public abstract AbstractConnection getConnection ()

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

Возврат
AbstractConnection

GetDeviceClass

public abstract String getDeviceClass ()

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

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

getDeviceDate

public abstract long getDeviceDate ()

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

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

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

Возврат
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

Возврат
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

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

Возврат
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

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

Параметры
date Date

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

Броски
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

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

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

получитьFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

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

Броски
DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

ПолучитьFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

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

Возврат
String

получитьFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

Броски
УнподдерживаемоеОператионИсключение
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

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

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

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

getIDevice

public abstract IDevice getIDevice ()

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

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

Возврат
IDevice IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

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

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

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

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

Броски
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

Возврат
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

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

getLogcat

public abstract InputStreamSource getLogcat ()

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

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

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

    Возврат
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

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

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

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

    Возврат
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

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

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

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

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

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

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

    Возврат
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

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

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

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

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

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

    Смотрите также:

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    Параметры
    mountpoint String

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

    Броски
    DeviceNotAvailableException

    Смотрите также:

    getMountPointInfo

    public abstract  getMountPointInfo ()

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

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

    Броски
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

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

    Параметры
    partition String

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

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

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

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

    Броски
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

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

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

    Возврат
    String

    Броски
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

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

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

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

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

    GetProductVariant

    public abstract String getProductVariant ()

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

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

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    getProperty

    public abstract String getProperty (String name)

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

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

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

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

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

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

    public abstract String getSerialNumber ()

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

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

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

    public abstract  getTombstones ()

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

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

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

    Броски
    DeviceNotAvailableException

    Смотрите также:

    getTotalMemory

    public abstract long getTotalMemory ()

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

    Возврат
    long

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

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

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

    Смотрите также:

    isAdbRoot

    public abstract boolean isAdbRoot ()

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    isAdbTcp

    public abstract boolean isAdbTcp ()

    Возврат
    boolean true , если устройство подключено к adb-over-tcp, в противном случае false .

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

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

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

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

    isBypassLowTargetSdkBlockSupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

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

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

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

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

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

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

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

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

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

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

    Параметры
    deviceFilePath String

    Возврат
    boolean

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

    isEncryptionSupported

    public abstract boolean isEncryptionSupported ()

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

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

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

    isExecutable

    public abstract boolean isExecutable (String fullPath)

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

    Параметры
    fullPath String

    Возврат
    boolean

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

    isHeadless

    public abstract boolean isHeadless ()

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

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

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

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

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

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

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

    Возврат
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

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

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

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

    Броски
    DeviceNotAvailableException

    войти надевице

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

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

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

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

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

    args Object : аргументы, которые необходимо заменить с помощью String.format().

    mountDebugfs

    public abstract void mountDebugfs ()

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

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

    неблокирующая перезагрузка

    public abstract void nonBlockingReboot ()

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

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

    постBootSetup

    public abstract void postBootSetup ()

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

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

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

    Его может потребоваться вызвать, когда устройство перезагружается из-за других событий (например, после завершения команды обновления fastboot).

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    постПризывСнос

    public void postInvocationTearDown ()

    Этот метод устарел.
    Вместо этого используйте postInvocationTearDown(Throwable) .

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

    постПризывСнос

    public abstract void postInvocationTearDown (Throwable invocationException)

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

    Параметры
    invocationException Throwable : если есть, последнее исключение, вызванное сбоем вызова.

    предвызовНастройка

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

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

    Параметры
    info IBuildInfo : IBuildInfo устройства.

    attributes MultiMap : атрибуты, хранящиеся в контексте вызова.

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

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

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

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

    localDir File : локальный каталог для извлечения файлов.

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    вытащить файл

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

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

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

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

    Возврат
    File ERROR(/File) , содержащий содержимое файла устройства, или null если копирование не удалось по какой-либо причине (включая проблемы с файловой системой хоста).

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    вытащить файл

    public abstract File pullFile (String remoteFilePath)

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

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

    Возврат
    File ERROR(/File) , содержащий содержимое файла устройства, или null если копирование не удалось по какой-либо причине (включая проблемы с файловой системой хоста).

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    вытащить файл

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

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

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

    localFile File : локальный файл для хранения содержимого. Если не пусто, содержимое будет заменено.

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    вытащить файл

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

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

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

    localFile File : локальный файл для хранения содержимого. Если не пусто, содержимое будет заменено.

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

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

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

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

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

    Броски
    DeviceNotAvailableException

    вытащить филефромекстернал

    public abstract File pullFileFromExternal (String remoteFilePath)

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

    Параметры
    remoteFilePath String : путь к файлу на устройстве относительно точки монтирования внешнего хранилища устройства.

    Возврат
    File ERROR(/File) , содержащий содержимое файла устройства, или null если копирование не удалось по какой-либо причине (включая проблемы с файловой системой хоста).

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath, 
                     excludedDirectories)

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

    Параметры
    localDir File : локальный каталог для отправки

    deviceFilePath String : абсолютный путь к файлу удаленного пункта назначения.

    excludedDirectories : Набор имен исключенных каталогов, которые не следует пересылать.

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

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

    Параметры
    localDir File : локальный каталог для отправки

    deviceFilePath String : абсолютный путь к файлу удаленного пункта назначения.

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    boolean evaluateContentProviderNeeded)

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

    Параметры
    localFile File : локальный файл для отправки

    deviceFilePath String : абсолютный путь к файлу удаленного пункта назначения.

    evaluateContentProviderNeeded boolean : нужно ли проверять, нужен ли нам поставщик контента

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

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

    Параметры
    localFile File : локальный файл для отправки

    deviceFilePath String : абсолютный путь к файлу удаленного пункта назначения.

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    pushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

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

    Параметры
    contents String : содержимое файла для отправки.

    deviceFilePath String : абсолютный путь к файлу удаленного пункта назначения.

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

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

    public abstract void reboot ()

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

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

    Броски
    DeviceNotAvailableException если устройство недоступно после перезагрузки

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

    public abstract void reboot (String reason)

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

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

    Причину последней перезагрузки можно узнать, запросив свойство sys.boot.reason .

    Параметры
    reason String : причина перезагрузки или null , если причина не указана.

    Броски
    DeviceNotAvailableException если устройство недоступно после перезагрузки

    перезагрузкаIntoBootloader

    public abstract void rebootIntoBootloader ()

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

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    перезагрузкаIntoFastbootd

    public abstract void rebootIntoFastbootd ()

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

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    перезагрузкаIntoRecovery

    public abstract void rebootIntoRecovery ()

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

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

    Броски
    DeviceNotAvailableException если устройство недоступно после перезагрузки

    перезагрузкаIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

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

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

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

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

    перезагрузкаIntoSideload

    public abstract void rebootIntoSideload ()

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

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

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

    перезагрузкаUntilOnline

    public abstract void rebootUntilOnline ()

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

    Броски
    DeviceNotAvailableException если устройство недоступно после перезагрузки

    перезагрузкаUntilOnline

    public abstract void rebootUntilOnline (String reason)

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

    Параметры
    reason String : причина перезагрузки или null , если причина не указана.

    Броски
    DeviceNotAvailableException если устройство недоступно после перезагрузки

    Смотрите также:

    перезагрузкаПространство пользователя

    public abstract void rebootUserspace ()

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

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

    ПРЕДУПРЕЖДЕНИЕ. Перезагрузка пользовательского пространства в настоящее время находится в активной разработке, используйте ее на свой страх и риск.

    Броски
    DeviceNotAvailableException если устройство недоступно после перезагрузки

    перезагрузкаUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

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

    Броски
    DeviceNotAvailableException если устройство недоступно после перезагрузки

    перемонтироватьсистемеридонли

    public abstract void remountSystemReadOnly ()

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

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

    remountSystemWritable

    public abstract void remountSystemWritable ()

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

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

    перемонтироватьVendorReadOnly

    public abstract void remountVendorReadOnly ()

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

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

    перемонтироватьVendorWritable

    public abstract void remountVendorWritable ()

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

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

    запуститьInstrumentationTests

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

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

    Параметры
    runner IRemoteAndroidTestRunner : IRemoteAndroidTestRunner , который запускает тесты.

    listeners ITestLifeCycleReceiver : прослушиватель результатов теста.

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

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

    запуститьInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

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

    Если соединение с устройством потеряно до завершения тестового запуска и восстановление прошло успешно, все прослушиватели будут проинформированы о testRunFailed и будет возвращено значение «false». Тестовая команда не будет повторно выполняться. При необходимости вызывающим абонентам предоставляется возможность повторить попытку.

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

    Параметры
    runner IRemoteAndroidTestRunner : IRemoteAndroidTestRunner , который запускает тесты.

    listeners : слушатели результатов теста

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

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

    запуститьInstrumentationTestsAsUser

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

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

    Параметры
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    запуститьInstrumentationTestsAsUser

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

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

    Параметры
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Возврат
    boolean

    Броски
    DeviceNotAvailableException

    УстановитьДата

    public abstract void setDate (Date date)

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

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

    Параметры
    date Date : укажите конкретную дату; будет использовать дату хоста, если null

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

    УстановитьОпции

    public abstract void setOptions (TestDeviceOptions options)

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

    Параметры
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                    String propValue)

    Устанавливает заданное значение свойства на устройстве. Требуется adb root, это правда.

    Параметры
    propKey String : ключ, который необходимо установить.

    propValue String : значение свойства, которое необходимо установить.

    Возврат
    boolean возвращает True , если команда setprop прошла успешно, в противном случае — False.

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

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

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

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

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

    Параметры
    mode ITestDevice.RecoveryMode : должен ли быть включен режим «восстановление только онлайн» или нет.

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

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

    Параметры
    useFastbootErase boolean : true , если следует использовать стирание fastboot, или false если следует использовать формат fastboot.

    Смотрите также:

    startLogcat

    public abstract void startLogcat ()

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

    Не будет иметь никакого эффекта, если вывод logcat уже записывается. Данные можно позже получить с помощью getLogcat.

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

    startLogcat() и stopLogcat() обычно не требуют вызова в контексте вызова TF, поскольку платформа TF запускает и останавливает logcat.

    остановитьEmulatorOutput

    public abstract void stopEmulatorOutput ()

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

    стопLogcat

    public abstract void stopLogcat ()

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

    Не будет иметь никакого эффекта, если вывод logcat не захватывается.

    переключательToAdbTcp

    public abstract String switchToAdbTcp ()

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

    Возврат
    String серийный номер TCP или null , если устройство не удалось переключить

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

    переключательToAdbUsb

    public abstract boolean switchToAdbUsb ()

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

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

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

    синхронизировать файлы

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

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

    Решает, какие файлы отправлять, путем сравнения временных меток локальных файлов с их удаленными эквивалентами. На устройство будут перенесены только «более новые» или несуществующие файлы. Таким образом, накладные расходы должны быть относительно небольшими, если файл, установленный на устройстве, уже обновлен.

    Скрытые файлы (имена которых начинаются с «.») будут игнорироваться.

    Пример использования: syncFiles("/tmp/files", "/sdcard") создаст каталог /sdcard/files, если он еще не существует, и рекурсивно отправит содержимое /tmp/files в /sdcard/files.

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

    deviceFilePath String : абсолютный корень пути к удаленному файлу. Все каталоги в этом пути к файлу должны быть доступны для чтения. т.е. нажатие на /data/local/tmp, когда adb не является root, завершится неудачно.

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    разблокировать устройство

    public abstract boolean unlockDevice ()

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

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

    Возврат
    boolean true в случае успеха или если устройство не зашифровано.

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.
    UnsupportedOperationException если шифрование не поддерживается на устройстве.

    размонтироватьDebugfs

    public abstract void unmountDebugfs ()

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

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

    ждатьForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

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

    Параметры
    timeOut long : время в мсек для ожидания установки флага.

    Возврат
    boolean true, если флаг завершения загрузки устройства установлен в течение таймаута

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

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable ()

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

    Возврат
    boolean True, если устройство доступно, False, если восстановление отключено и недоступно.

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable (long waitTime)

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

    Параметры
    waitTime long : время ожидания в мс.

    Возврат
    boolean True, если устройство доступно, False, если восстановление отключено и недоступно.

    Броски
    DeviceNotAvailableException если устройство по-прежнему не отвечает после истечения времени ожидания.

    waitForDeviceAvailableInRecoverPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

    Параметры
    waitTime long

    Возврат
    boolean True, если устройство доступно, False, если недоступно.

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    waitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

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

    Параметры
    waitTime long : время ожидания в мс.

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

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

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

    Параметры
    waitTime long : время ожидания в мс.

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

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

    Параметры
    waitTime long : время ожидания в мс.

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

    ждатьForDeviceOnline

    public abstract void waitForDeviceOnline ()

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

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

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    ждатьForDeviceOnline

    public abstract void waitForDeviceOnline (long waitTime)

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

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

    Параметры
    waitTime long : время ожидания в мс.

    Броски
    DeviceNotAvailableException если связь с устройством потеряна и не может быть восстановлена.

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

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

    Параметры
    waitTime long : время ожидания в мс.

    Возврат
    boolean true , если устройство начинает реагировать до истечения waitTime .