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)

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

abstract boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

Подключается к сети 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)

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

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

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

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-id, связанный с userId, или null, если не найден.

abstract getAndroidIds ()

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

abstract PackageInfo getAppPackageInfo (String packageName)

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

abstract getAppPackageInfos ()

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

abstract InputStreamSource getBugreport ()

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

abstract InputStreamSource getBugreportz ()

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

abstract DeviceFoldableState getCurrentFoldableState ()

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

abstract int getCurrentUser ()

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

abstract getFoldableStates ()

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

abstract getInstalledPackageNames ()

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

abstract String getIpAddress ()

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

abstract KeyguardControllerState getKeyguardState ()

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

abstract Integer getMainUserId ()

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

abstract getMainlineModuleInfo ()

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

abstract int getMaxNumberOfRunningUsersSupported ()

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

abstract int getMaxNumberOfUsersSupported ()

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

abstract TestDeviceOptions getOptions ()

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

abstract Integer getPrimaryUserId ()

Этот метод устарел. Метод getPrimaryUser устарел из сервиса UserManager. Используйте ERROR(/android.os.UserManager#getMainUserId()) для получения первого полноправного пользователя или 0 для системы. Обратите внимание, что для системы без интерфейса это не полноправный пользователь.

abstract InputStreamSource getScreenshot (String format, boolean rescale)

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

abstract InputStreamSource getScreenshot (long displayId)

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

abstract InputStreamSource getScreenshot (String format)

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

abstract InputStreamSource getScreenshot ()

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

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

Верните значение запрошенного параметра.

abstract String getSetting (String namespace, String key)

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

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, int userId, String... extraArgs)

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

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

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

abstract boolean installPackageWithIncrementalMode (File[] apkFiles, String[] extraArgs, String userId)

Устанавливает APK-файлы в инкрементном режиме.

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

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

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

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

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

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

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

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

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

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

default String 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, String userId)

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

abstract boolean isPackageInstalled (String packageName)

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

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)

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

default void notifySnapuserd ( SnapuserdWaitPhase waitPhase)

Уведомить устройство о необходимости дождаться завершения работы snapuserd.

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)

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

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

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

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 с устройства определенного пользователя.

default void waitForSnapuserd ( SnapuserdWaitPhase currentPhase)

Если ожидается, дождитесь завершения работы snapuserd.

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

canSwitchToHeadlessSystemUser 

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Возврат
boolean

Броски
DeviceNotAvailableException

checkConnectivity 

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)

Подключается к сети 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 ( 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 (String wifiSsid, 
                String wifiPsk)

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

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

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

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

Возврат
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 : SSID Wi-Fi для подключения

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

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

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

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

Подключиться к сети Wi-Fi, если необходимо 

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

Подключиться к сети Wi-Fi, если необходимо 

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

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

createUser 

public abstract int createUser (String name)

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

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

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

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

createUser 

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

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

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

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

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

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

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

createUser 

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 идентификатор созданного пользователя

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

createUserNoThrow 

public abstract int createUserNoThrow (String name)

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

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

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

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

deregisterDeviceActionReceiver 

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

отключить защиту клавиатуры 

public abstract void disableKeyguard ()

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

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

Броски
DeviceNotAvailableException

отключить NetworkMonitor 

public abstract boolean disableNetworkMonitor ()

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

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

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

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

public abstract boolean disconnectFromWifi ()

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

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

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

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

doesFileExist 

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

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

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

dumpHeap 

public abstract File dumpHeap (String process, 
                String devicePath)

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

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

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

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

Броски
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

получитьAndroidId 

public abstract String getAndroidId (int userId)

Найти и вернуть android-id, связанный с userId, или null, если не найден.

Параметры
userId int

Возврат
String

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

получитьAndroidIds 

public abstract  getAndroidIds ()

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

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

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

получитьAppPackageInfo 

public abstract PackageInfo getAppPackageInfo (String packageName)

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

Параметры
packageName String

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

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

получитьAppPackageInfos 

public abstract  getAppPackageInfos ()

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

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

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

getBugreport 

public abstract InputStreamSource getBugreport ()

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

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

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

getBugreportz 

public abstract InputStreamSource getBugreportz ()

Извлекает bugreportz с устройства. ZIP-архив bugreport содержит основной bugreport и другие файлы журнала, полезные для отладки.

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

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

получитьCurrentFoldableState 

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Возврат
DeviceFoldableState

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

получить текущего пользователя 

public abstract int getCurrentUser ()

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

Возврат
int

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

получитьFoldableStates 

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

получитьKeyguardState 

public abstract KeyguardControllerState getKeyguardState ()

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

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

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

получитьMainUserId 

public abstract Integer getMainUserId ()

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

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

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

получитьMainlineModuleInfo 

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

получитьMaxNumberOfUsersSupported 

public abstract int getMaxNumberOfUsersSupported ()

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

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

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

получитьПараметры 

public abstract TestDeviceOptions getOptions ()

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

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

получитьPrimaryUserId 

public abstract Integer getPrimaryUserId ()

Этот метод устарел.
Функция getPrimaryUser устарела в сервисе UserManager. Используйте ERROR(/android.os.UserManager#getMainUserId()) для получения первого полноправного пользователя или 0 для системы. Обратите внимание, что для системы без графического интерфейса это не полноправный пользователь.

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

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

Броски
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException если выходные данные устройства не соответствуют ожидаемым.
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 (long displayId)

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

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

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

Возврат
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 ()

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

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

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

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

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

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

Параметры
userId int

namespace String

key String

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

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

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

public abstract String getSetting (String namespace, 
                String key)

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

Параметры
namespace String

key String

Возврат
String

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

getUninstallablePackageNames 

public abstract  getUninstallablePackageNames ()

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

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

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

получитьUserFlags 

public abstract int getUserFlags (int userId)

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

Параметры
userId int

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

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

получитьUserInfos 

public abstract  getUserInfos ()

Получает сопоставление useId с UserInfo на устройстве. Выдаёт исключение DeviceRuntimeException если выходные данные устройства не соответствуют ожидаемым.

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

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

получитьUserSerialNumber 

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 True, если признак найден, в противном случае — false.

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

installPackage 

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

installPackage 

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

installPackageForUser 

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

installPackageForUser 

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

installPackageWithIncrementalMode 

public abstract boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

Устанавливает APK-файлы в инкрементном режиме.

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

extraArgs String

userId String

Возврат
boolean

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

installPackages 

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

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

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

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

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

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

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

installPackages 

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

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

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

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

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

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

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

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

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

installPackagesForUser 

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

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

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

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

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

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

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

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

installPackagesForUser 

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

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

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

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

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

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

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

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

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

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

installRemotePackages 

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

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

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

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

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

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

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

installRemotePackages 

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

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

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

Параметры
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, 
                String userId)

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

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

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

Возврат
boolean True, если пакет установлен. В противном случае — False.

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

isPackageInstalled 

public abstract boolean isPackageInstalled (String packageName)

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

Параметры
packageName String

Возврат
boolean True, если пакет установлен. В противном случае — False.

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

isUserRunning 

public abstract boolean isUserRunning (int userId)

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

Параметры
userId int

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

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

listDisplayIds 

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

списокПользователи 

public abstract  listUsers ()

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

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

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

logBugreport 

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

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

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

уведомитьSnapuserd 

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Уведомить устройство о необходимости дождаться завершения работы snapuserd.

Параметры
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver 

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

removeOwners 

public abstract void removeOwners ()

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

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

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

public abstract boolean removeUser (int userId)

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

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

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

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

setDeviceOwner 

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

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

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

setSetting 

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

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

Параметры
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)

Добавьте значение параметра в пространство имён указанного пользователя. Некоторые параметры будут доступны только после перезагрузки. Пространство имён должно быть одним из: {"system", "secure", "global"}

Параметры
userId int

namespace String

key String

value String

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

startUser 

public abstract boolean startUser (int userId)

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

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

Возврат
boolean true, если пользователь был успешно запущен в фоновом режиме.

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

startUser 

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

waitFlag boolean : заставит команду ждать, пока пользователь не будет запущен и разблокирован.

Возврат
boolean true, если пользователь был успешно запущен в фоновом режиме.

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

startVisibleBackgroundUser 

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

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

ПРИМЕЧАНИЕ: эта команда не проверяет, существует ли пользователь, доступен ли дисплей, device supports such feature и т. д.

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

displayId int : отображать, чтобы начать отображение пользователя

waitFlag boolean : заставит команду ждать, пока пользователь не будет запущен и разблокирован.

Возврат
boolean true если пользователь был успешно запущен и виден в фоновом режиме.

Броски
DeviceNotAvailableException

stopUser 

public abstract boolean stopUser (int userId)

Останавливает указанного пользователя. Если пользователь уже остановлен, этот метод недействителен. Невозможно остановить текущего и системного пользователя.

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

Возврат
boolean true, если пользователь был успешно остановлен.

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

stopUser 

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

Остановить заданного пользователя. Можно добавить дополнительные флаги для ожидания выполнения операции и принудительного завершения пользователя. Невозможно остановить текущего и системного пользователя.

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

waitFlag boolean : заставит команду ждать, пока пользователь не остановится.

forceFlag boolean : принудительно остановит пользователя.

Возврат
boolean true, если пользователь был успешно остановлен.

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

switchUser 

public abstract boolean switchUser (int userId)

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

Параметры
userId int

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

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

switchUser 

public abstract boolean switchUser (int userId, 
                long timeout)

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

Параметры
userId int

timeout long : ожидание перед возвратом false для switch-user failed.

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

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

takeBugreport 

public abstract Bugreport takeBugreport ()

Принимает отчёт об ошибке и возвращает его в объект Bugreport для обработки. В случае возникновения проблемы возвращает null. Файл, на который ссылается объект Bugreport, необходимо очистить с помощью Bugreport.close() .

Возврат
Bugreport

uninstallPackage 

public abstract String uninstallPackage (String packageName)

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

Параметры
packageName String : пакет Android, который нужно удалить

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

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

uninstallPackageForUser 

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

Параметры
packageName String : пакет Android, который нужно удалить

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

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

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

waitForSnapuserd 

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Если ожидается, дождитесь завершения работы snapuserd.

Параметры
currentPhase SnapuserdWaitPhase

Броски
DeviceNotAvailableException