INativeDevice
public interface INativeDevice
com.android.tradefed.device.INativeDevice |
Предоставляет надежный API немного более высокого уровня для ddmlib IDevice
.
Краткое содержание
Константы | |
---|---|
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 |
abstract boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) Вспомогательный метод для проверки того, было ли устройство мягко перезапущено с момента времени UTC с эпохи с устройства и его |
abstract boolean | disableAdbRoot () Отключает adb root. |
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) Вспомогательный метод, который выполняет команду fastboot как системную команду. |
abstract CommandResult | executeFastbootCommand (String... commandArgs) Вспомогательный метод, который выполняет команду fastboot как системную команду с таймаутом по умолчанию 2 минуты. |
abstract CommandResult | executeLongFastbootCommand (String... commandArgs) Вспомогательный метод, который выполняет длительную команду fastboot как системную команду. |
abstract CommandResult | executeLongFastbootCommand ( envVarMap, String... commandArgs) executeLongFastbootCommand ( envVarMap, String... commandArgs) Вспомогательный метод, который выполняет длительную команду fastboot как системную команду с системными переменными среды. |
abstract String | executeShellCommand (String command) Вспомогательный метод, который выполняет команду оболочки adb и возвращает выходные данные в виде |
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 и возвращает результаты в виде |
abstract CommandResult | executeShellV2Command (String command, OutputStream pipeToOutput) Вспомогательный метод, который выполняет команду оболочки adb и возвращает результаты в виде |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput) Вспомогательный метод, который выполняет команду оболочки adb и возвращает результаты в виде |
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 () Возвращает кэшированный |
abstract DeviceDescriptor | getCachedDeviceDescriptor (boolean shortDescriptor) Возвращает кэшированный |
abstract String[] | getChildren (String deviceFilePath) Альтернатива использованию |
abstract AbstractConnection | getConnection () Возвращает соединение, связанное с устройством. |
abstract String | getDeviceClass () Получите класс устройства. |
abstract long | getDeviceDate () Возвращает дату устройства в миллисекундах с начала эпохи. |
abstract DeviceDescriptor | getDeviceDescriptor () Верните |
abstract DeviceDescriptor | getDeviceDescriptor (boolean shortDescriptor) Верните |
abstract TestDeviceState | getDeviceState () Получить состояние устройства. |
abstract long | getDeviceTimeOffset (Date 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 () Возвращает ссылку на связанный |
abstract long | getIntProperty (String name, long defaultValue) Возвращает целочисленное значение данного свойства с устройства. |
abstract long | getLastExpectedRebootTimeMillis () Возвращает последний раз, когда API-интерфейсы Tradefed инициировали перезагрузку в миллисекундах с момента EPOCH, возвращаемого |
abstract int | getLaunchApiLevel () Получите первый запущенный уровень API устройства. |
abstract InputStreamSource | getLogcat () Захватывает поток моментальных снимков данных logcat. |
abstract InputStreamSource | getLogcat (int maxBytes) Захватывает поток моментальных снимков последних |
abstract InputStreamSource | getLogcatDump () Получите дамп текущего logcat для устройства. |
abstract InputStreamSource | getLogcatSince (long date) Захватывает поток моментальных снимков захваченных данных logcat, начиная с указанной даты. |
abstract String | getMountPoint (String mountName) Возвращает точку монтирования. |
abstract ITestDevice.MountPointInfo | getMountPointInfo (String mountpoint) Возвращает |
abstract | getMountPointInfo () Возвращает проанализированную версию информации в /proc/mounts на устройстве. |
abstract long | getPartitionFreeSpace (String partition) Вспомогательный метод для определения количества свободного места в разделе устройства. |
abstract ProcessInfo | getProcessByName (String processName) Вспомогательный метод запускает команды «pidof» и «stat» и возвращает объект |
abstract String | getProcessPid (String process) Возвращает pid службы или ноль, если что-то пошло не так. |
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 или формат fastboot для очистки раздела на устройстве. |
abstract boolean | isAdbRoot () |
abstract boolean | isAdbTcp () |
abstract boolean | isAppEnumerationSupported () Проверьте, поддерживает ли платформа на устройстве перечисление приложений. |
abstract boolean | isBypassLowTargetSdkBlockSupported () Проверьте, поддерживает ли платформа на устройстве обход нижнего целевого блока SDK при установке приложения. |
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, если устройство находится в |
abstract boolean | logAnrs ( ITestLogger logger) Собирает и регистрирует ANR с устройства. |
abstract void | logOnDevice (String tag, Log.LogLevel level, String format, Object... args) Запишите сообщение в logcat устройства. |
abstract void | nonBlockingReboot () Выдает команду для перезагрузки устройства и возвращается после завершения команды и когда устройство больше не отображается для adb. |
abstract void | postBootSetup () Выполните инструкции по настройке устройства для тестирования после каждой загрузки. |
default void | postInvocationTearDown () Этот метод устарел. Вместо этого используйте |
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) Извлекает файл с устройства, сохраняет его в локальной временной |
abstract File | pullFile (String remoteFilePath) Извлекает файл с устройства, сохраняет его в локальной временной |
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) Удобный метод извлечения файла из внешнего хранилища устройства, сохранения его в локальной временной |
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) Вариант |
abstract boolean | pushFile (File localFile, String deviceFilePath) Отправьте файл на устройство. |
abstract boolean | pushString (String contents, String deviceFilePath) Отправить файл, созданный из строки, на устройство |
abstract void | reboot () Перезагружает устройство в режим adb. |
abstract void | reboot (String reason) Перезагружает устройство в режим adb с заданной |
abstract void | rebootIntoBootloader () Перезагружает устройство в режим загрузчика. |
abstract void | rebootIntoFastbootd () Перезагружает устройство в режим fastbootd. |
abstract void | rebootIntoRecovery () Перезагружает устройство в режим восстановления adb. |
abstract void | rebootIntoSideload (boolean autoReboot) Перезагружает устройство в режим adb sideload (обратите внимание, что это специальный режим восстановления) Блокирует до тех пор, пока устройство не перейдет в режим боковой загрузки |
abstract void | rebootIntoSideload () Перезагружает устройство в режим adb sideload (обратите внимание, что это специальный режим восстановления) Блокирует до тех пор, пока устройство не перейдет в режим боковой загрузки |
abstract void | rebootUntilOnline () Альтернатива |
abstract void | rebootUntilOnline (String reason) Альтернатива |
abstract void | rebootUserspace () Перезагружает только пользовательскую часть устройства. |
abstract void | rebootUserspaceUntilOnline () Альтернатива |
abstract void | remountSystemReadOnly () Сделайте системный раздел на устройстве доступным только для чтения. |
abstract void | remountSystemWritable () Сделайте системный раздел на устройстве доступным для записи. |
abstract void | remountVendorReadOnly () Сделайте раздел поставщика на устройстве доступным только для чтения. |
abstract void | remountVendorWritable () Сделайте раздел поставщика на устройстве доступным для записи. |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) Удобный метод для выполнения |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) Выполняет инструментальные тесты и обеспечивает восстановление устройства. |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) То же, что и |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) То же, что и |
abstract void | setDate (Date date) Устанавливает дату на устройстве Примечание: для установки даты на устройстве требуется root |
abstract void | setOptions ( TestDeviceOptions options) Установите |
abstract boolean | setProperty (String propKey, String propValue) Устанавливает заданное значение свойства на устройстве. |
abstract void | setRecovery ( IDeviceRecovery recovery) Установите |
abstract void | setRecoveryMode ( ITestDevice.RecoveryMode mode) Установите текущий режим восстановления для использования на устройстве. |
abstract void | setUseFastbootErase (boolean useFastbootErase) Укажите, следует ли использовать стирание fastboot или форматирование fastboot для очистки раздела на устройстве. |
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 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 recovery» (обратите внимание, что это отличается от |
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. |
Константы
НЕИЗВЕСТНЫЙ_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 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)
Вспомогательный метод, который выполняет команду fastboot как системную команду.
Предполагается использовать, когда устройство уже находится в режиме быстрой загрузки.Параметры | |
---|---|
timeout | long : время в миллисекундах до истечения срока действия команды |
commandArgs | String : команда fastboot и аргументы для запуска |
Возвращает | |
---|---|
CommandResult | CommandResult, содержащий вывод команды |
Броски | |
---|---|
DeviceNotAvailableException | если связь с устройством потеряна и не может быть восстановлена. |
выполнить FastbootCommand
public abstract CommandResult executeFastbootCommand (String... commandArgs)
Вспомогательный метод, который выполняет команду fastboot как системную команду с таймаутом по умолчанию 2 минуты.
Предполагается использовать, когда устройство уже находится в режиме быстрой загрузки.
Параметры | |
---|---|
commandArgs | String : команда fastboot и аргументы для запуска |
Возвращает | |
---|---|
CommandResult | CommandResult, содержащий вывод команды |
Броски | |
---|---|
DeviceNotAvailableException | если связь с устройством потеряна и не может быть восстановлена. |
выполнить команду LongFastboot
public abstract CommandResult executeLongFastbootCommand (String... commandArgs)
Вспомогательный метод, который выполняет длительную команду fastboot как системную команду.
ИдентиченexecuteFastbootCommand(String)
за исключением того, что используется более длительный тайм-аут.Параметры | |
---|---|
commandArgs | String : команда fastboot и аргументы для запуска |
Возвращает | |
---|---|
CommandResult | CommandResult, содержащий вывод команды |
Броски | |
---|---|
DeviceNotAvailableException | если связь с устройством потеряна и не может быть восстановлена. |
выполнить команду LongFastboot
public abstract CommandResult executeLongFastbootCommand (envVarMap, String... commandArgs)
Вспомогательный метод, который выполняет длительную команду fastboot как системную команду с системными переменными среды.
Идентичен executeFastbootCommand(String)
за исключением того, что используется более длительный тайм-аут.
Параметры | |
---|---|
envVarMap | |
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
, правильно заполненного выводом состояния команды, stdout и 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
, правильно заполненного выводом состояния команды, stdout и 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. Затем устройство должно создать файловую систему при следующей загрузке устройства. В противном случае используется формат 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, и возвращаемая здесь версия может не совпадать с версией, полученной от fastboot, и может не возвращать версию для радио CDMA. TL;DR: этот метод сообщает точную версию только в том случае, если свойство gsm.version.baseband совпадает с версией, возвращаемой fastboot getvar version-baseband
.
Возвращает | |
---|---|
String | String baseband version или null , если она не может быть определена (устройство не имеет радио или строка версии не может быть прочитана) |
Броски | |
---|---|
DeviceNotAvailableException | если связь с устройством потеряна и не может быть восстановлена. |
получитьбатарея
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 abstractgetBootHistory ()
Вспомогательный метод собирает карту истории загрузки с указанием времени загрузки и причины загрузки.
Возвращает | |
---|---|
Карта времени загрузки (время UTC в секундах с начала эпохи) и причина загрузки |
Броски | |
---|---|
DeviceNotAvailableException |
getBootHistorySince
public abstractgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
Вспомогательный метод собирает карту истории загрузки с указанием времени загрузки и причины загрузки с заданного времени с начала эпохи с устройства и указанной единицы времени. Текущее время utcEpochTime устройства в миллисекундах можно получить с помощью метода getDeviceDate()
.
Параметры | |
---|---|
utcEpochTime | long : время устройства с начала эпохи. |
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 |
получитьдетей
public abstract String[] getChildren (String deviceFilePath)
Альтернатива использованию IFileEntry
, которая иногда не работает из-за разрешений.
Параметры | |
---|---|
deviceFilePath | String : это путь на устройстве, где выполнять поиск |
Возвращает | |
---|---|
String[] | Массив строк, содержащих все файлы по пути на устройстве. |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
получитьсоединение
public abstract AbstractConnection getConnection ()
Возвращает соединение, связанное с устройством.
Возвращает | |
---|---|
AbstractConnection |
получитькласс устройства
public abstract String getDeviceClass ()
Получите класс устройства.
Возвращает | |
---|---|
String | класс устройства String . |
getDeviceDate
public abstract long getDeviceDate ()
Возвращает дату устройства в миллисекундах с начала эпохи.
Возвращает | |
---|---|
long | дата устройства в формате эпохи. |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
получитьDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor ()
Верните DeviceDescriptor
из информации об устройстве, чтобы получить информацию о нем без передачи фактического объекта устройства.
Возвращает | |
---|---|
DeviceDescriptor |
получитьDeviceDescriptor
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 | если связь с устройством потеряна и не может быть восстановлена. |
getFastbootProductVariant
public abstract String getFastbootProductVariant ()
Удобный метод получения типа продукта этого устройства, когда оно находится в режиме быстрой загрузки.
Этот метод следует использовать только в том случае, если устройство должно быть в режиме быстрой загрузки. В этом случае это немного более безопасный вариант, чем общий методgetProductType()
, потому что ITestDevice будет знать, что нужно восстановить устройство в режиме быстрой загрузки, если устройство находится в неправильном состоянии или не отвечает.Возвращает | |
---|---|
String | имя типа продукта String или null если его невозможно определить |
Броски | |
---|---|
DeviceNotAvailableException | если связь с устройством потеряна и не может быть восстановлена. |
получить серийный номер Fastboot
public abstract String getFastbootSerialNumber ()
Возвращает серийный номер режима быстрой загрузки.
Возвращает | |
---|---|
String |
getFastbootVariable
public abstract String getFastbootVariable (String variableName)
Получите заданное значение переменной fastboot с устройства.
Параметры | |
---|---|
variableName | String : имя переменной |
Возвращает | |
---|---|
String | значение свойства или null , если оно не существует |
Броски | |
---|---|
| UnsupportedOperationException |
DeviceNotAvailableException |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
Получить ссылку на удаленный файл на устройстве.
Параметры | |
---|---|
path | String : путь к файлу для извлечения. Может быть абсолютным путем или путем относительно '/'. (т.е. поддерживается синтаксис "/system" и "system") |
Возвращает | |
---|---|
IFileEntry | IFileEntry или null , если файл по указанному path не может быть найден |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
получитьIDevice
public abstract IDevice getIDevice ()
Возвращает ссылку на связанный IDevice
ddmlib.
IDevice
каждый раз, когда устройство отключается и снова подключается к adb. Таким образом, вызывающие объекты не должны сохранять ссылку на IDevice
, поскольку эта ссылка может устареть.Возвращает | |
---|---|
IDevice | IDevice |
получитьинтпроперти
public abstract long getIntProperty (String name, long defaultValue)
Возвращает целочисленное значение данного свойства с устройства.
Параметры | |
---|---|
name | String : имя свойства |
defaultValue | long : возвращаемое значение по умолчанию, если свойство пусто или не существует. |
Возвращает | |
---|---|
long | значение свойства или defaultValue если свойство пусто, не существует или не имеет целочисленного значения. |
Броски | |
---|---|
DeviceNotAvailableException |
getLastExpectedRebootTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
Returns the last time Tradefed APIs triggered a reboot in milliseconds since EPOCH as returned by System.currentTimeMillis()
.
Возвращает | |
---|---|
long |
getLaunchApiLevel
public abstract int getLaunchApiLevel ()
Get the device's first launched API Level. Defaults to UNKNOWN_API_LEVEL
.
Возвращает | |
---|---|
int | an integer indicating the first launched API Level of device |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getLogcat
public abstract InputStreamSource getLogcat ()
Grabs a snapshot stream of the logcat data.
Works in two modes:
TestDeviceOptions.getMaxLogcatDataSize()
bytes of the current contents of the background logcat captureВозвращает | |
---|---|
InputStreamSource |
getLogcat
public abstract InputStreamSource getLogcat (int maxBytes)
Grabs a snapshot stream of the last maxBytes
of captured logcat data.
Useful for cases when you want to capture frequent snapshots of the captured logcat data without incurring the potentially big disk space penalty of getting the entire getLogcat()
snapshot.
Параметры | |
---|---|
maxBytes | int : the maximum amount of data to return. Should be an amount that can comfortably fit in memory |
Возвращает | |
---|---|
InputStreamSource |
getLogcatDump
public abstract InputStreamSource getLogcatDump ()
Get a dump of the current logcat for device. Unlike getLogcat()
, this method will always return a static dump of the logcat.
Has the disadvantage that nothing will be returned if device is not reachable.
Возвращает | |
---|---|
InputStreamSource | a InputStreamSource of the logcat data. An empty stream is returned if fail to capture logcat data. |
getLogcatSince
public abstract InputStreamSource getLogcatSince (long date)
Grabs a snapshot stream of captured logcat data starting the date provided. The time on the device should be used getDeviceDate()
.
Параметры | |
---|---|
date | long : in millisecond since epoch format of when to start the snapshot until present. (can be be obtained using 'date +%s') |
Возвращает | |
---|---|
InputStreamSource |
getMountPoint
public abstract String getMountPoint (String mountName)
Returns a mount point.
Queries the device directly if the cached info inIDevice
is not available. TODO: move this behavior to IDevice#getMountPoint(String)
Параметры | |
---|---|
mountName | String : the name of the mount point |
Возвращает | |
---|---|
String | the mount point or null |
See also:
getMountPointInfo
public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Returns a MountPointInfo
corresponding to the specified mountpoint path, or null
if that path has nothing mounted or otherwise does not appear in /proc/mounts as a mountpoint.
Параметры | |
---|---|
mountpoint | String |
Возвращает | |
---|---|
ITestDevice.MountPointInfo | A ERROR(/List) of MountPointInfo containing the information in "/proc/mounts" |
Броски | |
---|---|
DeviceNotAvailableException |
See also:
getMountPointInfo
public abstractgetMountPointInfo ()
Returns a parsed version of the information in /proc/mounts on the device
Возвращает | |
---|---|
A ERROR(/List) of MountPointInfo containing the information in "/proc/mounts" |
Броски | |
---|---|
DeviceNotAvailableException |
getPartitionFreeSpace
public abstract long getPartitionFreeSpace (String partition)
Helper method to determine amount of free space on device partition.
Параметры | |
---|---|
partition | String |
Возвращает | |
---|---|
long | the amount of free space in KB |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
getProcessByName
public abstract ProcessInfo getProcessByName (String processName)
Helper method runs the "pidof" and "stat" command and returns ProcessInfo
object with PID and process start time of the given process.
Параметры | |
---|---|
processName | String : the proces name String. |
Возвращает | |
---|---|
ProcessInfo | ProcessInfo of given processName |
Броски | |
---|---|
DeviceNotAvailableException |
getProcessPid
public abstract String getProcessPid (String process)
Returns the pid of the service or null if something went wrong.
Параметры | |
---|---|
process | String : The proces name String. |
Возвращает | |
---|---|
String |
Броски | |
---|---|
DeviceNotAvailableException |
getProductType
public abstract String getProductType ()
Convenience method to get the product type of this device.
This method will work if device is in either adb or fastboot mode.Возвращает | |
---|---|
String | the String product type name. Will not be null |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered, or if product type can not be determined |
getProductVariant
public abstract String getProductVariant ()
Convenience method to get the product variant of this device.
This method will work if device is in either adb or fastboot mode.Возвращает | |
---|---|
String | the String product variant name or null if it cannot be determined |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
getProperty
public abstract String getProperty (String name)
Retrieve the given property value from the device.
Параметры | |
---|---|
name | String : the property name |
Возвращает | |
---|---|
String | the property value or null if it does not exist |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getRecoveryMode
public abstract ITestDevice.RecoveryMode getRecoveryMode ()
Get the current recovery mode used for the device.
Возвращает | |
---|---|
ITestDevice.RecoveryMode | the current recovery mode used for the device. |
getSerialNumber
public abstract String getSerialNumber ()
Convenience method to get serial number of this device.
Возвращает | |
---|---|
String | the String serial number |
getTombstones
public abstractgetTombstones ()
Fetch and return the list of tombstones from the devices. Requires root.
method is best-effort so if one tombstone fails to be pulled for any reason it will be missing from the list. Only a DeviceNotAvailableException
will terminate the method early.
Возвращает | |
---|---|
A list of tombstone files, empty if no tombstone. |
Броски | |
---|---|
DeviceNotAvailableException |
See also:
getTotalMemory
public abstract long getTotalMemory ()
Returns total physical memory size in bytes or -1 in case of internal error
Возвращает | |
---|---|
long |
getUseFastbootErase
public abstract boolean getUseFastbootErase ()
Get whether to use fastboot erase or fastboot format to wipe a partition on the device.
Возвращает | |
---|---|
boolean | true if fastboot erase will be used or false if fastboot format will be used. |
See also:
isAdbRoot
public abstract boolean isAdbRoot ()
Возвращает | |
---|---|
boolean | true if device currently has adb root, false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
isAdbTcp
public abstract boolean isAdbTcp ()
Возвращает | |
---|---|
boolean | true if device is connected to adb-over-tcp, false otherwise. |
isAppEnumerationSupported
public abstract boolean isAppEnumerationSupported ()
Check whether platform on device supports app enumeration
Возвращает | |
---|---|
boolean | True if app enumeration is supported, false otherwise |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported
public abstract boolean isBypassLowTargetSdkBlockSupported ()
Check whether platform on device supports bypassing low target sdk block on app installs
Возвращает | |
---|---|
boolean | True if bypass low target sdk block is supported, false otherwise |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isDeviceEncrypted
public abstract boolean isDeviceEncrypted ()
Returns if the device is encrypted.
Возвращает | |
---|---|
boolean | true if the device is encrypted. |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
isDirectory
public abstract boolean isDirectory (String deviceFilePath)
Return True if the path on the device is a directory, false otherwise.
Параметры | |
---|---|
deviceFilePath | String |
Возвращает | |
---|---|
boolean |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isEncryptionSupported
public abstract boolean isEncryptionSupported ()
Returns if encryption is supported on the device.
Возвращает | |
---|---|
boolean | true if the device supports encryption. |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isExecutable
public abstract boolean isExecutable (String fullPath)
Returns True if the file path on the device is an executable file, false otherwise.
Параметры | |
---|---|
fullPath | String |
Возвращает | |
---|---|
boolean |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isHeadless
public abstract boolean isHeadless ()
Return true if the device is headless (no screen), false otherwise.
Возвращает | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported
public abstract boolean isRuntimePermissionSupported ()
Check whether platform on device supports runtime permission granting
Возвращает | |
---|---|
boolean | True if runtime permission are supported, false otherwise. |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public abstract boolean isStateBootloaderOrFastbootd ()
Returns true if device is in TestDeviceState#FASTBOOT
or TestDeviceState.FASTBOOTD
.
Возвращает | |
---|---|
boolean |
logAnrs
public abstract boolean logAnrs (ITestLogger logger)
Collects and log ANRs from the device.
Параметры | |
---|---|
logger | ITestLogger : an ITestLogger to log the ANRs. |
Возвращает | |
---|---|
boolean | True if the logging was successful, false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
logOnDevice
public abstract void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Log a message in the logcat of the device. This is a safe call that will not throw even if the logging fails.
Параметры | |
---|---|
tag | String : The tag under which we log our message in the logcat. |
level | Log.LogLevel : The debug level of the message in the logcat. |
format | String : The message format. |
args | Object : the args to be replaced via String.format(). |
nonBlockingReboot
public abstract void nonBlockingReboot ()
Issues a command to reboot device and returns on command complete and when device is no longer visible to adb.
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postBootSetup
public abstract void postBootSetup ()
Perform instructions to configure device for testing that after every boot.
Should be called after device is fully booted/available In normal circumstances this method doesn't need to be called explicitly, as implementations should perform these steps automatically when performing a reboot. Where it may need to be called is when device reboots due to other events (eg when a fastboot update command has completed)Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
postInvocationTearDown
public void postInvocationTearDown ()
This method is deprecated.
Use postInvocationTearDown(Throwable)
instead.
Extra steps for device specific required clean up that will be executed after the invocation is done.
postInvocationTearDown
public abstract void postInvocationTearDown (Throwable invocationException)
Extra steps for device specific required clean up that will be executed after the invocation is done.
Параметры | |
---|---|
invocationException | Throwable : if any, the final exception raised by the invocation failure. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.
Параметры | |
---|---|
info | IBuildInfo : The IBuildInfo of the device. |
attributes | MultiMap : The attributes stored in the invocation context |
Броски | |
---|---|
| com.android.tradefed.targetprep.TargetSetupError |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException | |
TargetSetupError |
pullDir
public abstract boolean pullDir (String deviceFilePath, File localDir)
Recursively pull directory contents from device.
Параметры | |
---|---|
deviceFilePath | String : the absolute file path of the remote source |
localDir | File : the local directory to pull files into |
Возвращает | |
---|---|
boolean | true if file was pulled successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pullFile
public abstract File pullFile (String remoteFilePath, int userId)
Retrieves a file off device, stores it in a local temporary ERROR(/File)
, and returns that File
.
Параметры | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
userId | int : The user id to pull from |
Возвращает | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pullFile
public abstract File pullFile (String remoteFilePath)
Retrieves a file off device, stores it in a local temporary ERROR(/File)
, and returns that File
.
Параметры | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
Возвращает | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pullFile
public abstract boolean pullFile (String remoteFilePath, File localFile)
Retrieves a file off device.
Параметры | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
localFile | File : the local file to store contents in. If non-empty, contents will be replaced. |
Возвращает | |
---|---|
boolean | true if file was retrieved successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pullFile
public abstract boolean pullFile (String remoteFilePath, File localFile, int userId)
Retrieves a file off device.
Параметры | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
localFile | File : the local file to store contents in. If non-empty, contents will be replaced. |
userId | int : The user id to pull from |
Возвращает | |
---|---|
boolean | true if file was retrieved successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pullFileContents
public abstract String pullFileContents (String remoteFilePath)
Retrieves a file off device, and returns the contents.
Параметры | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
Возвращает | |
---|---|
String | A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Броски | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public abstract File pullFileFromExternal (String remoteFilePath)
A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File)
, and return a reference to that File
.
Параметры | |
---|---|
remoteFilePath | String : the path to file on device, relative to the device's external storage mountpoint |
Возвращает | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath,excludedDirectories)
Recursively push directory contents to device while excluding some directories that are filtered.
Параметры | |
---|---|
localDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
excludedDirectories |
Возвращает | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath)
Recursively push directory contents to device.
Параметры | |
---|---|
localDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
Возвращает | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pushFile
public abstract boolean pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
Variant of pushFile(File, String)
which can optionally consider evaluating the need for the content provider.
Параметры | |
---|---|
localFile | File : the local file to push |
deviceFilePath | String : the remote destination absolute file path |
evaluateContentProviderNeeded | boolean : whether to check if we need the content provider |
Возвращает | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pushFile
public abstract boolean pushFile (File localFile, String deviceFilePath)
Push a file to device. By default using a content provider.
Параметры | |
---|---|
localFile | File : the local file to push |
deviceFilePath | String : the remote destination absolute file path |
Возвращает | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pushString
public abstract boolean pushString (String contents, String deviceFilePath)
Push file created from a string to device
Параметры | |
---|---|
contents | String : the contents of the file to push |
deviceFilePath | String : the remote destination absolute file path |
Возвращает | |
---|---|
boolean | true if string was pushed successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
reboot
public abstract void reboot ()
Reboots the device into adb mode.
Blocks until device becomes available.Броски | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
reboot
public abstract void reboot (String reason)
Reboots the device into adb mode with given reason
to be persisted across reboot.
Blocks until device becomes available.
Last reboot reason can be obtained by querying sys.boot.reason
propety.
Параметры | |
---|---|
reason | String : a reason for this reboot, or null if no reason is specified. |
Броски | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
rebootIntoBootloader
public abstract void rebootIntoBootloader ()
Reboots the device into bootloader mode.
Blocks until device is in bootloader mode.Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
rebootIntoFastbootd
public abstract void rebootIntoFastbootd ()
Reboots the device into fastbootd mode.
Blocks until device is in fastbootd mode.
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
rebootIntoRecovery
public abstract void rebootIntoRecovery ()
Reboots the device into adb recovery mode.
Blocks until device enters recoveryБроски | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
rebootIntoSideload
public abstract void rebootIntoSideload (boolean autoReboot)
Reboots the device into adb sideload mode (note that this is a special mode under recovery)
Blocks until device enters sideload mode
Параметры | |
---|---|
autoReboot | boolean : whether to automatically reboot the device after sideload |
Броски | |
---|---|
DeviceNotAvailableException | if device is not in sideload after reboot |
rebootIntoSideload
public abstract void rebootIntoSideload ()
Reboots the device into adb sideload mode (note that this is a special mode under recovery)
Blocks until device enters sideload mode
Броски | |
---|---|
DeviceNotAvailableException | if device is not in sideload after reboot |
rebootUntilOnline
public abstract void rebootUntilOnline ()
An alternate to reboot()
that only blocks until device is online ie visible to adb.
Броски | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
rebootUntilOnline
public abstract void rebootUntilOnline (String reason)
An alternate to reboot()
that only blocks until device is online ie visible to adb.
Параметры | |
---|---|
reason | String : a reason for this reboot, or null if no reason is specified. |
Броски | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
See also:
rebootUserspace
public abstract void rebootUserspace ()
Reboots only userspace part of device.
Blocks until device becomes available.
WARNING. Userspace reboot is currently under active development, use it on your own risk.
Броски | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
rebootUserspaceUntilOnline
public abstract void rebootUserspaceUntilOnline ()
An alternate to rebootUserspace()
()} that only blocks until device is online ie visible to adb.
Броски | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
remountSystemReadOnly
public abstract void remountSystemReadOnly ()
Make the system partition on the device read-only. May reboot the device.
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountSystemWritable
public abstract void remountSystemWritable ()
Make the system partition on the device writable. May reboot the device.
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountVendorReadOnly
public abstract void remountVendorReadOnly ()
Make the vendor partition on the device read-only. May reboot the device.
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountVendorWritable
public abstract void remountVendorWritable ()
Make the vendor partition on the device writable. May reboot the device.
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
with one or more listeners passed as parameters.
Параметры | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners | ITestLifeCycleReceiver : the test result listener(s) |
Возвращает | |
---|---|
boolean | true if test command completed. false if it failed to complete, but recovery succeeded |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed. |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Runs instrumentation tests, and provides device recovery.
If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.
If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.
Параметры | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners |
Возвращает | |
---|---|
boolean | true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed. |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
but runs the test for the given user.
Параметры | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners |
Возвращает | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
but runs the test for a given user.
Параметры | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
Возвращает | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
setDate
public abstract void setDate (Date date)
Sets the date on device
Note: setting date on device requires root
Параметры | |
---|---|
date | Date : specify a particular date; will use host date if null |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setOptions
public abstract void setOptions (TestDeviceOptions options)
Set the TestDeviceOptions
for the device
Параметры | |
---|---|
options | TestDeviceOptions |
setProperty
public abstract boolean setProperty (String propKey, String propValue)
Sets the given property value on the device. Requires adb root is true.
Параметры | |
---|---|
propKey | String : The key targeted to be set. |
propValue | String : The property value to be set. |
Возвращает | |
---|---|
boolean | returns True if the setprop command was successful, False otherwise. |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRecovery
public abstract void setRecovery (IDeviceRecovery recovery)
Set the IDeviceRecovery
to use for this device. Should be set when device is first allocated.
Параметры | |
---|---|
recovery | IDeviceRecovery : the IDeviceRecovery |
setRecoveryMode
public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)
Set the current recovery mode to use for the device.
Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etcПараметры | |
---|---|
mode | ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not. |
setUseFastbootErase
public abstract void setUseFastbootErase (boolean useFastbootErase)
Set whether to use fastboot erase or fastboot format to wipe a partition on the device.
Параметры | |
---|---|
useFastbootErase | boolean : true if fastboot erase should be used or false if fastboot format should be used. |
See also:
startLogcat
public abstract void startLogcat ()
Start capturing logcat output from device in the background.
Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat. When the device is no longer in use,stopLogcat()
must be called. startLogcat()
and stopLogcat()
do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.stopEmulatorOutput
public abstract void stopEmulatorOutput ()
Close and delete the emulator output.
stopLogcat
public abstract void stopLogcat ()
Stop capturing logcat output from device, and discard currently saved logcat data.
Will have no effect if logcat output is not being captured.switchToAdbTcp
public abstract String switchToAdbTcp ()
Switch device to adb-over-tcp mode.
Возвращает | |
---|---|
String | the tcp serial number or null if device could not be switched |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
switchToAdbUsb
public abstract boolean switchToAdbUsb ()
Switch device to adb over usb mode.
Возвращает | |
---|---|
boolean | true if switch was successful, false otherwise. |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
syncFiles
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
Incrementally syncs the contents of a local file directory to device.
Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date. Hidden files (with names starting with ".") will be ignored. Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.Параметры | |
---|---|
localFileDir | File : the local file directory containing files to recursively push. |
deviceFilePath | String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail |
Возвращает | |
---|---|
boolean | true if files were synced successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
unlockDevice
public abstract boolean unlockDevice ()
Unlocks the device if the device is in an encrypted state.
This method may restart the framework but will not callpostBootSetup()
. Therefore, the device might not be fully ready to be tested when this method returns.Возвращает | |
---|---|
boolean | true if successful or if the device is unencrypted. |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
UnsupportedOperationException | if encryption is not supported on the device. |
waitForBootComplete
public abstract boolean waitForBootComplete (long timeOut)
Blocks until the device's boot complete flag is set.
Параметры | |
---|---|
timeOut | long : time in msecs to wait for the flag to be set |
Возвращает | |
---|---|
boolean | true if device's boot complete flag is set within the timeout |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
waitForDeviceAvailable
public abstract boolean waitForDeviceAvailable ()
Waits for the device to be responsive and available for testing. Uses default timeout.
Возвращает | |
---|---|
boolean | True if device is available, False if recovery is disabled and unavailable. |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
waitForDeviceAvailable
public abstract boolean waitForDeviceAvailable (long waitTime)
Waits for the device to be responsive and available for testing.
Параметры | |
---|---|
waitTime | long : the time in ms to wait |
Возвращает | |
---|---|
boolean | True if device is available, False if recovery is disabled and unavailable. |
Броски | |
---|---|
DeviceNotAvailableException | if device is still unresponsive after waitTime expires. |
waitForDeviceAvailableInRecoverPath
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Waits for the device to be responsive and available without considering recovery path.
Параметры | |
---|---|
waitTime | long |
Возвращает | |
---|---|
boolean | True if device is available, False if unavailable. |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
waitForDeviceBootloader
public abstract void waitForDeviceBootloader ()
Blocks until device is visible via fastboot. Use default timeout.
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
waitForDeviceInRecovery
public abstract boolean waitForDeviceInRecovery (long waitTime)
Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery
).
Параметры | |
---|---|
waitTime | long : the time in ms to wait |
Возвращает | |
---|---|
boolean | true if device boots into recovery before time expires. false otherwise |
waitForDeviceInSideload
public abstract boolean waitForDeviceInSideload (long waitTime)
Blocks for the device to be in the 'adb sideload' state
Параметры | |
---|---|
waitTime | long : the time in ms to wait |
Возвращает | |
---|---|
boolean | true if device boots into sideload before time expires. false otherwise |
waitForDeviceNotAvailable
public abstract boolean waitForDeviceNotAvailable (long waitTime)
Blocks for the device to be not available ie missing from adb
Параметры | |
---|---|
waitTime | long : the time in ms to wait |
Возвращает | |
---|---|
boolean | true if device becomes not available before time expires. false otherwise |
waitForDeviceOnline
public abstract void waitForDeviceOnline ()
Blocks until device is visible via adb. Uses default timeout
Note the device may not necessarily be responsive to commands on completion. UsewaitForDeviceAvailable()
instead.Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
waitForDeviceOnline
public abstract void waitForDeviceOnline (long waitTime)
Blocks until device is visible via adb.
Note the device may not necessarily be responsive to commands on completion. UsewaitForDeviceAvailable()
instead.Параметры | |
---|---|
waitTime | long : the time in ms to wait |
Броски | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
waitForDeviceShell
public abstract boolean waitForDeviceShell (long waitTime)
Waits for device to be responsive to a basic adb shell command.
Параметры | |
---|---|
waitTime | long : the time in ms to wait |
Возвращает | |
---|---|
boolean | true if device becomes responsive before waitTime elapses. |