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 void | deleteFile (String deviceFilePath, int userId) Вспомогательный метод для удаления файла или каталога на устройстве. |
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 в случае внутренней ошибки. |
default String | getTrackingSerial () Для управления устройством получите серийный номер, используемый для отслеживания устройства. |
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 boolean | pullDir (String deviceFilePath, File localDir, int userId) Рекурсивно извлекать содержимое каталога с устройства. |
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, int userId) Рекурсивно отправлять содержимое каталога на устройство. |
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 | pushFile (File localFile, String deviceFilePath, int userId) Отправьте файл на устройство. |
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 | setTrackingSerial (String trackingSerial) В целях управления устройствами отслеживайте серийный номер, который мы используем для ссылки на устройство. |
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 |
удалить файл
public abstract void deleteFile (String deviceFilePath, int userId)
Вспомогательный метод для удаления файла или каталога на устройстве.
Параметры | |
---|---|
deviceFilePath | String : абсолютный путь к файлу на устройстве. |
userId | int : идентификатор пользователя, из которого нужно удалить |
Броски | |
---|---|
| 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 ()
Возвращает в последний раз, когда Tradefed API запускал перезагрузку в миллисекундах с момента Epoch, которая была возвращена System.currentTimeMillis()
.
Возврат | |
---|---|
long |
getlaunchapilevel
public abstract int getLaunchApiLevel ()
Получите первый запуск устройства API -уровень. По умолчанию в UNKNOWN_API_LEVEL
.
Возврат | |
---|---|
int | целое число, указывающее на первый запуск уровня устройства API |
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
getlogcat
public abstract InputStreamSource getLogcat ()
Захватывает потоки снимков данных LogCat.
Работает в двух режимах:
TestDeviceOptions.getMaxLogcatDataSize()
Байты текущего содержимого фонового захвата logCatВозврат | |
---|---|
InputStreamSource |
getlogcat
public abstract InputStreamSource getLogcat (int maxBytes)
Получает потоки снимков последних maxBytes
захваченных данных logcat.
Полезно для случаев, когда вы хотите сделать частые снимки полученных данных LogCat, не подвергаясь потенциально большому наказанию на дисковое пространство, получая весь снимки getLogcat()
.
Параметры | |
---|---|
maxBytes | int : максимальное количество данных для возврата. Должно быть количество, которое может удобно вписаться в память |
Возврат | |
---|---|
InputStreamSource |
getlogcatdump
public abstract InputStreamSource getLogcatDump ()
Получите дамп текущего logcat для устройства. В отличие от 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
, соответствующую указанному пути MountPoint, или 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 : строка имени Proces. |
Возврат | |
---|---|
ProcessInfo | ProcessInfo данного имени процесса |
Броски | |
---|---|
DeviceNotAvailableException |
GetProcessPid
public abstract String getProcessPid (String process)
Возвращает пид Сервиса или NULL, если что -то пошло не так.
Параметры | |
---|---|
process | String : строка имени Proces. |
Возврат | |
---|---|
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 | Текущий режим восстановления, используемый для устройства. |
GetSerialNumber
public abstract String getSerialNumber ()
Удобный метод, чтобы получить серийный номер этого устройства.
Возврат | |
---|---|
String | серийный номер String |
GetTombstones
public abstractgetTombstones ()
Принесите и верните список надгробий с устройств. Требуется корень.
Метод наиболее эффективен, поэтому, если один надгробный камень не может быть привлечен по любой причине, он будет отсутствовать в списке. Только DeviceNotAvailableException
завершит метод рано.
Возврат | |
---|---|
Список файлов надгробных плитов, пустые, если нет надгробия. |
Броски | |
---|---|
DeviceNotAvailableException |
См. также:
GettotalMemory
public abstract long getTotalMemory ()
Возвращает общий размер физической памяти в байтах или -1 в случае внутренней ошибки
Возврат | |
---|---|
long |
GetTrackingSerial
public String getTrackingSerial ()
Для цели управления устройствами используйте последовательность для отслеживания устройства.
Возврат | |
---|---|
String |
getusefastbooterase
public abstract boolean getUseFastbootErase ()
Получите, использовать ли Fastboot Erase или Fastboot Format, чтобы вытирать раздел на устройстве.
Возврат | |
---|---|
boolean | true , если будет использоваться Fastboot Erase или false , если будет использоваться формат Fastboot. |
См. также:
Исадбрут
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 | Верно, если поддержано перечисление приложений, в противном случае неверно |
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
isbypasslowtargetsdkblocksupported
public abstract boolean isBypassLowTargetSdkBlockSupported ()
Проверьте, поддерживает ли платформа на устройстве обход низкого целевого блока SDK в установке приложения
Возврат | |
---|---|
boolean | Верно, если поддерживается обходной блок SDK с низким целевым |
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
isdebugfsmounted
public abstract boolean isDebugfsMounted ()
Проверьте, устанавливаются ли отладки.
Возврат | |
---|---|
boolean | true , если отладки установлены |
Броски | |
---|---|
| 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 |
ISENCRYPTIONSUPPODED
public abstract boolean isEncryptionSupported ()
Возвращает, если на устройстве поддерживается шифрование.
Возврат | |
---|---|
boolean | true , если устройство поддерживает шифрование. |
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
Испытательный
public abstract boolean isExecutable (String fullPath)
Возвращает true, если путь файла на устройстве является исполняемым файлом, False в противном случае.
Параметры | |
---|---|
fullPath | String |
Возврат | |
---|---|
boolean |
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
это безгона
public abstract boolean isHeadless ()
Верните True, если устройство без головы (без экрана), false в противном случае.
Возврат | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
isruntimepermissionsupported
public abstract boolean isRuntimePermissionSupported ()
Проверьте, поддерживает ли платформа на устройстве предоставление разрешений на выполнение
Возврат | |
---|---|
boolean | Верно, если разрешение на выполнение поддерживается, в противном случае неверно. |
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
ISSTATEBOUTORORORFASTBOOTD
public abstract boolean isStateBootloaderOrFastbootd ()
Возвращает True, если устройство находится в TestDeviceState#FASTBOOT
или TestDeviceState.FASTBOOTD
.
Возврат | |
---|---|
boolean |
Loganrs
public abstract boolean logAnrs (ITestLogger logger)
Собирает и регистрирует ANR с устройства.
Параметры | |
---|---|
logger | ITestLogger : ITestLogger для регистрации ANR. |
Возврат | |
---|---|
boolean | Правда, если журнал был успешным, в противном случае ложь. |
Броски | |
---|---|
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 : ARG, которые должны быть заменены через string.format (). |
Mountdebugfs
public abstract void mountDebugfs ()
Mount Debugfs.
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
Неблокировка
public abstract void nonBlockingReboot ()
Выпускает команду для перезагрузки устройства и возвращается по команде, и когда устройство больше не видно для ADB.
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
postbootsetup
public abstract void postBootSetup ()
Выполните инструкции по настройке устройства для тестирования его после каждой загрузки.
Следует вызвать после того, как устройство полностью загружается/доступно В обычных обстоятельствах этот метод не должен быть явно называется, так как реализации должны выполнять эти шаги автоматически при выполнении перезагрузки. Если это может потребоваться, когда устройства перезагружаются из -за других событий (например, когда завершена команда Fastboot Update)Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
PostInvocationTeardown
public void postInvocationTearDown ()
Этот метод устарел.
Вместо этого используйте postInvocationTearDown(Throwable)
.
Дополнительные шаги для конкретного устройства требуемой очистки, которые будут выполнены после выполнения вызова.
PostInvocationTeardown
public abstract void postInvocationTearDown (Throwable invocationException)
Дополнительные шаги для конкретного устройства требуемой очистки, которые будут выполнены после выполнения вызова.
Параметры | |
---|---|
invocationException | Throwable : если таковые имеются, окончательное исключение, поднятое сбоем вызова. |
PreinvocationSetup
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 |
Пульдир
public abstract boolean pullDir (String deviceFilePath, File localDir)
Рекурсивно вытащить содержимое каталога с устройства.
Параметры | |
---|---|
deviceFilePath | String : абсолютный путь файла удаленного источника |
localDir | File : локальный каталог, чтобы втянуть файлы в |
Возврат | |
---|---|
boolean | true , если файл был успешно вытянут. false иначе. |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
Пульдир
public abstract boolean pullDir (String deviceFilePath, File localDir, int userId)
Рекурсивно вытащить содержимое каталога с устройства.
Параметры | |
---|---|
deviceFilePath | String : абсолютный путь файла удаленного источника |
localDir | File : локальный каталог, чтобы втянуть файлы в |
userId | int : идентификатор пользователя, чтобы вытащить из |
Возврат | |
---|---|
boolean | true , если файл был успешно вытянут. false иначе. |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
Pullfile
public abstract File pullFile (String remoteFilePath, int userId)
Извлекает файл с устройства, хранит его во временной ERROR(/File)
и возвращает этот File
.
Параметры | |
---|---|
remoteFilePath | String : абсолютный путь к файлу на устройстве. |
userId | int : идентификатор пользователя, чтобы вытащить из |
Возврат | |
---|---|
File | ERROR(/File) , содержащая содержимое файла устройства, или null если копия не удалась по любой причине (включая проблемы с файловой системой хоста) |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
Pullfile
public abstract File pullFile (String remoteFilePath)
Извлекает файл с устройства, хранит его во временной ERROR(/File)
и возвращает этот File
.
Параметры | |
---|---|
remoteFilePath | String : абсолютный путь к файлу на устройстве. |
Возврат | |
---|---|
File | ERROR(/File) , содержащая содержимое файла устройства, или null если копия не удалась по любой причине (включая проблемы с файловой системой хоста) |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
Pullfile
public abstract boolean pullFile (String remoteFilePath, File localFile)
Получает файл с устройства.
Параметры | |
---|---|
remoteFilePath | String : абсолютный путь к файлу на устройстве. |
localFile | File : локальный файл для хранения содержимого. Если не пустое, содержимое будет заменено. |
Возврат | |
---|---|
boolean | true , если файл был успешно получен. false иначе. |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
Pullfile
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 |
PullfileFromexternal
public abstract File pullFileFromExternal (String remoteFilePath)
Удобный метод для извлечения файла из внешнего хранилища устройства, хранит его в локальной временной ERROR(/File)
и возврата ссылки на этот File
.
Параметры | |
---|---|
remoteFilePath | String : Путь к файлу на устройстве, по сравнению с точкой крепления устройства. |
Возврат | |
---|---|
File | ERROR(/File) , содержащая содержимое файла устройства, или null если копия не удалась по любой причине (включая проблемы с файловой системой хоста) |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
Пушдир
public abstract boolean pushDir (File localDir, String deviceFilePath, int userId)
Рекурсивно толкайте содержимое каталога на устройство.
Параметры | |
---|---|
localDir | File : локальный каталог, чтобы натолкнуться |
deviceFilePath | String : абсолютный путь файла удаленного назначения |
userId | int : идентификатор пользователя, чтобы подтолкнуть к |
Возврат | |
---|---|
boolean | true , если файл был успешно натолкнут. false иначе. |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
Пушдир
public abstract boolean pushDir (File localDir, String deviceFilePath,excludedDirectories)
Рекурсивно толкайте содержимое каталога на устройство, исключая некоторые каталоги, которые отфильтрованы.
Параметры | |
---|---|
localDir | File : локальный каталог, чтобы натолкнуться |
deviceFilePath | String : абсолютный путь файла удаленного назначения |
excludedDirectories |
Возврат | |
---|---|
boolean | true , если файл был успешно натолкнут. false иначе. |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
Пушдир
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 | Если соединение с устройством потеряно и не может быть восстановлено. |
pushfile
public abstract boolean pushFile (File localFile, String deviceFilePath, int userId)
Нажмите файл на устройство. По умолчанию с помощью поставщика контента.
Параметры | |
---|---|
localFile | File : локальный файл для нажатия |
deviceFilePath | String : Абсолютный путь удаленного назначения |
userId | int : пользовательский ирод, чтобы подтолкнуть к |
Возврат | |
---|---|
boolean | true , если файл был успешно натолкнут. false иначе. |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
подталкивание
public abstract boolean pushString (String contents, String deviceFilePath)
Push -файл, созданный из строки к устройству
Параметры | |
---|---|
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
Propety.
Параметры | |
---|---|
reason | String : причина этой перезагрузки, или null , если не указана причина. |
Броски | |
---|---|
DeviceNotAvailableException | Если устройство не доступно после перезагрузки |
перезагрузчик загрузчика
public abstract void rebootIntoBootloader ()
Перезагружает устройство в режим загрузчика.
Блоки до тех пор, пока устройство не будет в режиме загрузчика.Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
RebootIntOfastBootd
public abstract void rebootIntoFastbootd ()
Перезагружает устройство в режим FastBootd.
Блоки до тех пор, пока устройство не будет в режиме FastBootd.
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
RebootIntoreCovery
public abstract void rebootIntoRecovery ()
Перезагружает устройство в режим восстановления ADB.
Блоки до тех пор, пока устройство не войдет в восстановлениеБроски | |
---|---|
DeviceNotAvailableException | Если устройство не доступно после перезагрузки |
Перезагрузка
public abstract void rebootIntoSideload (boolean autoReboot)
Перезагружает устройство в режим боковой нагрузки ADB (обратите внимание, что это специальный режим под восстановлением)
Блоки до тех пор, пока устройство не войдет в режим нагрузки
Параметры | |
---|---|
autoReboot | boolean : автоматически перезагрузить устройство после боковой загрузки |
Броски | |
---|---|
DeviceNotAvailableException | Если устройство не находится в боковой загрузке после перезагрузки |
Перезагрузка
public abstract void rebootIntoSideload ()
Перезагружает устройство в режим боковой нагрузки ADB (обратите внимание, что это специальный режим под восстановлением)
Блоки до тех пор, пока устройство не войдет в режим нагрузки
Броски | |
---|---|
DeviceNotAvailableException | Если устройство не находится в боковой загрузке после перезагрузки |
Rebootuntilonline
public abstract void rebootUntilOnline ()
Альтернативная для reboot()
, которая блокирует только до тех пор, пока устройство не станет онлайн, т.е. видно для ADB.
Броски | |
---|---|
DeviceNotAvailableException | Если устройство не доступно после перезагрузки |
Rebootuntilonline
public abstract void rebootUntilOnline (String reason)
Альтернативная для reboot()
, которая блокирует только до тех пор, пока устройство не станет онлайн, т.е. видно для ADB.
Параметры | |
---|---|
reason | String : причина этой перезагрузки, или null , если не указана причина. |
Броски | |
---|---|
DeviceNotAvailableException | Если устройство не доступно после перезагрузки |
См. также:
Rebootuserspace
public abstract void rebootUserspace ()
Перезагружает только пользовательскую часть устройства.
Блоки до тех пор, пока устройство не станет доступным.
ПРЕДУПРЕЖДЕНИЕ. Пользовательская перезагрузка в настоящее время находится в активной разработке, используйте ее на собственном риске.
Броски | |
---|---|
DeviceNotAvailableException | Если устройство не доступно после перезагрузки |
Rebootuserspaceuntilonline
public abstract void rebootUserspaceUntilOnline ()
Альтернатива для rebootUserspace()
()}, который блокирует только до тех пор, пока устройство не станет онлайн, то есть видимо для ADB.
Броски | |
---|---|
DeviceNotAvailableException | Если устройство не доступно после перезагрузки |
remutSystemreadonly
public abstract void remountSystemReadOnly ()
Сделайте системный раздел на устройстве только для чтения. Может перезагрузить устройство.
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
retroundyStemwrable
public abstract void remountSystemWritable ()
Сделайте системный раздел на устройстве, чтобы записаться. Может перезагрузить устройство.
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
remountvendorreadonly
public abstract void remountVendorReadOnly ()
Сделайте раздел поставщика на устройстве только для чтения. Может перезагрузить устройство.
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
RemountVendorWrable
public abstract void remountVendorWritable ()
Сделайте раздел поставщика на устройстве, чтобы записаться на записи. Может перезагрузить устройство.
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
Runinstrumentationtests
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 | Если соединение с устройством потеряно и не может быть восстановлено. Тестная команда т. Д. Не удалось завершить, а восстановление не удалось. |
Runinstrumentationtests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Запускает испытания наборов и обеспечивает восстановление устройства.
Если соединение с устройством будет проиграно до завершения тестового запуска, а восстановление достигнет успеха, все слушатели будут информированы о TestRunfailled, и будет возвращено «false». Тестовая команда не будет повторно. При необходимости абоненты остаются, чтобы повторно повторить.
Если соединение с устройством будет проиграно до завершения тестового запуска, а восстановление не удается, все слушатели будут информированы о TestRunfailled, а DeviceNotavailableException будет брошено.
Параметры | |
---|---|
runner | IRemoteAndroidTestRunner : IRemoteAndroidTestRunner , который запускает тесты |
listeners |
Возврат | |
---|---|
boolean | true , если тестовая команда завершена. false если ему не удалось заполнить из -за исключения связи устройства, но восстановление преуспело |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. Тестная команда т. Д. Не удалось завершить, а восстановление не удалось. |
Runinstrumentationtestsasuser
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 |
Runinstrumentationtestsasuser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
То же самое, что и ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
но запускает тест для данного пользователя.
Параметры | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
Возврат | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
SetDate
public abstract void setDate (Date date)
Устанавливает дату на устройстве
Примечание: дата установки на устройстве требует корнета
Параметры | |
---|---|
date | Date : укажите определенную дату; будет использовать дату хоста null если |
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
Setoptions
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 была успешной, иначе ложна. |
Броски | |
---|---|
| 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 : будь то «восстановить только до онлайн -режим», должен быть в режиме или нет. |
SettrackingSerial
public abstract void setTrackingSerial (String trackingSerial)
Для целей управления устройствами отслеживает сериал, который мы используем для ссылки на устройство.
Параметры | |
---|---|
trackingSerial | String |
setuseFastBooterase
public abstract void setUseFastbootErase (boolean useFastbootErase)
Установите, использовать ли Fastboot Erase или Fastboot Format, чтобы вытирать раздел на устройстве.
Параметры | |
---|---|
useFastbootErase | boolean : true , если следует использовать Fastboot Erase или false , если следует использовать формат Fastboot. |
См. также:
startLogcat
public abstract void startLogcat ()
Начните снимать выход LogCat с устройства в фоновом режиме.
Не будет иметь никакого эффекта, если выход LogCat уже будет запечатлен. Данные могут быть получены позже через getLogcat. Когда устройство больше не используется, должен быть вызванstopLogcat()
. startLogcat()
и stopLogcat()
обычно не нужно вызывать в контексте вызова TF, так как структура TF запустится и останавливает LogCat. StopeMulatorOutput
public abstract void stopEmulatorOutput ()
Закройте и удалите выход эмулятора.
stoplogcat
public abstract void stopLogcat ()
Прекратите захватить выход LogCat с устройства и отбросить в настоящее время сохраняемые данные LogCat.
Не будет иметь никакого эффекта, если вывод LogCat не будет захвачен.SwitchToadBtcp
public abstract String switchToAdbTcp ()
Переключить устройство в режим ADB-Over-TCP.
Возврат | |
---|---|
String | Серийный номер TCP или null , если устройство не может быть переключено |
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
SwitchToadBusb
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") создаст каталог A/sdcard/files, если он еще не существует, и повторно нажимайте содержимое/tmp/files в/sdcard/files.Параметры | |
---|---|
localFileDir | File : локальный каталог файлов, содержащий файлы для рекурсивного нажимания. |
deviceFilePath | String : Удаленный путь абсолютного пути файла. Все каталоги в пути файла THOS должны быть читаемыми. т.е. нажатие на/data/local/tmp, когда ADB не является корнем. |
Возврат | |
---|---|
boolean | true , если файлы были успешно синхронизированы. false иначе. |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
разблокировать
public abstract boolean unlockDevice ()
Разблокирует устройство, если устройство находится в зашифрованном состоянии.
Этот метод может перезагрузить структуру, но не будет вызоватьpostBootSetup()
. Следовательно, устройство может не быть полностью готовым для тестирования при возвращении этого метода.Возврат | |
---|---|
boolean | true , если успешно или если устройство не затрачено. |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
UnsupportedOperationException | Если шифрование не поддерживается на устройстве. |
Unmountdebugfs
public abstract void unmountDebugfs ()
Unmount Debugfs.
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
waitforbootcomplete
public abstract boolean waitForBootComplete (long timeOut)
Блоки до тех пор, пока не будет установлен полный флаг загрузки устройства.
Параметры | |
---|---|
timeOut | long : время в MSECS, чтобы дождаться установки флага |
Возврат | |
---|---|
boolean | true, если полный флаг загрузки устройства установлен в тайм -аут |
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
waitfordeviceaVailable
public abstract boolean waitForDeviceAvailable ()
Ожидает, что устройство будет отзывчивым и доступным для тестирования. Использует тайм -аут по умолчанию.
Возврат | |
---|---|
boolean | Верно, если устройство доступно, False, если восстановление отключено и недоступно. |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
waitfordeviceaVailable
public abstract boolean waitForDeviceAvailable (long waitTime)
Ожидает, что устройство будет отзывчивым и доступным для тестирования.
Параметры | |
---|---|
waitTime | long : время в MS, чтобы подождать |
Возврат | |
---|---|
boolean | Верно, если устройство доступно, False, если восстановление отключено и недоступно. |
Броски | |
---|---|
DeviceNotAvailableException | Если устройство все еще не отвечает после истечения срока ожидания. |
waitfordeviceavailableinrecoverpath
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Ожидает, что устройство будет отзывчивым и доступным без учета пути восстановления.
Параметры | |
---|---|
waitTime | long |
Возврат | |
---|---|
boolean | Верно, если устройство доступно, ложно, если недоступно. |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
waitfordevicebootloader
public abstract void waitForDeviceBootloader ()
Блоки до тех пор, пока устройство не будет видно через Fastboot. Используйте тайм -аут по умолчанию.
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
waitfordeviceinrecovery
public abstract boolean waitForDeviceInRecovery (long waitTime)
Блоки для устройства должны быть в состоянии «ADB восстановления» (обратите внимание, что это отличается от IDeviceRecovery
).
Параметры | |
---|---|
waitTime | long : время в MS, чтобы подождать |
Возврат | |
---|---|
boolean | true , если устройство загружается в восстановление, прежде чем время истекает. false иначе |
waitfordeviceinsideload
public abstract boolean waitForDeviceInSideload (long waitTime)
Блоки для устройства быть в состоянии «ADB SideLoad»
Параметры | |
---|---|
waitTime | long : время в MS, чтобы подождать |
Возврат | |
---|---|
boolean | true , если устройство сапится в боковую нагрузку, прежде чем время истекает. false иначе |
waitfordevicenotavailable
public abstract boolean waitForDeviceNotAvailable (long waitTime)
Блоки для устройства не доступны, т.е. отсутствует в ADB
Параметры | |
---|---|
waitTime | long : время в MS, чтобы подождать |
Возврат | |
---|---|
boolean | true , если устройство становится недоступным, прежде чем истекать время. false иначе |
Waitfordeviceonline
public abstract void waitForDeviceOnline ()
Блоки до тех пор, пока устройство не будет видно через ADB. Использует тайм -аут по умолчанию
Обратите внимание, что устройство не обязательно может быть отзывчивым на команды по завершению. Вместо этого используйтеwaitForDeviceAvailable()
.Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
Waitfordeviceonline
public abstract void waitForDeviceOnline (long waitTime)
Блоки до тех пор, пока устройство не будет видно через ADB.
Обратите внимание, что устройство не обязательно может быть отзывчивым на команды по завершению. Вместо этого используйтеwaitForDeviceAvailable()
.Параметры | |
---|---|
waitTime | long : время в MS, чтобы подождать |
Броски | |
---|---|
DeviceNotAvailableException | Если соединение с устройством потеряно и не может быть восстановлено. |
WaitfordeviceShell
public abstract boolean waitForDeviceShell (long waitTime)
Ожидает, что устройство будет отзывчивым на базовую команду ADB Shell.
Параметры | |
---|---|
waitTime | long : время в MS, чтобы подождать |
Возврат | |
---|---|
boolean | true , если устройство становится отзывчивым до того, как пройдет waitTime . |