ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


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

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

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

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

class ITestDevice.ApexInfo

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

class ITestDevice.MountPointInfo

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

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

abstract boolean canSwitchToHeadlessSystemUser ()

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

abstract boolean checkConnectivity ()

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

abstract boolean clearErrorDialogs ()

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

abstract void clearLastConnectedWifiNetwork ()

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

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

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

abstract boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) 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, связанный с идентификатором пользователя, нулевой, если он не найден.

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 ()

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

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

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, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)

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

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 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, 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 ()

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

Возврат
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 или ноль, если она не зашифрована.

Возврат
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 или ноль, если она не зашифрована.

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)

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

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

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

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

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

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

createUserNoThrow

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, по-видимому, асинхронно, поскольку в текущей реализации платформы время от времени возникает состояние гонки. Затем отправляется команда для отключения защиты клавиатуры (работает только на незащищенных устройствах).

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

делает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

включитьNetworkMonitor

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 : должна быть одной из {"системных", "безопасных", "глобальных"}.

Возврат
карта пар ключевых значений. Значение NULL, если пространство имен не поддерживается.

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

получитьAndroidId

public abstract String getAndroidId (int userId)

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

Параметры
userId int

Возврат
String

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

получитьAndroidIds

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) .

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

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

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

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

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

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

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

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

getMainUserId

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

получитьPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

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

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

getScreenshot

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

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

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

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

Возврат
InputStreamSource InputStreamSource снимка экрана в формате или null , если снимок экрана не удался.

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

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

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

Возврат
InputStreamSource InputStreamSource снимка экрана в формате или null , если снимок экрана не удался.

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

getScreenshot

public abstract InputStreamSource getScreenshot ()

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

Возврат
InputStreamSource InputStreamSource снимка экрана в формате png или null , если снимок экрана не удался.

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

getSetting

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

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

Параметры
userId int

namespace String

key String

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

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

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

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

Параметры
userId int

Возврат
int

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

имеет особенность

public abstract boolean hasFeature (String feature)

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

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

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

Броски
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 : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adbshell 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 : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adbshell 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 : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adbshell 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 : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adbshell pm -h».

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

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

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

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 : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adbshell 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 : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adbshell pm -h».

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

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

installPackagesForUser

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 : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adbshell pm -h».

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

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

installPackagesForUser

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 : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adbshell 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 : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adbshell 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 : необязательные дополнительные аргументы для передачи. Доступные параметры см. в разделе «adbshell 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 : идентификатор пользователя, для которого мы проверяем пакет, установлен. Если значение равно нулю, будет использоваться нулевой основной пользователь.

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

Параметры
packageName String

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

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

списокдисплейидс

public abstract  listDisplayIds ()

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

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

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

listDisplayIdsForStartingVisibleBackgroundUsers

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

журнал ошибок

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

зарегистрироватьдевицеактионрекивер

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 Истина, если операция успешна, и ложь в противном случае.

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

удалить владельцев

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 Истина, если операция успешна, и ложь в противном случае.

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

УстановитьНастройки

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

УстановитьНастройки

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

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

Параметры
userId int

namespace String

key String

value String

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

startUser

public abstract boolean startUser (int userId)

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

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

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

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

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

стоппользователь

public abstract boolean stopUser (int userId)

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

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

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

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

стоппользователь

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

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

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

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

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

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

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

переключательПользователь

public abstract boolean switchUser (int userId)

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

Параметры
userId int

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

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

переключательПользователь

public abstract boolean switchUser (int userId, 
                long timeout)

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

Параметры
userId int

timeout long : ждать, прежде чем вернуть false в случае сбоя переключения пользователя.

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

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

взятьBugreport

public abstract Bugreport takeBugreport ()

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

Возврат
Bugreport

удалить пакет

public abstract String uninstallPackage (String packageName)

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

Параметры
packageName String : пакет Android для удаления.

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

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

деинсталлироватьПакажефорюсер

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