INativeDevice

НЕИЗВЕСТНЫЙ УРОВЕНЬ API

public static final int UNKNOWN_API_LEVEL

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

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

проверкаApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

clearLogcat

public abstract void clearLogcat ()

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

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

удалитьФайл

public abstract void deleteFile (String deviceFilePath)

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

удалитьФайл

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

disableAdbRoot

public abstract boolean disableAdbRoot ()

Отключает корневой доступ к adb.

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

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

executeAdbCommand

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

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

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

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

executeAdbCommand

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

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

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

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

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

executeAdbV2Command

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

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

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                Map<String, String> envMap, 
                int retryAttempts, 
                String... commandArgs)

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

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                Map<String, String> envMap, 
                String... commandArgs)

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

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

executeFastbootCommand

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

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

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

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (Map<String, String> envVarMap, 
                String... commandArgs)

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

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

executeShellCommand

public abstract String executeShellCommand (String command)

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

executeShellCommand

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

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

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

Упрощенная форма функции executeShellCommand(String,IShellOutputReceiver,long,TimeUnit,int) со значениями по умолчанию.

executeShellCommand

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

executeShellV2Command

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

executeShellV2Command

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                IShellOutputReceiver receiver)

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

fastbootOemRamdumpNow

public abstract CommandResult fastbootOemRamdumpNow ()

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

Этот метод выполняет команду "oem ramdump now". В отличие от ERROR(/#executeFastbootCommand()) , он не пытается повторить попытку или восстановить устройство, если команда не удалась или статус недействителен, поскольку ожидаемым результатом является сбой устройства. Предполагается использовать этот метод, когда устройство уже находится в режиме fastboot.

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

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

getApiLevel

public abstract int getApiLevel ()

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

getApiLevelFull

public abstract int getApiLevelFull ()

Аналогично функции getApiLevel() , но возвращает полную версию.

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

public abstract Integer getBattery ()

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

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

getBootHistory

public abstract Map<Long, String> getBootHistory ()

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

getBootHistorySince

public abstract Map<Long, String> getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

getBuildId

public abstract String getBuildId ()

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

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

getConnection

public abstract AbstractConnection getConnection ()

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

getDeviceClass

public abstract String getDeviceClass ()

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

getDeviceDate

public abstract long getDeviceDate ()

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

getDeviceState

public abstract TestDeviceState getDeviceState ()

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

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

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

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

getFastbootProductType

public abstract String getFastbootProductType ()

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

This method should only be used if device should be in fastboot. Its a bit safer variant than the generic getProductType() method in this case, because ITestDevice will know to recover device into fastboot if device is in incorrect state or is unresponsive.

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

Convenience method to get the product type of this device when its in fastboot mode.

This method should only be used if device should be in fastboot. Its a bit safer variant than the generic getProductType() method in this case, because ITestDevice will know to recover device into fastboot if device is in incorrect state or is unresponsive.

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Returns the fastboot mode serial number.

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Retrieve the given fastboot variable value from the device.

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Retrieve a reference to a remote file on device.

getIDevice

public abstract IDevice getIDevice ()

Returns a reference to the associated ddmlib IDevice .

A new IDevice may be allocated by DDMS each time the device disconnects and reconnects from adb. Thus callers should not keep a reference to the IDevice , because that reference may become stale.

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Returns integer value of the given property from the device.

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

getLogcat

public abstract InputStreamSource getLogcat ()

Grabs a snapshot stream of the logcat data.

Works in two modes:

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

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

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

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

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

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

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

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

getMountPoint

public abstract String getMountPoint (String mountName)

Returns a mount point.

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

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

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

getMountPointInfo

public abstract List<ITestDevice.MountPointInfo> getMountPointInfo ()

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

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

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

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

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

getProcessPid

public abstract String getProcessPid (String process)

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

getProductType

public abstract String getProductType ()

Convenience method to get the product type of this device.

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

getProductVariant

public abstract String getProductVariant ()

Convenience method to get the product variant of this device.

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

получитьСвойство

public abstract String getProperty (String name)

Retrieve the given property value from the device.

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

Get the current recovery mode used for the device.

getSerialNumber

public abstract String getSerialNumber ()

Convenience method to get serial number of this device.

getTombstones

public abstract List<File> getTombstones ()

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

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

getTotalMemory

public abstract long getTotalMemory ()

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

getTrackingSerial

public String getTrackingSerial ()

For device management purpose get the serial used to track the device.

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

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

isAdbRoot

public abstract boolean isAdbRoot ()

isAdbTcp

public abstract boolean isAdbTcp ()

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

Check whether platform on device supports app enumeration

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

Check if debugfs is mounted.

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

Returns if the device is encrypted.

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

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

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

Returns if encryption is supported on the device.

isExecutable

public abstract boolean isExecutable (String fullPath)

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

isHeadless

public abstract boolean isHeadless ()

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

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

Check whether platform on device supports runtime permission granting

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

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

logAnrs

public abstract boolean logAnrs (ITestLogger logger)

Collects and log ANRs from the device.

logOnDevice

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

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

mountDebugfs

public abstract void mountDebugfs ()

Mount debugfs.

nonBlockingReboot

public abstract void nonBlockingReboot ()

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

postBootSetup

public abstract void postBootSetup ()

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

Should be called after device is fully booted/available

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

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

postInvocationTearDown

public void postInvocationTearDown ()

Этот метод устарел.
Use postInvocationTearDown(Throwable) instead.

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

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

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

preInvocationSetup

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

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

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

Recursively pull directory contents from device.

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId, 
                long timeout)

Recursively pull directory contents from device.

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId)

Recursively pull directory contents from device.

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

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

pullFile

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

Retrieves a file off device.

pullFile

public abstract File pullFile (String remoteFilePath)

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

pullFile

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

Retrieves a file off device.

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

Retrieves a file off device.

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

Retrieves a file off device, and returns the contents.

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

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

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                int userId)

Recursively push directory contents to device.

pushDir

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

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

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

Recursively push directory contents to device.

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                int userId)

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

pushFile

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

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

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

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

pushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

Push file created from a string to device

перезагрузить

public abstract void reboot ()

Reboots the device into adb mode.

Blocks until device becomes available.

перезагрузить

public abstract void reboot (String reason)

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

Blocks until device becomes available.

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

перезагрузить

public String reboot (String command, 
                String reason)

Reboots the device using the given command .

Blocks until device becomes available.

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

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

Reboots the device into bootloader mode.

Blocks until device is in bootloader mode.

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

Reboots the device into fastbootd mode.

Blocks until device is in fastbootd mode.

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

Reboots the device into adb recovery mode.

Blocks until device enters recovery

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

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

Blocks until device enters sideload mode

rebootIntoSideload

public abstract void rebootIntoSideload ()

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

Blocks until device enters sideload mode

rebootUntilOnline

public abstract void rebootUntilOnline ()

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

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

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

rebootUserspace

public abstract void rebootUserspace ()

Reboots only userspace part of device.

Blocks until device becomes available.

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

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

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

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

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

remountSystemWritable

public abstract void remountSystemWritable ()

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

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

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

remountVendorWritable

public abstract void remountVendorWritable ()

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

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                Collection<ITestLifeCycleReceiver> listeners)

Runs instrumentation tests, and provides device recovery.

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

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

runInstrumentationTests

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

Convenience method for performing runInstrumentationTests(IRemoteAndroidTestRunner,Collection) with one or more listeners passed as parameters.

runInstrumentationTestsAsUser

public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                Collection<ITestLifeCycleReceiver> listeners)

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

runInstrumentationTestsAsUser

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

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

setDate

public abstract void setDate (Date date)

Sets the date on device

Note: setting date on device requires root

setOptions

public abstract void setOptions (TestDeviceOptions options)

Set the TestDeviceOptions for the device

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

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

setRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

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

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

Set the current recovery mode to use for the device.

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

setTrackingSerial

public abstract void setTrackingSerial (String trackingSerial)

For device management purpose track the serial we use for referencing the device.

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

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

startLogcat

public abstract void startLogcat ()

Start capturing logcat output from device in the background.

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

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

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

startTradeInModeTesting

public abstract boolean startTradeInModeTesting (int timeoutMs)

Enable testing trade-in mode. The device will be wiped and will reboot.

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

Close and delete the emulator output.

stopLogcat

public abstract void stopLogcat ()

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

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

stopTradeInModeTesting

public abstract void stopTradeInModeTesting ()

Stop testing trade-in mode. The device will reboot.

switchToAdbTcp

public abstract String switchToAdbTcp ()

Switch device to adb-over-tcp mode.

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

Switch device to adb over usb mode.

syncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

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

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

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

unlockDevice

public abstract boolean unlockDevice ()

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

unmountDebugfs

public abstract void unmountDebugfs ()

Unmount debugfs.

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

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

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

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

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

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

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

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

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

Blocks until device is visible via adb. Uses default timeout

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

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

Blocks until device is visible via adb.

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

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

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