ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

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

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

Вложенные классы

class ITestDevice.ApexInfo

Простой класс структуры для хранения информации об одном APEX.

class ITestDevice.MountPointInfo

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

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

abstract boolean canSwitchToHeadlessSystemUser ()

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

abstract boolean checkConnectivity ()

Убедитесь, что устройство подключено к сети.

abstract boolean clearErrorDialogs ()

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

abstract void clearLastConnectedWifiNetwork ()

Очищает последнюю подключенную сеть Wi-Fi.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

Подключается к сети Wi-Fi.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

Подключается к сети Wi-Fi.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Подключается к сети Wi-Fi.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)

Подключается к сети Wi-Fi.

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)

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

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

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

abstract int createUser (String name)

Создайте пользователя с заданным именем и флагами по умолчанию 0.

abstract int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)

Создайте пользователя с заданным именем и предоставленными флагами

abstract int createUser (String name, boolean guest, boolean ephemeral)

Создайте пользователя с заданным именем и предоставленными флагами

abstract int createUserNoThrow (String name)

Создайте пользователя с заданным именем и флагами по умолчанию 0.

abstract void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Удаляет зарегистрированный IDeviceActionReceiver .

abstract void disableKeyguard ()

Попытки отключить блокировку клавиатуры.

abstract boolean disableNetworkMonitor ()

Отключает мониторинг сети на устройстве.

abstract boolean disconnectFromWifi ()

Отключается от сети Wi-Fi.

abstract boolean doesFileExist (String deviceFilePath, int userId)

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

abstract File dumpHeap (String process, String devicePath)

Попытаться сбросить кучу с system_server.

abstract boolean enableNetworkMonitor ()

Включает мониторинг сети на устройстве.

abstract getActiveApexes ()

Получить информацию об активированных на устройстве APEX.

abstract getAllSettings (String namespace)

Возвращает пары ключ-значение запрошенного пространства имен.

abstract String getAndroidId (int userId)

Найдите и верните идентификатор Android, связанный с идентификатором пользователя, ноль, если он не найден.

abstract getAndroidIds ()

Создайте карту идентификаторов Android, найденных совпадающими с идентификаторами пользователей.

abstract PackageInfo getAppPackageInfo (String packageName)

Получить информацию о пакете, установленном на устройстве.

abstract getAppPackageInfos ()

Получить информацию об установленных на устройстве пакетах.

abstract InputStreamSource getBugreport ()

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

abstract InputStreamSource getBugreportz ()

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

abstract DeviceFoldableState getCurrentFoldableState ()

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

abstract int getCurrentUser ()

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

abstract getFoldableStates ()

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

abstract getInstalledPackageNames ()

Получить имена пакетов приложений, присутствующих на устройстве.

abstract String getIpAddress ()

Получает IP-адрес устройства.

abstract KeyguardControllerState getKeyguardState ()

Возвращает объект, чтобы получить текущее состояние keyguard или null, если не поддерживается.

abstract Integer getMainUserId ()

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

abstract getMainlineModuleInfo ()

Получить информацию об основных модулях, установленных на устройстве.

abstract int getMaxNumberOfRunningUsersSupported ()

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

abstract int getMaxNumberOfUsersSupported ()

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

abstract TestDeviceOptions getOptions ()

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

abstract Integer getPrimaryUserId ()

Возвращает идентификатор основного пользователя.

abstract InputStreamSource getScreenshot ()

Делает снимок экрана с устройства.

abstract InputStreamSource getScreenshot (String format, boolean rescale)

Делает снимок экрана с устройства.

abstract InputStreamSource getScreenshot (String format)

Делает снимок экрана с устройства.

abstract InputStreamSource getScreenshot (long displayId)

Делает снимок экрана с устройства с заданным идентификатором дисплея.

abstract String getSetting (String namespace, String key)

См. getSetting(int, String, String) и выполняется для системного пользователя.

abstract String getSetting (int userId, String namespace, String key)

Возвращает значение запрошенной настройки.

abstract getUninstallablePackageNames ()

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

abstract int getUserFlags (int userId)

Найти и вернуть флаги данного пользователя.

abstract getUserInfos ()

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

abstract int getUserSerialNumber (int userId)

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

abstract boolean hasFeature (String feature)

Проверьте, доступна ли функция на устройстве.

abstract String installPackage (File packageFile, boolean reinstall, String... extraArgs)

Установите пакет Android на устройство.

abstract String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

Установите пакет Android на устройство.

abstract String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

Установите пакет Android на устройство для данного пользователя.

abstract String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)

Установите пакет Android на устройство для данного пользователя.

default String installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs)

Установите приложение для Android, состоящее из нескольких файлов APK (один основной и дополнительный разделенные пакеты).

default String installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

Установите приложение для Android, состоящее из нескольких файлов APK (один основной и дополнительный разделенные пакеты), которые находятся на устройстве Android.

default String installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

Установите приложение Android, состоящее из нескольких файлов APK (один основной и дополнительный разделенные пакеты) для данного пользователя.

default String installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)

Установите приложение Android, состоящее из нескольких файлов APK (один основной и дополнительный разделенные пакеты) для данного пользователя.

default String installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)

Установите приложение для Android, состоящее из нескольких файлов APK (один основной и дополнительный разделенные пакеты), которые находятся на устройстве Android.

default String installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

Установите приложение для Android, состоящее из нескольких файлов APK (один основной и дополнительный разделенные пакеты), которые находятся на устройстве Android.

abstract boolean isHeadlessSystemUserMode ()

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

abstract boolean isMainUserPermanentAdmin ()

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

abstract boolean isMultiUserSupported ()

Определяет, поддерживается ли многопользовательский режим.

abstract boolean isPackageInstalled (String packageName)

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

abstract boolean isPackageInstalled (String packageName, String userId)

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

abstract boolean isUserRunning (int userId)

Проверьте, работает ли данный пользователь.

abstract boolean isUserSecondary (int userId)

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

abstract boolean isUserVisible (int userId)

Проверяет, виден ли данный пользователь.

abstract boolean isUserVisibleOnDisplay (int userId, int displayId)

Проверяет, виден ли данный пользователь на данном дисплее.

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Возвращает значение, позволяющее устройству запускать пользователей в фоновом режиме в ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

abstract boolean isVisibleBackgroundUsersSupported ()

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

abstract boolean isWifiEnabled ()

Проверьте, включен ли Wi-Fi.

abstract listDisplayIds ()

Соберите список идентификаторов доступных дисплеев на устройстве, как сообщает «dumpsys SurfaceFlinger».

abstract listDisplayIdsForStartingVisibleBackgroundUsers ()

Получает список дисплеев, которые можно использовать для start a user visible in the background .

abstract listUsers ()

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

abstract boolean logBugreport (String dataName, ITestLogger listener)

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

abstract void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Регистрирует IDeviceActionReceiver для этого устройства.

abstract boolean removeAdmin (String componentName, int userId)

Удалите данного администратора устройства у данного пользователя и верните true , если он успешен, иначе false .

abstract void removeOwners ()

Приложите все усилия, чтобы удалить всех существующих владельцев профилей устройств.

abstract boolean removeUser (int userId)

Удалить данного пользователя с устройства.

abstract boolean setDeviceOwner (String componentName, int userId)

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

abstract void setSetting (String namespace, String key, String value)

См. setSetting(int, String, String, String) и выполняется для системного пользователя.

abstract void setSetting (int userId, String namespace, String key, String value)

Добавьте значение параметра в пространство имен данного пользователя.

abstract boolean startUser (int userId)

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

abstract boolean startUser (int userId, boolean waitFlag)

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

abstract boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)

Запускает данного пользователя в фоновом режиме, видимого на данном дисплее (т. е. позволяя пользователю запускать действия на этом дисплее).

abstract boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)

Остановить данного пользователя.

abstract boolean stopUser (int userId)

Останавливает данного пользователя.

abstract boolean switchUser (int userId)

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

abstract boolean switchUser (int userId, long timeout)

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

abstract Bugreport takeBugreport ()

Возьмите отчет об ошибке и верните его в объект Bugreport , чтобы обработать его.

abstract String uninstallPackage (String packageName)

Удалите пакет Android с устройства.

abstract String uninstallPackageForUser (String packageName, int userId)

Удалите пакет Android с устройства для данного пользователя.

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

можетSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Возвращает
boolean

Броски
DeviceNotAvailableException

проверитьПодключение

public abstract boolean checkConnectivity ()

Убедитесь, что устройство подключено к сети.

Возвращает
boolean true если устройство имеет работающее сетевое подключение, в противном случае — значение false .

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

ClearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

Возвращает
boolean true , если диалоги отсутствовали или диалоги были успешно очищены. false в противном случае.

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

ClearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

ConnectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Подключается к сети Wi-Fi.

Включает Wi-Fi и блокирует до тех пор, пока не будет установлено успешное соединение с одной из сетей Wi-Fi, указанных на карте wifiSsidToPsk. Как только соединение установлено, экземпляр будет пытаться восстановить соединение после каждой перезагрузки, пока не будет вызван ITestDevice#disconnectFromWifi() или ITestDevice#clearLastConnectedWifiNetwork() .

Параметры
wifiSsidToPsk : сопоставление SSID Wi-Fi с паролями.

scanSsid boolean : следует ли сканировать скрытые SSID для этой сети.

Возвращает
boolean true при успешном подключении к сети Wi-Fi. false в противном случае

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

ConnectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Подключается к сети Wi-Fi.

Включает Wi-Fi и блокирует до тех пор, пока не будет установлено успешное соединение с одной из сетей Wi-Fi, указанных на карте wifiSsidToPsk. Как только соединение установлено, экземпляр будет пытаться восстановить соединение после каждой перезагрузки, пока не будет вызван ITestDevice#disconnectFromWifi() или ITestDevice#clearLastConnectedWifiNetwork() .

Параметры
wifiSsidToPsk : сопоставление SSID Wi-Fi с паролями.

Возвращает
boolean true при успешном подключении к сети Wi-Fi. false в противном случае

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

ConnectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Подключается к сети Wi-Fi.

Включает Wi-Fi и блокирует до тех пор, пока не будет установлено успешное подключение к указанной сети Wi-Fi. Как только соединение установлено, экземпляр будет пытаться восстановить соединение после каждой перезагрузки, пока не будет вызван ITestDevice#disconnectFromWifi() или ITestDevice#clearLastConnectedWifiNetwork() .

Параметры
wifiSsid String : Wi-Fi ssid для подключения

wifiPsk String : парольная фраза PSK или ноль, если она не зашифрована.

Возвращает
boolean true при успешном подключении к сети Wi-Fi. false в противном случае

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

ConnectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Подключается к сети Wi-Fi.

Включает Wi-Fi и блокирует до тех пор, пока не будет установлено успешное подключение к указанной сети Wi-Fi. Как только соединение установлено, экземпляр будет пытаться восстановить соединение после каждой перезагрузки, пока не будет вызван ITestDevice#disconnectFromWifi() или ITestDevice#clearLastConnectedWifiNetwork() .

Параметры
wifiSsid String : Wi-Fi ssid для подключения

wifiPsk String : парольная фраза PSK или ноль, если она не зашифрована.

scanSsid boolean : следует ли сканировать скрытый SSID для этой сети.

Возвращает
boolean true при успешном подключении к сети Wi-Fi. false в противном случае

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

ConnectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

Параметры
scanSsid boolean : сканировать ли скрытый SSID для этой сети

Возвращает
boolean true при успешном подключении к сети Wi-Fi. false в противном случае

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

ConnectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Возвращает
boolean true при успешном подключении к сети Wi-Fi. false в противном случае

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

Создать пользователя

public abstract int createUser (String name)

Создайте пользователя с заданным именем и флагами по умолчанию 0.

Параметры
name String : пользователя для создания на устройстве

Возвращает
int целое число для созданного идентификатора пользователя

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

Создать пользователя

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

Создайте пользователя с заданным именем и предоставленными флагами

Параметры
name String : пользователя для создания на устройстве

guest boolean : включить пользовательский флаг --guest во время создания

ephemeral boolean : включить пользовательский флаг --ephemeral во время создания

forTesting boolean : включить тестовый флаг --for-testing во время создания

Возвращает
int id созданного пользователя

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

Создать пользователя

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Создайте пользователя с заданным именем и предоставленными флагами

Параметры
name String : пользователя для создания на устройстве

guest boolean : включить пользовательский флаг --guest во время создания

ephemeral boolean : включить пользовательский флаг --ephemeral во время создания

Возвращает
int id созданного пользователя

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

создатьUserNoThrow

public abstract int createUserNoThrow (String name)

Создайте пользователя с заданным именем и флагами по умолчанию 0.

Параметры
name String : пользователя для создания на устройстве

Возвращает
int целое число для созданного идентификатора пользователя или -1 для ошибки.

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

отменить регистрациюDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Удаляет зарегистрированный IDeviceActionReceiver .

Параметры
deviceActionReceiver IDeviceActionReceiver : IDeviceActionReceiver , который будет удален.

отключитьKeyguard

public abstract void disableKeyguard ()

Попытки отключить блокировку клавиатуры.

Сначала подождите, пока отправка ввода будет готова, это происходит примерно в то же время, когда устройство сообщает BOOT_COMPLETE, по-видимому, асинхронно, потому что текущая реализация фреймворка иногда имеет состояние гонки. Затем отправляется команда на отключение keyguard (работает только на незащищенных)

Броски
DeviceNotAvailableException

отключитьсетевоймонитор

public abstract boolean disableNetworkMonitor ()

Отключает мониторинг сети на устройстве.

Возвращает
boolean true , если мониторинг успешно отключен. false , если это не удалось.

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

отключить от Wi-Fi

public abstract boolean disconnectFromWifi ()

Отключается от сети Wi-Fi.

Удаляет все сети из списка известных сетей и отключает Wi-Fi.

Возвращает
boolean true при успешном отключении от сети Wi-Fi. false , если не удалось отключиться.

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

делаетFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

userId int : идентификатор пользователя, по которому нужно проверить существование файла.

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

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

дампКуча

public abstract File dumpHeap (String process, 
                String devicePath)

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

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

devicePath String : путь на устройстве, куда поместить дамп. Это должно быть место, где это разрешено разрешениями.

Возвращает
File ERROR(/File) , содержащий отчет. Нуль, если что-то не удалось.

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

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Включает мониторинг сети на устройстве.

Возвращает
boolean true , если мониторинг успешно включен. false , если это не удалось.

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

getActiveApexes

public abstract  getActiveApexes ()

Получить информацию об активированных на устройстве APEX.

Возвращает
ERROR(/Set) ApexInfo , активированная в данный момент на устройстве

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

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

public abstract  getAllSettings (String namespace)

Возвращает пары ключ-значение запрошенного пространства имен.

Параметры
namespace String : должна быть одной из {"system", "secure", "global"}

Возвращает
карта пар ключ-значение. Null, если пространство имен не поддерживается.

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

getAndroidId

public abstract String getAndroidId (int userId)

Найдите и верните идентификатор Android, связанный с идентификатором пользователя, ноль, если он не найден.

Параметры
userId int

Возвращает
String

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

getAndroidIds

public abstract  getAndroidIds ()

Создайте карту идентификаторов Android, найденных совпадающими с идентификаторами пользователей. Нет никакой гарантии, что каждый идентификатор пользователя найдет идентификатор Android, связанный с этой функцией, поэтому некоторые идентификаторы пользователей могут совпадать с нулевым значением.

Возвращает
Карта идентификаторов Android, соответствующих идентификаторам пользователей.

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

GetAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Получить информацию о пакете, установленном на устройстве.

Параметры
packageName String

Возвращает
PackageInfo PackageInfo или null , если информацию не удалось получить

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

getAppPackageInfos

public abstract  getAppPackageInfos ()

Получить информацию об установленных на устройстве пакетах.

Возвращает
ERROR(/List) PackageInfo , установленных на устройстве.

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

getBugreport

public abstract InputStreamSource getBugreport ()

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

Реализация этого гарантированно продолжит работу на устройстве без SD-карты (или там, где SD-карта еще не смонтирована).

Возвращает
InputStreamSource InputStreamSource , который будет создавать содержимое отчета об ошибке по запросу. В случае сбоя InputStreamSource выдаст пустую ERROR(/InputStream) .

получитьBugreportz

public abstract InputStreamSource getBugreportz ()

Получает отчет об ошибке с устройства. Отчет об ошибке в формате Zip содержит основной отчет об ошибке и другие файлы журнала, полезные для отладки.

Поддерживается только для версии adb > 1.0.36

Возвращает
InputStreamSource InputStreamSource zip-файла, содержащего отчет об ошибках, возвращает null в случае сбоя.

жеткуррентфолдаблестате

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Возвращает
DeviceFoldableState

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

getCurrentUser

public abstract int getCurrentUser ()

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

Возвращает
int

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

getFoldableStates

public abstract  getFoldableStates ()

Возвращает список складных состояний на устройстве. Можно получить с помощью «cmd device_state print-states».

Возвращает

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Получить имена пакетов приложений, присутствующих на устройстве.

Возвращает
ERROR(/Set) String имен пакетов, установленных в данный момент на устройстве.

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

получитьIpAddress

public abstract String getIpAddress ()

Получает IP-адрес устройства.

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

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

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

Возвращает объект, чтобы получить текущее состояние keyguard или null, если не поддерживается.

Возвращает
KeyguardControllerState KeyguardControllerState , содержащий моментальный снимок состояния keyguard, и возвращает Null, если запрос Keyguard не поддерживается.

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

получитьMainUserId

public abstract Integer getMainUserId ()

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

Возвращает
Integer userId основного пользователя, если он есть, и null, если основного пользователя нет.

Броски
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException если вывод устройства не такой, как ожидалось.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Получить информацию об основных модулях, установленных на устройстве.

Возвращает
ERROR(/Set) основных модулей String , установленных в данный момент на устройстве.

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Получите максимальное количество поддерживаемых пользователей. По умолчанию 0.

Возвращает
int целое число, указывающее количество поддерживаемых пользователей

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

getOptions

public abstract TestDeviceOptions getOptions ()

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

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Возвращает идентификатор основного пользователя.

Возвращает
Integer userId основного пользователя, если он есть, и null, если основного пользователя нет.

Броски
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException если вывод устройства не такой, как ожидалось.
DeviceNotAvailableException

получитьСкриншот

public abstract InputStreamSource getScreenshot ()

Делает снимок экрана с устройства.

Возвращает
InputStreamSource InputStreamSource снимка экрана в формате png или null , если снимок экрана не был успешным.

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

получитьСкриншот

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Делает снимок экрана с устройства. Рекомендуется использовать getScreenshot(String) вместо кодирования JPEG для меньшего размера.

Параметры
format String : поддерживается PNG, JPEG

rescale boolean : следует ли масштабировать снимок экрана, чтобы уменьшить размер результирующего изображения.

Возвращает
InputStreamSource InputStreamSource снимка экрана в формате или null , если снимок экрана не был успешным.

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

получитьСкриншот

public abstract InputStreamSource getScreenshot (String format)

Делает снимок экрана с устройства. Рекомендуется использовать getScreenshot(format) вместо кодирования JPEG для меньшего размера.

Параметры
format String : поддерживается PNG, JPEG

Возвращает
InputStreamSource InputStreamSource снимка экрана в формате или null , если снимок экрана не был успешным.

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

получитьСкриншот

public abstract InputStreamSource getScreenshot (long displayId)

Делает снимок экрана с устройства с заданным идентификатором дисплея. Формат — PNG.

TODO: расширить реализации выше для поддержки «формата» и «изменения масштаба»

Параметры
displayId long : идентификатор экрана, с которого нужно получить снимок экрана.

Возвращает
InputStreamSource InputStreamSource снимка экрана в формате или null , если снимок экрана не был успешным.

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

getSetting

public abstract String getSetting (String namespace, 
                String key)

См. getSetting(int, String, String) и выполняется для системного пользователя.

Параметры
namespace String

key String

Возвращает
String

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

getSetting

public abstract String getSetting (int userId, 
                String namespace, 
                String key)

Возвращает значение запрошенной настройки. пространство имен должно быть одним из: {"system", "secure", "global"}

Параметры
userId int

namespace String

key String

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

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

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

Возвращает
ERROR(/Set) имен удаляемых String пакетов, установленных в данный момент на устройстве.

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

getUserFlags

public abstract int getUserFlags (int userId)

Найти и вернуть флаги данного пользователя. Флаги определены в классе «android.content.pm.UserInfo» в проекте Android с открытым исходным кодом.

Параметры
userId int

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

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

getUserInfos

public abstract  getUserInfos ()

Получает карту useId для UserInfo на устройстве. Вызовет DeviceRuntimeException , если вывод с устройства не соответствует ожидаемому.

Возвращает
список объектов UserInfo.

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

получитьсерийный номер пользователя

public abstract int getUserSerialNumber (int userId)

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

Параметры
userId int

Возвращает
int

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

hasFeature

public abstract boolean hasFeature (String feature)

Проверьте, доступна ли функция на устройстве.

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

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

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

установитьПакет

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

Установите пакет Android на устройство.

Параметры
packageFile File : файл apk для установки

reinstall boolean : true , если необходимо выполнить переустановку

extraArgs String : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adb shell pm -h».

Возвращает
String String с кодом ошибки или null в случае успеха.

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

установитьПакет

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Установите пакет Android на устройство.

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

Параметры
packageFile File : файл apk для установки

reinstall boolean : true , если необходимо выполнить переустановку

grantPermissions boolean : должны ли все разрешения во время выполнения предоставляться во время установки

extraArgs String : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adb shell pm -h».

Возвращает
String String с кодом ошибки или null в случае успеха.

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

установитьПакетажефорузер

public abstract String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Установите пакет Android на устройство для данного пользователя.

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

Параметры
packageFile File : файл apk для установки

reinstall boolean : true , если необходимо выполнить переустановку

grantPermissions boolean : должны ли все разрешения во время выполнения предоставляться во время установки

userId int : целочисленный идентификатор пользователя для установки.

extraArgs String : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adb shell pm -h».

Возвращает
String String с кодом ошибки или null в случае успеха.

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

установитьПакетажефорузер

public abstract String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Установите пакет Android на устройство для данного пользователя.

Параметры
packageFile File : файл apk для установки

reinstall boolean : true , если необходимо выполнить переустановку

userId int : целочисленный идентификатор пользователя для установки.

extraArgs String : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adb shell pm -h».

Возвращает
String String с кодом ошибки или null в случае успеха.

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

установитьПакеты

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

Установите приложение для Android, состоящее из нескольких файлов APK (один основной и дополнительный разделенные пакеты). См. «https://developer.android.com/studio/build/configure-apk-splits» о том, как разделить apk на несколько файлов.

Параметры
packageFiles : локальные файлы apk

reinstall boolean : true , если необходимо выполнить переустановку

extraArgs String : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adb shell pm -h».

Возвращает
String String с кодом ошибки или null в случае успеха.

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

установитьПакеты

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Установите приложение для Android, состоящее из нескольких файлов APK (один основной и дополнительный разделенные пакеты), которые находятся на устройстве Android. См. «https://developer.android.com/studio/build/configure-apk-splits» о том, как разделить apk на несколько файлов.

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

Параметры
packageFiles : пути к удаленным файлам apk для установки

reinstall boolean : true , если необходимо выполнить переустановку

grantPermissions boolean : должны ли все разрешения во время выполнения предоставляться во время установки

extraArgs String : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adb shell pm -h».

Возвращает
String String с кодом ошибки или null в случае успеха.

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

установитьПакеты для пользователя

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Установите приложение Android, состоящее из нескольких файлов APK (один основной и дополнительный разделенные пакеты) для данного пользователя. См. «https://developer.android.com/studio/build/configure-apk-splits» о том, как разделить apk на несколько файлов.

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

Параметры
packageFiles : локальные файлы apk

reinstall boolean : true , если необходимо выполнить переустановку

grantPermissions boolean : должны ли все разрешения во время выполнения предоставляться во время установки

userId int : целочисленный идентификатор пользователя для установки.

extraArgs String : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adb shell pm -h».

Возвращает
String String с кодом ошибки или null в случае успеха.

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

установитьПакеты для пользователя

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Установите приложение Android, состоящее из нескольких файлов APK (один основной и дополнительный разделенные пакеты) для данного пользователя. См. «https://developer.android.com/studio/build/configure-apk-splits» о том, как разделить apk на несколько файлов.

Параметры
packageFiles : локальные файлы apk

reinstall boolean : true , если необходимо выполнить переустановку

userId int : целочисленный идентификатор пользователя для установки.

extraArgs String : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adb shell pm -h».

Возвращает
String String с кодом ошибки или null в случае успеха.

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

установитьRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

Установите приложение для Android, состоящее из нескольких файлов APK (один основной и дополнительный разделенные пакеты), которые находятся на устройстве Android. См. «https://developer.android.com/studio/build/configure-apk-splits» о том, как разделить apk на несколько файлов.

Параметры
remoteApkPaths : пути к удаленным файлам apk

reinstall boolean : true , если необходимо выполнить переустановку

extraArgs String : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adb shell pm -h».

Возвращает
String String с кодом ошибки или null в случае успеха.

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

установитьRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Установите приложение для Android, состоящее из нескольких файлов APK (один основной и дополнительный разделенные пакеты), которые находятся на устройстве Android. См. «https://developer.android.com/studio/build/configure-apk-splits» о том, как разделить apk на несколько файлов.

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

Параметры
remoteApkPaths : пути к удаленным файлам apk

reinstall boolean : true , если необходимо выполнить переустановку

grantPermissions boolean : должны ли все разрешения во время выполнения предоставляться во время установки

extraArgs String : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adb shell pm -h».

Возвращает
String String с кодом ошибки или null в случае успеха.

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

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

Возвращает
boolean

Броски
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

Возвращает
boolean

Броски
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Определяет, поддерживается ли многопользовательский режим.

Возвращает
boolean true, если поддерживается многопользовательский режим, иначе false

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

Параметры
packageName String

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

userId String : идентификатор пользователя, для которого мы проверяем, установлен ли пакет. Если null, будет использоваться нулевой первичный пользователь.

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

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

isUserRunning

public abstract boolean isUserRunning (int userId)

Проверьте, работает ли данный пользователь.

Параметры
userId int

Возвращает
boolean Истина, если пользователь работает, и ложь во всех остальных случаях.

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

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Параметры
userId int

Возвращает
boolean true, если пользователь является вторичным, иначе false.

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

isUserVisible

public abstract boolean isUserVisible (int userId)

Проверяет, виден ли данный пользователь.

«Видимый» пользователь — это пользователь, который взаимодействует с «человеком» и, следовательно, может запускать действия по запуску (обычно на дисплее по умолчанию).

Параметры
userId int

Возвращает
boolean

Броски
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Проверяет, виден ли данный пользователь на данном дисплее.

«Видимый» пользователь — это пользователь, который взаимодействует с «человеком» и, следовательно, может запускать действия запуска на этом дисплее.

Параметры
userId int

displayId int

Возвращает
boolean

Броски
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Возвращает значение, позволяющее устройству запускать пользователей в фоновом режиме в ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

Если это так, вы можете вызвать startVisibleBackgroundUser(int, int, boolean) , передав отображение, возвращаемое listDisplayIdsForStartingVisibleBackgroundUsers() (которое должно включать ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

Возвращает
boolean

Броски
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

Если это так, вы можете вызвать startVisibleBackgroundUser(int, int, boolean) , передав отображение, возвращаемое listDisplayIdsForStartingVisibleBackgroundUsers() .

Возвращает
boolean

Броски
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Проверьте, включен ли Wi-Fi.

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

Возвращает
boolean true если Wi-Fi включен. false , если отключено

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

списокDisplayIds

public abstract  listDisplayIds ()

Соберите список идентификаторов доступных дисплеев на устройстве, как сообщает «dumpsys SurfaceFlinger».

Возвращает
Список дисплеев. Default всегда возвращает дисплей по умолчанию 0.

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

списокDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

Получает список дисплеев, которые можно использовать для start a user visible in the background .

Возвращает

Броски
DeviceNotAvailableException

listПользователи

public abstract  listUsers ()

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

Возвращает
список идентификаторов пользователей.

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

logBugотчет

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

Параметры
dataName String : имя, под которым будет отправлен отчет об ошибке.

listener ITestLogger : ITestLogger для регистрации отчета об ошибке.

Возвращает
boolean True, если регистрация прошла успешно, в противном случае — false.

Рееструстройстводействийприемник

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Регистрирует IDeviceActionReceiver для этого устройства.

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

Параметры
deviceActionReceiver IDeviceActionReceiver : IDeviceActionReceiver , который будет зарегистрирован.

удалитьАдмин

public abstract boolean removeAdmin (String componentName, 
                int userId)

Удалите данного администратора устройства у данного пользователя и верните true , если он успешен, иначе false .

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

userId int : пользователя, под которым живет администратор устройства.

Возвращает
boolean True в случае успеха, false в противном случае.

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

удалитьВладельцы

public abstract void removeOwners ()

Приложите все усилия, чтобы удалить всех существующих владельцев профилей устройств.

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

удалить пользователя

public abstract boolean removeUser (int userId)

Remove a given user from the device.

Параметры
userId int : of the user to remove

Возвращает
boolean true if we were successful in removing the user, false otherwise.

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

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Set a device admin component as device owner in given user.

Параметры
componentName String : of device admin to be device owner.

userId int : of the user that the device owner lives in.

Возвращает
boolean True if it is successful, false otherwise.

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

setSetting

public abstract void setSetting (String namespace, 
                String key, 
                String value)

See setSetting(int, String, String, String) and performed on system user.

Параметры
namespace String

key String

value String

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

setSetting

public abstract void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}

Параметры
userId int

namespace String

key String

value String

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

startUser

public abstract boolean startUser (int userId)

Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.

Параметры
userId int : of the user to start in the background

Возвращает
boolean true if the user was successfully started in the background.

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

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.

Параметры
userId int : of the user to start in the background

waitFlag boolean : will make the command wait until user is started and unlocked.

Возвращает
boolean true if the user was successfully started in the background.

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

startVisibleBackgroundUser

public abstract boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).

NOTE: this command doesn't check if the user exists, display is available, device supports such feature , etc.

Параметры
userId int : of the user to start in the background

displayId int : display to start user visible on

waitFlag boolean : will make the command wait until user is started and unlocked.

Возвращает
boolean true if the user was successfully started visible in the background.

Броски
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.

Параметры
userId int : of the user to stop.

waitFlag boolean : will make the command wait until user is stopped.

forceFlag boolean : will force stop the user.

Возвращает
boolean true if the user was successfully stopped.

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

stopUser

public abstract boolean stopUser (int userId)

Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.

Параметры
userId int : of the user to stop.

Возвращает
boolean true if the user was successfully stopped.

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

switchUser

public abstract boolean switchUser (int userId)

Switch to another userId with a default timeout. switchUser(int, long) .

Параметры
userId int

Возвращает
boolean True if the new userId matches the userId provider. Ложь в противном случае.

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

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.

Параметры
userId int

timeout long : to wait before returning false for switch-user failed.

Возвращает
boolean True if the new userId matches the userId provider. Ложь в противном случае.

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

takeBugreport

public abstract Bugreport takeBugreport ()

Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close() .

Возвращает
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Uninstall an Android package from device.

Параметры
packageName String : the Android package to uninstall

Возвращает
String a String with an error code, or null if success.

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

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Uninstall an Android package from device for a given user.

Параметры
packageName String : the Android package to uninstall

userId int : the integer user id to uninstall for.

Возвращает
String a String with an error code, or null if success.

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