INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

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

---

Предоставляет надежный 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 ProcessInfo .
abstract boolean	deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) Вспомогательный метод для проверки того, был ли выполнен программный перезапуск устройства с момента времени UTC, начиная с эпохи устройства и его ERROR(/TimeUnit) .
abstract boolean	disableAdbRoot () Отключает адб рут.
abstract boolean	doesFileExist (String deviceFilePath) Вспомогательный метод для определения существования файла на устройстве.
abstract boolean	enableAdbRoot () Включает adb root.
abstract String	executeAdbCommand (long timeout, String... commandArgs) Вспомогательный метод, который выполняет команду adb как системную команду с указанным тайм-аутом.
abstract String	executeAdbCommand (String... commandArgs) Вспомогательный метод, который выполняет команду adb как системную команду.
abstract String	executeAdbCommand (long timeout, envMap, String... commandArgs) Вспомогательный метод, который выполняет команду 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) Вспомогательный метод, который выполняет длительную команду быстрой загрузки как системную команду с переменными системной среды.
abstract String	executeShellCommand (String command) Вспомогательный метод, который выполняет команду оболочки adb и возвращает выходные данные в виде String .
abstract void	executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды.
abstract void	executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды.
abstract void	executeShellCommand (String command, IShellOutputReceiver receiver) Выполняет заданную команду оболочки adb, повторяя несколько раз, если команда завершается неудачно.
abstract CommandResult	executeShellV2Command (String command) Вспомогательный метод, который выполняет команду оболочки adb и возвращает результаты в виде CommandResult , правильно заполненного выходными данными состояния команды, стандартными выводами и стандартными выводами stderr.
abstract CommandResult	executeShellV2Command (String command, OutputStream pipeToOutput) Вспомогательный метод, который выполняет команду оболочки adb и возвращает результаты в виде CommandResult , правильно заполненного выводом состояния команды и стандартным потоком stderr.
abstract CommandResult	executeShellV2Command (String command, File pipeAsInput) Вспомогательный метод, который выполняет команду оболочки adb и возвращает результаты в виде CommandResult , правильно заполненного выводом состояния команды, стандартными выводами и стандартными выводами stderr.
abstract CommandResult	executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды.
abstract CommandResult	executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды.
abstract CommandResult	executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды.
abstract CommandResult	executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды.
abstract CommandResult	fastbootWipePartition (String partition) Вспомогательный метод, который стирает раздел устройства.
abstract int	getApiLevel () Получите уровень API устройства.
abstract String	getBasebandVersion () Удобный способ получить базовую (радио) версию этого устройства.
abstract Integer	getBattery () Возвращает текущий уровень заряда батареи устройства или значение NULL, если уровень заряда батареи недоступен.
abstract boolean	getBooleanProperty (String name, boolean defaultValue) Возвращает логическое значение данного свойства.
abstract	getBootHistory () Вспомогательный метод собирает карту истории загрузки со временем загрузки и причиной загрузки.
abstract	getBootHistorySince (long utcEpochTime, TimeUnit timeUnit) Вспомогательный метод собирает карту истории загрузки со временем загрузки и причиной загрузки с заданного времени, начиная с эпохи с устройства и указанной единицы времени.
abstract String	getBootloaderVersion () Удобный способ получить версию загрузчика этого устройства.
abstract String	getBuildAlias () Получите псевдоним сборки, которую в данный момент выполняет устройство.
abstract String	getBuildFlavor () Получите версию сборки для устройства.
abstract String	getBuildId () Получите сборку, на которой в данный момент работает устройство.
abstract String	getBuildSigningKeys () Возвращает тип ключа, используемый для подписи образа устройства. Обычно устройства Android могут быть подписаны с помощью тестовых ключей (например, в AOSP) или ключей выпуска (контролируемых отдельными производителями устройств).
abstract DeviceDescriptor	getCachedDeviceDescriptor () Возвращает кэшированный DeviceDescriptor , если устройство выделено, в противном случае возвращает текущий DeviceDescriptor .
abstract DeviceDescriptor	getCachedDeviceDescriptor (boolean shortDescriptor) Возвращает кэшированный DeviceDescriptor , если устройство выделено, в противном случае возвращает текущий DeviceDescriptor .
abstract String[]	getChildren (String deviceFilePath) Альтернатива использованию IFileEntry , которая иногда не работает из-за разрешений.
abstract AbstractConnection	getConnection () Возвращает соединение, связанное с устройством.
abstract String	getDeviceClass () Получите класс устройства.
abstract long	getDeviceDate () Возвращает дату устройства в миллисекундах с начала эпохи.
abstract DeviceDescriptor	getDeviceDescriptor () Верните DeviceDescriptor из информации об устройстве, чтобы получить информацию о нем без передачи фактического объекта устройства.
abstract DeviceDescriptor	getDeviceDescriptor (boolean shortDescriptor) Верните DeviceDescriptor из информации об устройстве, чтобы получить информацию о нем без передачи фактического объекта устройства.
abstract TestDeviceState	getDeviceState () Получите состояние устройства.
abstract long	getDeviceTimeOffset (Date date) Помощник для получения разницы во времени между устройством и заданной ERROR(/Date) .
abstract InputStreamSource	getEmulatorOutput () Получите поток stdout и stderr эмулятора.
abstract long	getExternalStoreFreeSpace () Вспомогательный метод для определения объема свободного места на внешнем хранилище устройства.
abstract String	getFastbootProductType () Удобный метод получения типа продукта этого устройства, когда оно находится в режиме быстрой загрузки.
abstract String	getFastbootProductVariant () Удобный метод получения типа продукта этого устройства, когда оно находится в режиме быстрой загрузки.
abstract String	getFastbootSerialNumber () Возвращает серийный номер режима быстрой загрузки.
abstract String	getFastbootVariable (String variableName) Получите заданное значение переменной fastboot с устройства.
abstract IFileEntry	getFileEntry (String path) Получить ссылку на удаленный файл на устройстве.
abstract IDevice	getIDevice () Возвращает ссылку на связанный IDevice ddmlib.
abstract long	getIntProperty (String name, long defaultValue) Возвращает целочисленное значение данного свойства с устройства.
abstract long	getLastExpectedRebootTimeMillis () Возвращает последний раз, когда API-интерфейсы Tradefed запускали перезагрузку в миллисекундах с момента EPOCH, как возвращается System.currentTimeMillis() .
abstract int	getLaunchApiLevel () Получите первый запущенный уровень API устройства.
abstract InputStreamSource	getLogcat () Получает поток снимков данных logcat.
abstract InputStreamSource	getLogcat (int maxBytes) Получает поток снимков последних maxBytes захваченных данных logcat.
abstract InputStreamSource	getLogcatDump () Получите дамп текущего логарифма устройства.
abstract InputStreamSource	getLogcatSince (long date) Получает поток снимков записанных данных logcat, начиная с указанной даты.
abstract String	getMountPoint (String mountName) Возвращает точку монтирования.
abstract ITestDevice.MountPointInfo	getMountPointInfo (String mountpoint) Возвращает MountPointInfo соответствующий указанному пути к точке монтирования, или null если по этому пути ничего не смонтировано или по какой-либо причине не отображается в /proc/mounts как точка монтирования.
abstract	getMountPointInfo () Возвращает проанализированную версию информации в /proc/mounts на устройстве.
abstract long	getPartitionFreeSpace (String partition) Вспомогательный метод для определения количества свободного места в разделе устройства.
abstract ProcessInfo	getProcessByName (String processName) Вспомогательный метод запускает команды «pidof» и «stat» и возвращает объект ProcessInfo с PID и временем запуска данного процесса.
abstract String	getProcessPid (String process) Возвращает pid службы или значение null, если что-то пошло не так.
abstract String	getProductType () Удобный способ узнать тип продукта этого устройства.
abstract String	getProductVariant () Удобный способ получить вариант продукта этого устройства.
abstract String	getProperty (String name) Получите заданное значение свойства с устройства.
abstract ITestDevice.RecoveryMode	getRecoveryMode () Получите текущий режим восстановления, используемый для устройства.
abstract String	getSerialNumber () Удобный способ получить серийный номер этого устройства.
abstract	getTombstones () Получите и верните список надгробий с устройств.
abstract long	getTotalMemory () Возвращает общий размер физической памяти в байтах или -1 в случае внутренней ошибки.
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, если устройство находится в TestDeviceState.FASTBOOT или TestDeviceState.FASTBOOTD .
abstract boolean	logAnrs ( ITestLogger logger) Собирает и регистрирует ошибки ANR с устройства.
abstract void	logOnDevice (String tag, Log.LogLevel level, String format, Object... args) Зарегистрируйте сообщение в logcat устройства.
abstract void	mountDebugfs () Смонтируйте отладочную файлы.
abstract void	nonBlockingReboot () Выдает команду на перезагрузку устройства и возвращает результат после завершения команды и когда устройство больше не отображается в adb.
abstract void	postBootSetup () Выполняйте инструкции по настройке устройства для тестирования после каждой загрузки.
default void	postInvocationTearDown () Этот метод устарел. Вместо этого используйте postInvocationTearDown(Throwable) .
abstract void	postInvocationTearDown (Throwable invocationException) Дополнительные шаги для очистки, необходимой для конкретного устройства, которые будут выполнены после завершения вызова.
default void	preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes) Дополнительные шаги для необходимой настройки конкретного устройства, которые будут выполняться на устройстве перед потоком вызова.
abstract boolean	pullDir (String deviceFilePath, File localDir) Рекурсивно извлекать содержимое каталога с устройства.
abstract boolean	pullDir (String deviceFilePath, File localDir, int userId) Рекурсивно извлекать содержимое каталога с устройства.
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, int userId) Рекурсивно отправлять содержимое каталога на устройство.
abstract boolean	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	pushFile (File localFile, String deviceFilePath, int userId) Отправьте файл на устройство.
abstract boolean	pushString (String contents, String deviceFilePath) Отправить файл, созданный из строки, на устройство
abstract void	reboot () Перезагружает устройство в режим adb.
abstract void	reboot (String reason) Перезагружает устройство в режиме adb с указанием reason , которая будет сохраняться при перезагрузке.
abstract void	rebootIntoBootloader () Перезагружает устройство в режим загрузчика.
abstract void	rebootIntoFastbootd () Перезагружает устройство в режим fastbootd.
abstract void	rebootIntoRecovery () Перезагружает устройство в режим восстановления adb.
abstract void	rebootIntoSideload (boolean autoReboot) Перезагружает устройство в режим боковой загрузки adb (обратите внимание, что это специальный режим в режиме восстановления) Блокируется до тех пор, пока устройство не перейдет в режим неопубликованной загрузки.
abstract void	rebootIntoSideload () Перезагружает устройство в режим боковой загрузки adb (обратите внимание, что это специальный режим в режиме восстановления) Блокируется до тех пор, пока устройство не перейдет в режим неопубликованной загрузки.
abstract void	rebootUntilOnline () Альтернатива reboot() , которая блокируется только до тех пор, пока устройство не будет подключено к сети, т.е. не станет видимым для adb.
abstract void	rebootUntilOnline (String reason) Альтернатива reboot() , которая блокируется только до тех пор, пока устройство не будет подключено к сети, т.е. не станет видимым для adb.
abstract void	rebootUserspace () Перезагружает только часть пользовательского пространства устройства.
abstract void	rebootUserspaceUntilOnline () Альтернатива rebootUserspace() ()}, которая блокируется только до тех пор, пока устройство не окажется в сети, т. е. не станет видимым для adb.
abstract void	remountSystemReadOnly () Сделайте системный раздел на устройстве доступным только для чтения.
abstract void	remountSystemWritable () Сделайте системный раздел на устройстве доступным для записи.
abstract void	remountVendorReadOnly () Сделайте раздел поставщика на устройстве доступным только для чтения.
abstract void	remountVendorWritable () Сделайте раздел поставщика на устройстве доступным для записи.
abstract boolean	runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) Удобный метод для выполнения ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) с одним или несколькими прослушивателями, переданными в качестве параметров.
abstract boolean	runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) Запускает инструментальные тесты и обеспечивает восстановление устройства.
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)) но запускает тест для данного пользователя.
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	setTrackingSerial (String trackingSerial) В целях управления устройствами отслеживайте серийный номер, который мы используем для ссылки на устройство.
abstract void	setUseFastbootErase (boolean useFastbootErase) Укажите, следует ли использовать очистку быстрой загрузки или формат быстрой загрузки для очистки раздела на устройстве.
abstract void	startLogcat () Начните захват вывода logcat с устройства в фоновом режиме.
abstract boolean	startTradeInModeTesting (int timeoutMs) Включите тестовый режим trade-in.
abstract void	stopEmulatorOutput () Закройте и удалите вывод эмулятора.
abstract void	stopLogcat () Прекратите захват выходных данных logcat с устройства и удалите текущие сохраненные данные logcat.
abstract void	stopTradeInModeTesting () Прекратите тестирование режима trade-in.
abstract String	switchToAdbTcp () Переключите устройство в режим adb-over-tcp.
abstract boolean	switchToAdbUsb () Переключите устройство в режим adb через USB.
abstract boolean	syncFiles (File localFileDir, String deviceFilePath) Поэтапно синхронизирует содержимое локального каталога файлов с устройством.
abstract boolean	unlockDevice () Разблокирует устройство, если оно находится в зашифрованном состоянии.
abstract void	unmountDebugfs () Отмонтируйте отладочные файлы.
abstract boolean	waitForBootComplete (long timeOut) Блокируется до тех пор, пока не будет установлен флаг завершения загрузки устройства.
abstract boolean	waitForDeviceAvailable () Ожидает, пока устройство ответит и будет доступно для тестирования.
abstract boolean	waitForDeviceAvailable (long waitTime) Ожидает, пока устройство ответит и будет доступно для тестирования.
abstract boolean	waitForDeviceAvailableInRecoverPath (long waitTime) Ожидает, пока устройство ответит и станет доступным, не учитывая путь восстановления.
abstract void	waitForDeviceBootloader () Блокируется до тех пор, пока устройство не станет видимым через fastboot.
abstract boolean	waitForDeviceInRecovery (long waitTime) Блокирует нахождение устройства в состоянии «восстановление adb» (обратите внимание, что это отличается от IDeviceRecovery ).
abstract boolean	waitForDeviceInSideload (long waitTime) Блокирует нахождение устройства в состоянии «adb Sideload».
abstract boolean	waitForDeviceNotAvailable (long waitTime) Блоки для устройства недоступны т.е. отсутствуют в adb
abstract void	waitForDeviceOnline () Блокируется до тех пор, пока устройство не станет видимым через adb.
abstract void	waitForDeviceOnline (long waitTime) Блокируется до тех пор, пока устройство не станет видимым через adb.
abstract boolean	waitForDeviceShell (long waitTime) Ожидает, пока устройство отреагирует на базовую команду оболочки adb.

Константы

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

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

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

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

проверкаApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

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

очиститьLogcat

public abstract void clearLogcat ()

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

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

удалить файл

public abstract void deleteFile (String deviceFilePath)

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

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

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

удалить файл

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

См. также:

• 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, который создаст новую файловую систему на устройстве.

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

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

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

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

getApiLevel

public abstract int getApiLevel ()

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

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

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

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

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

getBattery

public abstract Integer getBattery ()

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

Возврат
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

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

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

Броски
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

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

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

Броски
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

Параметры
utcEpochTime	long : время устройства с момента Epoch.
timeUnit	TimeUnit : единица времени TimeUnit .

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

Броски
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

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

getBuildId

public abstract String getBuildId ()

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

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

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

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

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

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

Возврат
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

Возврат
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

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

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

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

getConnection

public abstract AbstractConnection getConnection ()

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

Возврат
AbstractConnection

GetDeviceClass

public abstract String getDeviceClass ()

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

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

getDeviceDate

public abstract long getDeviceDate ()

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

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

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

Возврат
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

Возврат
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

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

Возврат
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

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

Параметры
date	Date

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

Броски
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

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

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

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

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

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

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

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

получитьFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

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

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

ПолучитьFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

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

Возврат
String

получитьFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

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

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

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

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

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

getIDevice

public abstract IDevice getIDevice ()

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

Новый 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.

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

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

В противном случае вернет статический дамп данных 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

См. также:

• IDevice.getMountPoint(String)

GetMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

Параметры
mountpoint	String

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

Броски
DeviceNotAvailableException

См. также:

• getMountPointInfo()

GetMountPointInfo

public abstract  getMountPointInfo ()

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

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

Броски
DeviceNotAvailableException

GetPartitionFreespace

public abstract long getPartitionFreeSpace (String partition)

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

Параметры
partition	String

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

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

GetProcessByName

public abstract ProcessInfo getProcessByName (String processName)

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

Параметры
processName	String : строка имени 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 abstract  getTombstones ()

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

Метод наиболее эффективен, поэтому, если один надгробный камень не может быть привлечен по любой причине, он будет отсутствовать в списке. Только 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.

См. также:

• fastbootWipePartition(String)

Исадбрут

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	Если устройство не доступно после перезагрузки

См. также:

• reboot(String)

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.

См. также:

• fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

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

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

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

startLogcat() и stopLogcat() обычно не нужно вызывать в контексте вызова TF, так как структура TF запустится и останавливает LogCat.

StartTradeInmodeTesting

public abstract boolean startTradeInModeTesting (int timeoutMs)

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

Параметры
timeoutMs	int

Возврат
boolean	Правда, если бы мы были успешными, неверно иначе

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

StopeMulatorOutput

public abstract void stopEmulatorOutput ()

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

stoplogcat

public abstract void stopLogcat ()

Прекратите захватить выход LogCat с устройства и отбросить в настоящее время сохраняемые данные LogCat.

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

StoptradeinModeTesting

public abstract void stopTradeInModeTesting ()

Прекратите тестировать режим обмена. Устройство перезагрузится.

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

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 .