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 |
abstract boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) Вспомогательный метод для проверки того, был ли выполнен программный перезапуск устройства с момента времени UTC, начиная с эпохи устройства и его |
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 и возвращает выходные данные в виде |
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 () Получите дамп текущего логарифма устройства. |
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 службы или значение 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, если устройство находится в |
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 () Этот метод устарел. Вместо этого используйте |
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 (обратите внимание, что это специальный режим в режиме восстановления) Блокируется до тех пор, пока устройство не перейдет в режим неопубликованной загрузки. |
abstract void | rebootIntoSideload () Перезагружает устройство в режим боковой загрузки adb (обратите внимание, что это специальный режим в режиме восстановления) Блокируется до тех пор, пока устройство не перейдет в режим неопубликованной загрузки. |
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 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» (обратите внимание, что это отличается от |
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 | |
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 abstractgetBootHistory ()
Вспомогательный метод собирает карту истории загрузки со временем загрузки и причиной загрузки.
Возврат | |
---|---|
Карта времени загрузки (время UTC в секундах с начала эпохи) и причина загрузки |
Броски | |
---|---|
DeviceNotAvailableException |
getBootHistorySince
public abstractgetBootHistorySince (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()
текущего содержимого фонового захвата логарифмического кота.Возврат | |
---|---|
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 abstractgetMountPointInfo ()
Возвращает проанализированную версию информации в /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 abstractgetTombstones ()
Получите и верните список надгробий с устройств. Требуется рут.
Этот метод является максимально эффективным, поэтому, если одно надгробие по какой-либо причине не удастся извлечь, оно будет отсутствовать в списке. Только исключение 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 . |