ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

---

Предоставляет надежный 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

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

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

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	Правда, если пользователь был успешно остановлен.

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

SwitchUser

public abstract boolean switchUser (int userId)

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

Параметры
userId	int

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

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

SwitchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

Параметры
userId	int
timeout	long : подождать, прежде чем вернуть False для выключения коммутатора.

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

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

TakeBugReport

public abstract Bugreport takeBugreport ()

Возьмите BugReport и возвращает его в объект Bugreport чтобы справиться с ним. Вернуть ноль в случае выпуска. Файл, упомянутый в объекте 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