INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

Известные косвенные подклассы IManagedTestDevice , ITestDevice , LocalAndroidVirtualDevice , ManagedRemoteDevice , NativeDevice , NestedRemoteDevice , RemoteAndroidDevice , RemoteAndroidVirtualDevice , TestDevice IManagedTestDevice ITestDevice, чей жизненный цикл является управляемым. ITestDevice Предоставляет надежный API немного более высокого уровня для ddmlib IDevice . LocalAndroidVirtualDevice Класс для локальных виртуальных устройств, работающих на хосте TradeFed. Управляемое удаленное устройство Устройство, работающее внутри виртуальной машины, которым мы управляем удаленно через экземпляр Tradefed внутри виртуальной машины. Нативное устройство Реализация ITestDevice по умолчанию для Android-устройств без полного стека. Вложенное удаленное устройство Представление устройства, работающего внутри удаленной виртуальной машины Cuttlefish. RemoteAndroidDevice Реализация ITestDevice для Android-устройства с полным стеком, подключенного через adb connect. RemoteAndroidVirtualDevice Расширяет поведение RemoteAndroidDevice для устройства Android с полным стеком, работающего в Google Compute Engine (Gce). Тестовое устройство Реализация ITestDevice для устройства Android с полным стеком

---

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

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

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

Константы
int	UNKNOWN_API_LEVEL Значение по умолчанию, когда невозможно определить уровень API.

Публичные методы
abstract boolean	checkApiLevelAgainstNextRelease (int strictMinLevel) Проверьте, поддерживается ли функция в настоящее время, учитывая минимальный поддерживаемый уровень.
abstract void	clearLogcat () Удаляет любые накопленные данные logcat.
abstract void	deleteFile (String deviceFilePath) Вспомогательный метод для удаления файла или каталога на устройстве.
abstract boolean	deviceSoftRestarted ( ProcessInfo prevSystemServerProcess) Вспомогательный метод для проверки мягкого перезапуска устройства путем сравнения текущего system_server с предыдущим system_server ProcessInfo .
abstract boolean	deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) Вспомогательный метод для проверки того, было ли устройство мягко перезапущено с момента времени UTC с эпохи с устройства и его ERROR(/TimeUnit) .
abstract boolean	disableAdbRoot () Отключает adb root.
abstract boolean	doesFileExist (String deviceFilePath) Вспомогательный метод, чтобы определить, существует ли файл на устройстве.
abstract boolean	enableAdbRoot () Включает adb root.
abstract String	executeAdbCommand (long timeout, String... commandArgs) Вспомогательный метод, который выполняет команду adb как системную команду с заданным временем ожидания.
abstract String	executeAdbCommand (String... commandArgs) Вспомогательный метод, который выполняет команду adb как системную команду.
abstract String	executeAdbCommand (long timeout, envMap, String... commandArgs) executeAdbCommand (long timeout, envMap, String... commandArgs) Вспомогательный метод, который выполняет команду adb как системную команду с заданным временем ожидания.
abstract CommandResult	executeFastbootCommand (long timeout, String... commandArgs) Вспомогательный метод, который выполняет команду fastboot как системную команду.
abstract CommandResult	executeFastbootCommand (String... commandArgs) Вспомогательный метод, который выполняет команду fastboot как системную команду с таймаутом по умолчанию 2 минуты.
abstract CommandResult	executeLongFastbootCommand (String... commandArgs) Вспомогательный метод, который выполняет длительную команду fastboot как системную команду.
abstract CommandResult	executeLongFastbootCommand ( envVarMap, String... commandArgs) executeLongFastbootCommand ( envVarMap, String... commandArgs) Вспомогательный метод, который выполняет длительную команду fastboot как системную команду с системными переменными среды.
abstract String	executeShellCommand (String command) Вспомогательный метод, который выполняет команду оболочки adb и возвращает выходные данные в виде String .
abstract void	executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды.
abstract void	executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды.
abstract void	executeShellCommand (String command, IShellOutputReceiver receiver) Выполняет указанную команду оболочки adb, повторяя попытку несколько раз, если команда не удалась.
abstract CommandResult	executeShellV2Command (String command) Вспомогательный метод, который выполняет команду оболочки adb и возвращает результаты в виде CommandResult , правильно заполненного выводом состояния команды, stdout и stderr.
abstract CommandResult	executeShellV2Command (String command, OutputStream pipeToOutput) Вспомогательный метод, который выполняет команду оболочки adb и возвращает результаты в виде CommandResult , правильно заполненного выводом состояния команды и stderr.
abstract CommandResult	executeShellV2Command (String command, File pipeAsInput) Вспомогательный метод, который выполняет команду оболочки adb и возвращает результаты в виде CommandResult , правильно заполненного выводом состояния команды, stdout и stderr.
abstract CommandResult	executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды.
abstract CommandResult	executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды.
abstract CommandResult	executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды.
abstract CommandResult	executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды.
abstract CommandResult	fastbootWipePartition (String partition) Вспомогательный метод, который очищает раздел устройства.
abstract int	getApiLevel () Получите уровень API устройства.
abstract String	getBasebandVersion () Удобный способ получить версию этого устройства для основной полосы частот (радио).
abstract Integer	getBattery () Возвращает текущий уровень заряда батареи устройства или Null, если уровень заряда батареи недоступен.
abstract boolean	getBooleanProperty (String name, boolean defaultValue) Возвращает логическое значение данного свойства.
abstract	getBootHistory () Вспомогательный метод собирает карту истории загрузки с указанием времени загрузки и причины загрузки.
abstract	getBootHistorySince (long utcEpochTime, TimeUnit timeUnit) Вспомогательный метод собирает карту истории загрузки с указанием времени загрузки и причины загрузки с заданного времени с начала эпохи с устройства и указанной единицы времени.
abstract String	getBootloaderVersion () Удобный способ получить версию загрузчика этого устройства.
abstract String	getBuildAlias () Получите псевдоним сборки, которая в данный момент работает на устройстве.
abstract String	getBuildFlavor () Получите вариант сборки для устройства.
abstract String	getBuildId () Получите сборку, на которой в данный момент работает устройство.
abstract String	getBuildSigningKeys () Возвращает тип ключа, используемый для подписи образа устройства. Обычно устройства Android могут быть подписаны тестовыми ключами (например, в AOSP) или ключами выпуска (контролируются отдельными производителями устройств).
abstract DeviceDescriptor	getCachedDeviceDescriptor () Возвращает кэшированный DeviceDescriptor если устройство выделено, в противном случае возвращает текущий DeviceDescriptor .
abstract DeviceDescriptor	getCachedDeviceDescriptor (boolean shortDescriptor) Возвращает кэшированный DeviceDescriptor если устройство выделено, в противном случае возвращает текущий DeviceDescriptor .
abstract String[]	getChildren (String deviceFilePath) Альтернатива использованию IFileEntry , которая иногда не работает из-за разрешений.
abstract AbstractConnection	getConnection () Возвращает соединение, связанное с устройством.
abstract String	getDeviceClass () Получите класс устройства.
abstract long	getDeviceDate () Возвращает дату устройства в миллисекундах с начала эпохи.
abstract DeviceDescriptor	getDeviceDescriptor () Верните DeviceDescriptor из информации об устройстве, чтобы получить информацию о нем без передачи фактического объекта устройства.
abstract DeviceDescriptor	getDeviceDescriptor (boolean shortDescriptor) Верните DeviceDescriptor из информации об устройстве, чтобы получить информацию о нем без передачи фактического объекта устройства.
abstract TestDeviceState	getDeviceState () Получить состояние устройства.
abstract long	getDeviceTimeOffset (Date date) Помощник для получения разницы во времени между устройством и данной ERROR(/Date) .
abstract InputStreamSource	getEmulatorOutput () Получить поток эмулятора stdout и stderr
abstract long	getExternalStoreFreeSpace () Вспомогательный метод для определения объема свободного места во внешнем хранилище устройства.
abstract String	getFastbootProductType () Удобный метод получения типа продукта этого устройства, когда оно находится в режиме быстрой загрузки.
abstract String	getFastbootProductVariant () Удобный метод получения типа продукта этого устройства, когда оно находится в режиме быстрой загрузки.
abstract String	getFastbootSerialNumber () Возвращает серийный номер режима быстрой загрузки.
abstract String	getFastbootVariable (String variableName) Получите заданное значение переменной fastboot с устройства.
abstract IFileEntry	getFileEntry (String path) Получить ссылку на удаленный файл на устройстве.
abstract IDevice	getIDevice () Возвращает ссылку на связанный IDevice ddmlib.
abstract long	getIntProperty (String name, long defaultValue) Возвращает целочисленное значение данного свойства с устройства.
abstract long	getLastExpectedRebootTimeMillis () Возвращает последний раз, когда API-интерфейсы Tradefed инициировали перезагрузку в миллисекундах с момента EPOCH, возвращаемого System.currentTimeMillis() .
abstract int	getLaunchApiLevel () Получите первый запущенный уровень API устройства.
abstract InputStreamSource	getLogcat () Захватывает поток моментальных снимков данных logcat.
abstract InputStreamSource	getLogcat (int maxBytes) Захватывает поток моментальных снимков последних maxBytes захваченных данных logcat.
abstract InputStreamSource	getLogcatDump () Получите дамп текущего logcat для устройства.
abstract InputStreamSource	getLogcatSince (long date) Захватывает поток моментальных снимков захваченных данных logcat, начиная с указанной даты.
abstract String	getMountPoint (String mountName) Возвращает точку монтирования.
abstract ITestDevice.MountPointInfo	getMountPointInfo (String mountpoint) Возвращает MountPointInfo соответствующий указанному пути точки монтирования, или null если этот путь ничего не монтировал или иначе не отображается в /proc/mounts в качестве точки монтирования.
abstract	getMountPointInfo () Возвращает проанализированную версию информации в /proc/mounts на устройстве.
abstract long	getPartitionFreeSpace (String partition) Вспомогательный метод для определения количества свободного места в разделе устройства.
abstract ProcessInfo	getProcessByName (String processName) Вспомогательный метод запускает команды «pidof» и «stat» и возвращает объект ProcessInfo с PID и временем запуска данного процесса.
abstract String	getProcessPid (String process) Возвращает pid службы или ноль, если что-то пошло не так.
abstract String	getProductType () Удобный способ получить тип продукта этого устройства.
abstract String	getProductVariant () Удобный способ получить вариант продукта этого устройства.
abstract String	getProperty (String name) Получить заданное значение свойства с устройства.
abstract ITestDevice.RecoveryMode	getRecoveryMode () Получите текущий режим восстановления, используемый для устройства.
abstract String	getSerialNumber () Удобный способ получить серийный номер этого устройства.
abstract	getTombstones () Получить и вернуть список надгробий с устройств.
abstract long	getTotalMemory () Возвращает общий размер физической памяти в байтах или -1 в случае внутренней ошибки.
abstract boolean	getUseFastbootErase () Узнайте, следует ли использовать стирание fastboot или формат fastboot для очистки раздела на устройстве.
abstract boolean	isAdbRoot ()
abstract boolean	isAdbTcp ()
abstract boolean	isAppEnumerationSupported () Проверьте, поддерживает ли платформа на устройстве перечисление приложений.
abstract boolean	isBypassLowTargetSdkBlockSupported () Проверьте, поддерживает ли платформа на устройстве обход нижнего целевого блока SDK при установке приложения.
abstract boolean	isDeviceEncrypted () Возвращает, если устройство зашифровано.
abstract boolean	isDirectory (String deviceFilePath) Верните True, если путь на устройстве является каталогом, в противном случае — false.
abstract boolean	isEncryptionSupported () Возвращает, если шифрование поддерживается на устройстве.
abstract boolean	isExecutable (String fullPath) Возвращает True, если путь к файлу на устройстве является исполняемым файлом, в противном случае — false.
abstract boolean	isHeadless () Верните true, если устройство безголовое (без экрана), в противном случае — false.
abstract boolean	isRuntimePermissionSupported () Проверьте, поддерживает ли платформа на устройстве предоставление разрешений во время выполнения.
abstract boolean	isStateBootloaderOrFastbootd () Возвращает true, если устройство находится в TestDeviceState#FASTBOOT или TestDeviceState.FASTBOOTD .
abstract boolean	logAnrs ( ITestLogger logger) Собирает и регистрирует ANR с устройства.
abstract void	logOnDevice (String tag, Log.LogLevel level, String format, Object... args) Запишите сообщение в logcat устройства.
abstract void	nonBlockingReboot () Выдает команду для перезагрузки устройства и возвращается после завершения команды и когда устройство больше не отображается для adb.
abstract void	postBootSetup () Выполните инструкции по настройке устройства для тестирования после каждой загрузки.
default void	postInvocationTearDown () Этот метод устарел. Вместо этого используйте postInvocationTearDown(Throwable) .
abstract void	postInvocationTearDown (Throwable invocationException) Дополнительные шаги для требуемой очистки устройства, которые будут выполнены после выполнения вызова.
default void	preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes) Дополнительные шаги для требуемой настройки конкретного устройства, которые будут выполняться на устройстве перед потоком вызова.
abstract boolean	pullDir (String deviceFilePath, File localDir) Рекурсивно извлекать содержимое каталога с устройства.
abstract File	pullFile (String remoteFilePath, int userId) Извлекает файл с устройства, сохраняет его в локальной временной ERROR(/File) и возвращает этот File .
abstract File	pullFile (String remoteFilePath) Извлекает файл с устройства, сохраняет его в локальной временной ERROR(/File) и возвращает этот File .
abstract boolean	pullFile (String remoteFilePath, File localFile) Извлекает файл с устройства.
abstract boolean	pullFile (String remoteFilePath, File localFile, int userId) Извлекает файл с устройства.
abstract String	pullFileContents (String remoteFilePath) Извлекает файл с устройства и возвращает содержимое.
abstract File	pullFileFromExternal (String remoteFilePath) Удобный метод извлечения файла из внешнего хранилища устройства, сохранения его в локальной временной ERROR(/File) и возврата ссылки на этот File .
abstract boolean	pushDir (File localDir, String deviceFilePath, excludedDirectories) pushDir (File localDir, String deviceFilePath, excludedDirectories) Рекурсивно передавать содержимое каталога на устройство, исключая некоторые фильтруемые каталоги.
abstract boolean	pushDir (File localDir, String deviceFilePath) Рекурсивно передавать содержимое каталога на устройство.
abstract boolean	pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded) Вариант pushFile(File, String) , который может дополнительно учитывать необходимость оценки поставщика содержимого.
abstract boolean	pushFile (File localFile, String deviceFilePath) Отправьте файл на устройство.
abstract boolean	pushString (String contents, String deviceFilePath) Отправить файл, созданный из строки, на устройство
abstract void	reboot () Перезагружает устройство в режим adb.
abstract void	reboot (String reason) Перезагружает устройство в режим adb с заданной reason , которая сохраняется при перезагрузке.
abstract void	rebootIntoBootloader () Перезагружает устройство в режим загрузчика.
abstract void	rebootIntoFastbootd () Перезагружает устройство в режим fastbootd.
abstract void	rebootIntoRecovery () Перезагружает устройство в режим восстановления adb.
abstract void	rebootIntoSideload (boolean autoReboot) Перезагружает устройство в режим adb sideload (обратите внимание, что это специальный режим восстановления) Блокирует до тех пор, пока устройство не перейдет в режим боковой загрузки
abstract void	rebootIntoSideload () Перезагружает устройство в режим adb sideload (обратите внимание, что это специальный режим восстановления) Блокирует до тех пор, пока устройство не перейдет в режим боковой загрузки
abstract void	rebootUntilOnline () Альтернатива reboot() , которая блокируется только до тех пор, пока устройство не будет подключено к сети, то есть не будет видно adb.
abstract void	rebootUntilOnline (String reason) Альтернатива reboot() , которая блокируется только до тех пор, пока устройство не будет подключено к сети, то есть не будет видно adb.
abstract void	rebootUserspace () Перезагружает только пользовательскую часть устройства.
abstract void	rebootUserspaceUntilOnline () Альтернатива rebootUserspace() ()}, которая блокируется только до тех пор, пока устройство не будет подключено к сети, то есть не будет видно для adb.
abstract void	remountSystemReadOnly () Сделайте системный раздел на устройстве доступным только для чтения.
abstract void	remountSystemWritable () Сделайте системный раздел на устройстве доступным для записи.
abstract void	remountVendorReadOnly () Сделайте раздел поставщика на устройстве доступным только для чтения.
abstract void	remountVendorWritable () Сделайте раздел поставщика на устройстве доступным для записи.
abstract boolean	runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) Удобный метод для выполнения ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) с одним или несколькими прослушивателями, переданными в качестве параметров.
abstract boolean	runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) Выполняет инструментальные тесты и обеспечивает восстановление устройства.
abstract boolean	runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) То же, что и ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) но запускает тест для данного пользователя.
abstract boolean	runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) То же, что и ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) но запускает тест для данного пользователя.
abstract void	setDate (Date date) Устанавливает дату на устройстве Примечание: для установки даты на устройстве требуется root
abstract void	setOptions ( TestDeviceOptions options) Установите TestDeviceOptions для устройства
abstract boolean	setProperty (String propKey, String propValue) Устанавливает заданное значение свойства на устройстве.
abstract void	setRecovery ( IDeviceRecovery recovery) Установите IDeviceRecovery для использования с этим устройством.
abstract void	setRecoveryMode ( ITestDevice.RecoveryMode mode) Установите текущий режим восстановления для использования на устройстве.
abstract void	setUseFastbootErase (boolean useFastbootErase) Укажите, следует ли использовать стирание fastboot или форматирование fastboot для очистки раздела на устройстве.
abstract void	startLogcat () Начните захват вывода logcat с устройства в фоновом режиме.
abstract void	stopEmulatorOutput () Закройте и удалите вывод эмулятора.
abstract void	stopLogcat () Остановить захват выходных данных logcat с устройства и удалить текущие сохраненные данные logcat.
abstract String	switchToAdbTcp () Переключите устройство в режим adb-over-tcp.
abstract boolean	switchToAdbUsb () Переключите устройство в режим adb через usb.
abstract boolean	syncFiles (File localFileDir, String deviceFilePath) Постепенно синхронизирует содержимое локального каталога файлов с устройством.
abstract boolean	unlockDevice () Разблокирует устройство, если оно находится в зашифрованном состоянии.
abstract boolean	waitForBootComplete (long timeOut) Блокирует до тех пор, пока не будет установлен флаг завершения загрузки устройства.
abstract boolean	waitForDeviceAvailable () Ожидает, пока устройство отреагирует и будет доступно для тестирования.
abstract boolean	waitForDeviceAvailable (long waitTime) Ожидает, пока устройство отреагирует и будет доступно для тестирования.
abstract boolean	waitForDeviceAvailableInRecoverPath (long waitTime) Ожидает, пока устройство отреагирует и станет доступным, без учета пути восстановления.
abstract void	waitForDeviceBootloader () Блокирует, пока устройство не будет видно через fastboot.
abstract boolean	waitForDeviceInRecovery (long waitTime) Блокирует, чтобы устройство находилось в состоянии «adb recovery» (обратите внимание, что это отличается от IDeviceRecovery ).
abstract boolean	waitForDeviceInSideload (long waitTime) Блокирует, чтобы устройство находилось в состоянии «adb sideload»
abstract boolean	waitForDeviceNotAvailable (long waitTime) Блокирует, чтобы устройство было недоступно, т.е. отсутствует в adb
abstract void	waitForDeviceOnline () Блокирует, пока устройство не будет видно через adb.
abstract void	waitForDeviceOnline (long waitTime) Блокирует, пока устройство не будет видно через adb.
abstract boolean	waitForDeviceShell (long waitTime) Ожидает, пока устройство отреагирует на базовую команду оболочки adb.

Константы

НЕИЗВЕСТНЫЙ_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Значение по умолчанию, когда невозможно определить уровень API.

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

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

проверитьApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

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

очиститьLogcat

public abstract void clearLogcat ()

Удаляет любые накопленные данные logcat.

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

удалить файл

public abstract void deleteFile (String deviceFilePath)

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

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

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

устройствоSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

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

устройствоSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

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

отключитьAdbRoot

public abstract boolean disableAdbRoot ()

Отключает adb root.

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

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

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

делаетFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

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

включитьAdbRoot

public abstract boolean enableAdbRoot ()

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

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

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

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

выполнитьAdbCommand

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

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

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

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

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

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

выполнитьAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

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

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

выполнитьAdbCommand

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

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

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

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

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

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

выполнить FastbootCommand

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

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

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

Параметры
timeout	long : время в миллисекундах до истечения срока действия команды
commandArgs	String : команда fastboot и аргументы для запуска

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

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

выполнить FastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

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

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

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

выполнить команду LongFastboot

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

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

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

выполнить команду LongFastboot

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

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

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

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

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

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

выполнитьShellCommand

public abstract String executeShellCommand (String command)

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

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

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

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

выполнитьShellCommand

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

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

Параметры
command	String : команда оболочки adb для запуска
receiver	IShellOutputReceiver : IShellOutputReceiver для прямого вывода оболочки.
maxTimeToOutputShellResponse	long : максимальное количество времени, в течение которого команда может не выводить никакого ответа; единица измерения, указанная в timeUnit
timeUnit	TimeUnit : единица измерения для maxTimeToOutputShellResponse
retryAttempts	int : максимальное количество попыток повторения команды в случае сбоя из-за исключения. DeviceNotResponsiveException будет сгенерировано, если retryAttempts не увенчались успехом.

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

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

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

выполнить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	если связь с устройством потеряна и не может быть восстановлена.

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

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

выполнитьShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

выполнитьShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

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

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

выполнитьShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

Параметры
command	String : команда, которую нужно запустить.
pipeToOutput	OutputStream : ERROR(/OutputStream) , где стандартный вывод будет перенаправлен, или null.

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

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

выполнитьShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

Параметры
command	String : команда, которую нужно запустить.
pipeAsInput	File : ERROR(/File) , которая будет передана в качестве входных данных для команды, или null.

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

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

выполнитьShellV2Command

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

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

Параметры
command	String : команда оболочки adb для запуска
maxTimeoutForCommand	long : максимальный тайм-аут для завершения команды; единица измерения, указанная в timeUnit
timeUnit	TimeUnit : единица измерения для maxTimeToOutputShellResponse
retryAttempts	int : максимальное количество попыток повторения команды в случае сбоя из-за исключения. DeviceNotResponsiveException будет сгенерировано, если retryAttempts не увенчались успехом.

Возвращает
CommandResult

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

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

• executeShellV2Command(String)
• TimeUtil

выполнитьShellV2Command

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

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

Параметры
command	String : команда оболочки adb для запуска
maxTimeoutForCommand	long : максимальный тайм-аут для завершения команды; единица измерения, указанная в timeUnit
timeUnit	TimeUnit : единица измерения для maxTimeToOutputShellResponse

Возвращает
CommandResult

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

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

• executeShellV2Command(String)
• TimeUtil

выполнить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	если связь с устройством потеряна и не может быть восстановлена.

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

• executeShellV2Command(String)
• TimeUtil

выполнить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	если связь с устройством потеряна и не может быть восстановлена.

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

• executeShellV2Command(String)
• TimeUtil

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

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

Параметры
partition	String : раздел для очистки

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

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

getApiLevel

public abstract int getApiLevel ()

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

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

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

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

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

получитьбатарея

public abstract Integer getBattery ()

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

Возвращает
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

Параметры
name	String : имя свойства
defaultValue	boolean : возвращаемое значение по умолчанию, если свойство пусто или не существует.

Возвращает
boolean	true , если свойство имеет значение "1" , "y" , "yes" , "on" или "true" , false , если свойство имеет значение "0" , "n" , "no" , "off" , "false" или defaultValue в противном случае.

Броски
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

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

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

Броски
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

Броски
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

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

getBuildId

public abstract String getBuildId ()

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

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

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

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

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

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

Возвращает
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

Возвращает
DeviceDescriptor

получитьдетей

public abstract String[] getChildren (String deviceFilePath)

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

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

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

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

получитьсоединение

public abstract AbstractConnection getConnection ()

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

Возвращает
AbstractConnection

получитькласс устройства

public abstract String getDeviceClass ()

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

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

getDeviceDate

public abstract long getDeviceDate ()

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

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

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

получитьDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

Возвращает
DeviceDescriptor

получитьDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

Возвращает
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

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

Возвращает
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

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

Параметры
date	Date

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

Броски
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

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

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

Возвращает
long	количество свободного места в КБ

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

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

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

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

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

public abstract String getFastbootSerialNumber ()

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

Возвращает
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

Броски
	UnsupportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

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

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

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

получитьIDevice

public abstract IDevice getIDevice ()

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

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

Возвращает
IDevice	IDevice

получитьинтпроперти

public abstract long getIntProperty (String name, 
                long defaultValue)

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

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

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

Броски
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Returns the last time Tradefed APIs triggered a reboot in milliseconds since EPOCH as returned by System.currentTimeMillis() .

Возвращает
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

Get the device's first launched API Level. Defaults to UNKNOWN_API_LEVEL .

Возвращает
int	an integer indicating the first launched API Level of device

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

getLogcat

public abstract InputStreamSource getLogcat ()

Grabs a snapshot stream of the logcat data.

Works in two modes:

If the logcat is currently being captured in the background, will return up to TestDeviceOptions.getMaxLogcatDataSize() bytes of the current contents of the background logcat capture

Otherwise, will return a static dump of the logcat data if device is currently responding

Возвращает
InputStreamSource

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

Grabs a snapshot stream of the last maxBytes of captured logcat data.

Useful for cases when you want to capture frequent snapshots of the captured logcat data without incurring the potentially big disk space penalty of getting the entire getLogcat() snapshot.

Параметры
maxBytes	int : the maximum amount of data to return. Should be an amount that can comfortably fit in memory

Возвращает
InputStreamSource

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

Get a dump of the current logcat for device. Unlike getLogcat() , this method will always return a static dump of the logcat.

Has the disadvantage that nothing will be returned if device is not reachable.

Возвращает
InputStreamSource	a InputStreamSource of the logcat data. An empty stream is returned if fail to capture logcat data.

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

Grabs a snapshot stream of captured logcat data starting the date provided. The time on the device should be used getDeviceDate() .

Параметры
date	long : in millisecond since epoch format of when to start the snapshot until present. (can be be obtained using 'date +%s')

Возвращает
InputStreamSource

getMountPoint

public abstract String getMountPoint (String mountName)

Returns a mount point.

Queries the device directly if the cached info in IDevice is not available.

TODO: move this behavior to IDevice#getMountPoint(String)

Параметры
mountName	String : the name of the mount point

Возвращает
String	the mount point or null

See also:

• IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Returns a MountPointInfo corresponding to the specified mountpoint path, or null if that path has nothing mounted or otherwise does not appear in /proc/mounts as a mountpoint.

Параметры
mountpoint	String

Возвращает
ITestDevice.MountPointInfo	A ERROR(/List) of MountPointInfo containing the information in "/proc/mounts"

Броски
DeviceNotAvailableException

See also:

• getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

Returns a parsed version of the information in /proc/mounts on the device

Возвращает
	A ERROR(/List) of MountPointInfo containing the information in "/proc/mounts"

Броски
DeviceNotAvailableException

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

Helper method to determine amount of free space on device partition.

Параметры
partition	String

Возвращает
long	the amount of free space in KB

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

Helper method runs the "pidof" and "stat" command and returns ProcessInfo object with PID and process start time of the given process.

Параметры
processName	String : the proces name String.

Возвращает
ProcessInfo	ProcessInfo of given processName

Броски
DeviceNotAvailableException

getProcessPid

public abstract String getProcessPid (String process)

Returns the pid of the service or null if something went wrong.

Параметры
process	String : The proces name String.

Возвращает
String

Броски
DeviceNotAvailableException

getProductType

public abstract String getProductType ()

Convenience method to get the product type of this device.

This method will work if device is in either adb or fastboot mode.

Возвращает
String	the String product type name. Will not be null

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered, or if product type can not be determined

getProductVariant

public abstract String getProductVariant ()

Convenience method to get the product variant of this device.

This method will work if device is in either adb or fastboot mode.

Возвращает
String	the String product variant name or null if it cannot be determined

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

getProperty

public abstract String getProperty (String name)

Retrieve the given property value from the device.

Параметры
name	String : the property name

Возвращает
String	the property value or null if it does not exist

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

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

Get the current recovery mode used for the device.

Возвращает
ITestDevice.RecoveryMode	the current recovery mode used for the device.

getSerialNumber

public abstract String getSerialNumber ()

Convenience method to get serial number of this device.

Возвращает
String	the String serial number

getTombstones

public abstract  getTombstones ()

Fetch and return the list of tombstones from the devices. Requires root.

method is best-effort so if one tombstone fails to be pulled for any reason it will be missing from the list. Only a DeviceNotAvailableException will terminate the method early.

Возвращает
	A list of tombstone files, empty if no tombstone.

Броски
DeviceNotAvailableException

See also:

• Tombstones documentation

getTotalMemory

public abstract long getTotalMemory ()

Returns total physical memory size in bytes or -1 in case of internal error

Возвращает
long

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

Get whether to use fastboot erase or fastboot format to wipe a partition on the device.

Возвращает
boolean	true if fastboot erase will be used or false if fastboot format will be used.

See also:

• fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

Возвращает
boolean	true if device currently has adb root, false otherwise.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

isAdbTcp

public abstract boolean isAdbTcp ()

Возвращает
boolean	true if device is connected to adb-over-tcp, false otherwise.

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

Check whether platform on device supports app enumeration

Возвращает
boolean	True if app enumeration is supported, false otherwise

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

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

Check whether platform on device supports bypassing low target sdk block on app installs

Возвращает
boolean	True if bypass low target sdk block is supported, false otherwise

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

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

Returns if the device is encrypted.

Возвращает
boolean	true if the device is encrypted.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

Return True if the path on the device is a directory, false otherwise.

Параметры
deviceFilePath	String

Возвращает
boolean

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

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

Returns if encryption is supported on the device.

Возвращает
boolean	true if the device supports encryption.

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

isExecutable

public abstract boolean isExecutable (String fullPath)

Returns True if the file path on the device is an executable file, false otherwise.

Параметры
fullPath	String

Возвращает
boolean

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

isHeadless

public abstract boolean isHeadless ()

Return true if the device is headless (no screen), false otherwise.

Возвращает
boolean

Броски
DeviceNotAvailableException

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

Check whether platform on device supports runtime permission granting

Возвращает
boolean	True if runtime permission are supported, false otherwise.

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

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

Returns true if device is in TestDeviceState#FASTBOOT or TestDeviceState.FASTBOOTD .

Возвращает
boolean

logAnrs

public abstract boolean logAnrs (ITestLogger logger)

Collects and log ANRs from the device.

Параметры
logger	ITestLogger : an ITestLogger to log the ANRs.

Возвращает
boolean	True if the logging was successful, false otherwise.

Броски
DeviceNotAvailableException

logOnDevice

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

Log a message in the logcat of the device. This is a safe call that will not throw even if the logging fails.

Параметры
tag	String : The tag under which we log our message in the logcat.
level	Log.LogLevel : The debug level of the message in the logcat.
format	String : The message format.
args	Object : the args to be replaced via String.format().

nonBlockingReboot

public abstract void nonBlockingReboot ()

Issues a command to reboot device and returns on command complete and when device is no longer visible to adb.

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

postBootSetup

public abstract void postBootSetup ()

Perform instructions to configure device for testing that after every boot.

Should be called after device is fully booted/available

In normal circumstances this method doesn't need to be called explicitly, as implementations should perform these steps automatically when performing a reboot.

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

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

postInvocationTearDown

public void postInvocationTearDown ()

This method is deprecated.
Use postInvocationTearDown(Throwable) instead.

Extra steps for device specific required clean up that will be executed after the invocation is done.

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

Extra steps for device specific required clean up that will be executed after the invocation is done.

Параметры
invocationException	Throwable : if any, the final exception raised by the invocation failure.

preInvocationSetup

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

Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.

Параметры
info	IBuildInfo : The IBuildInfo of the device.
attributes	MultiMap : The attributes stored in the invocation context

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

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

Recursively pull directory contents from device.

Параметры
deviceFilePath	String : the absolute file path of the remote source
localDir	File : the local directory to pull files into

Возвращает
boolean	true if file was pulled successfully. false otherwise.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

Параметры
remoteFilePath	String : the absolute path to file on device.
userId	int : The user id to pull from

Возвращает
File	A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

pullFile

public abstract File pullFile (String remoteFilePath)

Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

Параметры
remoteFilePath	String : the absolute path to file on device.

Возвращает
File	A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

Retrieves a file off device.

Параметры
remoteFilePath	String : the absolute path to file on device.
localFile	File : the local file to store contents in. If non-empty, contents will be replaced.

Возвращает
boolean	true if file was retrieved successfully. false otherwise.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

pullFile

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

Retrieves a file off device.

Параметры
remoteFilePath	String : the absolute path to file on device.
localFile	File : the local file to store contents in. If non-empty, contents will be replaced.
userId	int : The user id to pull from

Возвращает
boolean	true if file was retrieved successfully. false otherwise.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

Retrieves a file off device, and returns the contents.

Параметры
remoteFilePath	String : the absolute path to file on device.

Возвращает
String	A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

Броски
DeviceNotAvailableException

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

Параметры
remoteFilePath	String : the path to file on device, relative to the device's external storage mountpoint

Возвращает
File	A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

pushDir

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

Recursively push directory contents to device while excluding some directories that are filtered.

Параметры
localDir	File : the local directory to push
deviceFilePath	String : the absolute file path of the remote destination
excludedDirectories	: Set of excluded directories names that shouldn't be pushed.

Возвращает
boolean	true if file was pushed successfully. false otherwise.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

Recursively push directory contents to device.

Параметры
localDir	File : the local directory to push
deviceFilePath	String : the absolute file path of the remote destination

Возвращает
boolean	true if file was pushed successfully. false otherwise.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

pushFile

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

Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

Параметры
localFile	File : the local file to push
deviceFilePath	String : the remote destination absolute file path
evaluateContentProviderNeeded	boolean : whether to check if we need the content provider

Возвращает
boolean	true if file was pushed successfully. false otherwise.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

Push a file to device. By default using a content provider.

Параметры
localFile	File : the local file to push
deviceFilePath	String : the remote destination absolute file path

Возвращает
boolean	true if file was pushed successfully. false otherwise.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

pushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

Push file created from a string to device

Параметры
contents	String : the contents of the file to push
deviceFilePath	String : the remote destination absolute file path

Возвращает
boolean	true if string was pushed successfully. false otherwise.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

reboot

public abstract void reboot ()

Reboots the device into adb mode.

Blocks until device becomes available.

Броски
DeviceNotAvailableException	if device is not available after reboot

reboot

public abstract void reboot (String reason)

Reboots the device into adb mode with given reason to be persisted across reboot.

Blocks until device becomes available.

Last reboot reason can be obtained by querying sys.boot.reason propety.

Параметры
reason	String : a reason for this reboot, or null if no reason is specified.

Броски
DeviceNotAvailableException	if device is not available after reboot

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

Reboots the device into bootloader mode.

Blocks until device is in bootloader mode.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

Reboots the device into fastbootd mode.

Blocks until device is in fastbootd mode.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

Reboots the device into adb recovery mode.

Blocks until device enters recovery

Броски
DeviceNotAvailableException	if device is not available after reboot

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

Reboots the device into adb sideload mode (note that this is a special mode under recovery)

Blocks until device enters sideload mode

Параметры
autoReboot	boolean : whether to automatically reboot the device after sideload

Броски
DeviceNotAvailableException	if device is not in sideload after reboot

rebootIntoSideload

public abstract void rebootIntoSideload ()

Reboots the device into adb sideload mode (note that this is a special mode under recovery)

Blocks until device enters sideload mode

Броски
DeviceNotAvailableException	if device is not in sideload after reboot

rebootUntilOnline

public abstract void rebootUntilOnline ()

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

Броски
DeviceNotAvailableException	if device is not available after reboot

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

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

Параметры
reason	String : a reason for this reboot, or null if no reason is specified.

Броски
DeviceNotAvailableException	if device is not available after reboot

See also:

• reboot(String)

rebootUserspace

public abstract void rebootUserspace ()

Reboots only userspace part of device.

Blocks until device becomes available.

WARNING. Userspace reboot is currently under active development, use it on your own risk.

Броски
DeviceNotAvailableException	if device is not available after reboot

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

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

Броски
DeviceNotAvailableException	if device is not available after reboot

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

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

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

remountSystemWritable

public abstract void remountSystemWritable ()

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

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

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

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

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

remountVendorWritable

public abstract void remountVendorWritable ()

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

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

runInstrumentationTests

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

Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

Параметры
runner	IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests
listeners	ITestLifeCycleReceiver : the test result listener(s)

Возвращает
boolean	true if test command completed. false if it failed to complete, but recovery succeeded

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed.

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Runs instrumentation tests, and provides device recovery.

If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.

If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.

Параметры
runner	IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests
listeners	: the test result listeners

Возвращает
boolean	true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed.

runInstrumentationTestsAsUser

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

Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

Параметры
runner	IRemoteAndroidTestRunner
userId	int
listeners

Возвращает
boolean

Броски
DeviceNotAvailableException

runInstrumentationTestsAsUser

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

Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

Параметры
runner	IRemoteAndroidTestRunner
userId	int
listeners	ITestLifeCycleReceiver

Возвращает
boolean

Броски
DeviceNotAvailableException

setDate

public abstract void setDate (Date date)

Sets the date on device

Note: setting date on device requires root

Параметры
date	Date : specify a particular date; will use host date if null

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

setOptions

public abstract void setOptions (TestDeviceOptions options)

Set the TestDeviceOptions for the device

Параметры
options	TestDeviceOptions

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

Sets the given property value on the device. Requires adb root is true.

Параметры
propKey	String : The key targeted to be set.
propValue	String : The property value to be set.

Возвращает
boolean	returns True if the setprop command was successful, False otherwise.

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

setRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

Set the IDeviceRecovery to use for this device. Should be set when device is first allocated.

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

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

Set the current recovery mode to use for the device.

Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc

Параметры
mode	ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not.

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

Параметры
useFastbootErase	boolean : true if fastboot erase should be used or false if fastboot format should be used.

See also:

• fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

Start capturing logcat output from device in the background.

Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.

When the device is no longer in use, stopLogcat() must be called.

startLogcat() and stopLogcat() do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

Close and delete the emulator output.

stopLogcat

public abstract void stopLogcat ()

Stop capturing logcat output from device, and discard currently saved logcat data.

Will have no effect if logcat output is not being captured.

switchToAdbTcp

public abstract String switchToAdbTcp ()

Switch device to adb-over-tcp mode.

Возвращает
String	the tcp serial number or null if device could not be switched

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

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

Switch device to adb over usb mode.

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

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

syncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

Incrementally syncs the contents of a local file directory to device.

Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.

Hidden files (with names starting with ".") will be ignored.

Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.

Параметры
localFileDir	File : the local file directory containing files to recursively push.
deviceFilePath	String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail

Возвращает
boolean	true if files were synced successfully. false otherwise.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

unlockDevice

public abstract boolean unlockDevice ()

Unlocks the device if the device is in an encrypted state.

This method may restart the framework but will not call postBootSetup() . Therefore, the device might not be fully ready to be tested when this method returns.

Возвращает
boolean	true if successful or if the device is unencrypted.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.
UnsupportedOperationException	if encryption is not supported on the device.

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

Blocks until the device's boot complete flag is set.

Параметры
timeOut	long : time in msecs to wait for the flag to be set

Возвращает
boolean	true if device's boot complete flag is set within the timeout

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

Waits for the device to be responsive and available for testing. Uses default timeout.

Возвращает
boolean	True if device is available, False if recovery is disabled and unavailable.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

Waits for the device to be responsive and available for testing.

Параметры
waitTime	long : the time in ms to wait

Возвращает
boolean	True if device is available, False if recovery is disabled and unavailable.

Броски
DeviceNotAvailableException	if device is still unresponsive after waitTime expires.

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Waits for the device to be responsive and available without considering recovery path.

Параметры
waitTime	long

Возвращает
boolean	True if device is available, False if unavailable.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

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

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

Параметры
waitTime	long : the time in ms to wait

Возвращает
boolean	true if device boots into recovery before time expires. false otherwise

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

Blocks for the device to be in the 'adb sideload' state

Параметры
waitTime	long : the time in ms to wait

Возвращает
boolean	true if device boots into sideload before time expires. false otherwise

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

Blocks for the device to be not available ie missing from adb

Параметры
waitTime	long : the time in ms to wait

Возвращает
boolean	true if device becomes not available before time expires. false otherwise

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

Blocks until device is visible via adb. Uses default timeout

Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

Blocks until device is visible via adb.

Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

Параметры
waitTime	long : the time in ms to wait

Броски
DeviceNotAvailableException	if connection with device is lost and cannot be recovered.

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

Waits for device to be responsive to a basic adb shell command.

Параметры
waitTime	long : the time in ms to wait

Возвращает
boolean	true if device becomes responsive before waitTime elapses.