ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Предоставляет надежный и несколько более высокоуровневый API для IDevice , использующего ddmlib.

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

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

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

class ITestDevice.ApexInfo

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

class ITestDevice.MountPointInfo

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

Общедоступные методы

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

Установите пакет Android на устройство с помощью команды adb.

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

Установите пакет Android на устройство с помощью команды adb.

abstract boolean canSwitchToHeadlessSystemUser ()

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

abstract boolean checkConnectivity ()

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

abstract boolean clearErrorDialogs ()

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

abstract void clearLastConnectedWifiNetwork ()

Удаляет последнюю подключенную сеть Wi-Fi.

default boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk, boolean scanSsid)

Этот метод устарел. Используйте вместо него connectToWifiNetworkWithResult(Map,boolean) .

default boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk)

Этот метод устарел. Используйте вместо него connectToWifiNetworkWithResult(Map) .

default boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Этот метод устарел. Используйте вместо него connectToWifiNetworkWithResult(String,String) .

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

Этот метод устарел. Используйте вместо него connectToWifiNetworkWithResult(String,String,boolean) .

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

Этот метод устарел. Используйте вместо него connectToWifiNetworkIfNeededWithResult(String,String,boolean) .

default boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

Этот метод устарел. Используйте вместо него connectToWifiNetworkIfNeededWithResult(String,String) .

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, String wifiPsk, boolean scanSsid)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, String wifiPsk)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, String wifiPsk, boolean scanSsid)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk, boolean scanSsid)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, String wifiPsk)

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

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 Set< ITestDevice.ApexInfo > getActiveApexes ()

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

abstract Map<String, String> getAllSettings (String namespace)

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

abstract String getAndroidId (int userId)

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

abstract Map<Integer, String> getAndroidIds ()

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

abstract PackageInfo getAppPackageInfo (String packageName)

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

abstract List< PackageInfo > getAppPackageInfos ()

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

abstract InputStreamSource getBugreport ()

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

abstract InputStreamSource getBugreportz ()

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

abstract DeviceFoldableState getCurrentFoldableState ()

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

abstract int getCurrentUser ()

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

abstract Set< DeviceFoldableState > getFoldableStates ()

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

abstract Set<String> getInstalledPackageNames ()

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

abstract String getIpAddress ()

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

abstract KeyguardControllerState getKeyguardState ()

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

abstract Integer getMainUserId ()

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

abstract Set<String> getMainlineModuleInfo ()

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

abstract int getMaxNumberOfRunningUsersSupported ()

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

abstract int getMaxNumberOfUsersSupported (String userType)

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

abstract int getMaxNumberOfUsersSupported ()

Этот метод устарел. Используйте getMaxNumberOfUsersSupported(String userType), чтобы получить максимальное количество поддерживаемых пользователей для заданного типа пользователей.

abstract TestDeviceOptions getOptions ()

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

abstract Integer getPrimaryUserId ()

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

abstract int getRemainingCreatableUserCount (String userType)

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

abstract InputStreamSource getScreenshot (Long displayId, String format, boolean rescale)

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

abstract InputStreamSource getScreenshot (String format, boolean rescale)

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

abstract InputStreamSource getScreenshot (String format)

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

abstract InputStreamSource getScreenshot (long displayId)

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

abstract InputStreamSource getScreenshot ()

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

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

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

abstract String getSetting (String namespace, String key)

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

abstract Set<String> getUninstallablePackageNames ()

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

abstract int getUserFlags (int userId)

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

abstract Map<Integer, UserInfo > getUserInfos ()

Получает сопоставление useId и UserInfo на устройстве.

abstract int getUserSerialNumber (int userId)

Возвращает серийный номер, связанный с userId, если он найден, -10000 в остальных случаях.

abstract int getUserVisibleOnDisplay (int displayId)

Получает идентификатор пользователя, видимого на заданном экране.

abstract boolean hasFeature (String feature)

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

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

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

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

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

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

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

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

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

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

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

default String installPackages (List<File> packageFiles, boolean reinstall, String... extraArgs)

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

default String installPackages (List<File> packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

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

default String installPackagesForUser (List<File> packageFiles, boolean reinstall, int userId, String... extraArgs)

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

default String installPackagesForUser (List<File> packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

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

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 Set<Long> listDisplayIds ()

Получите список идентификаторов доступных дисплеев на устройстве, предоставленный программой "dumpsys SurfaceFlinger".

abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

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

abstract ArrayList<Integer> 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.

Общедоступные методы

adbInstallPackage 

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

Установите пакет Android на устройство с помощью команды adb.

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

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

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

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

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

adbInstallPackage 

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

Установите пакет Android на устройство с помощью команды adb.

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

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

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

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

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

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

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

canSwitchToHeadlessSystemUser 

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Возвраты
boolean

Броски
DeviceNotAvailableException

проверка подключения 

public abstract boolean checkConnectivity ()

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

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

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

clearErrorDialogs 

public abstract boolean clearErrorDialogs ()

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

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

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

clearLastConnectedWifiNetwork 

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork 

public boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

Этот метод устарел.
Вместо этого используйте connectToWifiNetworkWithResult(Map,boolean) .

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

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

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

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

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

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

connectToWifiNetwork 

public boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk)

Этот метод устарел.
Вместо этого используйте connectToWifiNetworkWithResult(Map) .

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

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

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

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

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

connectToWifiNetwork 

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Этот метод устарел.
Вместо этого используйте connectToWifiNetworkWithResult(String,String) .

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

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

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

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

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

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

connectToWifiNetwork 

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

Этот метод устарел.
Вместо этого используйте connectToWifiNetworkWithResult(String,String,boolean) .

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

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

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

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

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

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

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

При необходимости подключитесь к сети Wi-Fi. 

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

Этот метод устарел.
Вместо этого используйте connectToWifiNetworkIfNeededWithResult(String,String,boolean) .

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

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

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

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

При необходимости подключитесь к сети Wi-Fi. 

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Этот метод устарел.
Вместо этого используйте connectToWifiNetworkIfNeededWithResult(String,String) .

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

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

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

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

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

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

Возвраты
IWifiHelper.WifiConnectionResult Объект WifiConnectionResult указывает на состояние соединения.

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

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

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk)

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

Возвраты
IWifiHelper.WifiConnectionResult Объект WifiConnectionResult указывает на состояние соединения.

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

connectToWifiNetworkWithResult 

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

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

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

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

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

Возвраты
IWifiHelper.WifiConnectionResult Объект WifiConnectionResult указывает на состояние соединения.

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

connectToWifiNetworkWithResult 

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk)

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

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

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

Возвраты
IWifiHelper.WifiConnectionResult Объект WifiConnectionResult указывает на состояние соединения.

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

connectToWifiNetworkWithResult 

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

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

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

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

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

Возвраты
IWifiHelper.WifiConnectionResult Объект WifiConnectionResult указывает на состояние соединения.

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

connectToWifiNetworkWithResult 

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk)

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

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

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

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

Возвраты
IWifiHelper.WifiConnectionResult Объект WifiConnectionResult указывает на состояние соединения.

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

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

public abstract int createUser (String name)

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

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

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

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

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

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
IllegalStateException

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

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
IllegalStateException

createUserNoThrow 

public abstract int createUserNoThrow (String name)

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

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

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

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

deregisterDeviceActionReceiver 

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

disableKeyguard 

public abstract void disableKeyguard ()

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

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

Броски
DeviceNotAvailableException

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

public abstract boolean disableNetworkMonitor ()

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

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

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

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

public abstract boolean disconnectFromWifi ()

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

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

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

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

doesFileExist 

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

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

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

dumpHeap 

public abstract File dumpHeap (String process, 
                String devicePath)

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

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

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

Возвраты
File File , содержащий отчёт. Значение null, если что-то пошло не так.

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

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

public abstract boolean enableNetworkMonitor ()

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

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

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

getActiveApexes 

public abstract Set<ITestDevice.ApexInfo> getActiveApexes ()

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

Возвраты
Set< ITestDevice.ApexInfo > На устройстве активирован Set функций ApexInfo .

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

getAllSettings 

public abstract Map<String, String> getAllSettings (String namespace)

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

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

Возвраты
Map<String, String> Карта пар ключ-значение. Значение равно null, если пространство имен не поддерживается.

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

getAndroidId 

public abstract String getAndroidId (int userId)

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

Параметры
userId int

Возвраты
String

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

getAndroidIds 

public abstract Map<Integer, String> getAndroidIds ()

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

Возвраты
Map<Integer, String> Карта найденных идентификаторов 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 List<PackageInfo> getAppPackageInfos ()

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

Возвраты
List< PackageInfo > List пакетов PackageInfo , установленных на устройстве.

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

getBugreport 

public abstract InputStreamSource getBugreport ()

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

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

Возвраты
InputStreamSource Объект InputStreamSource , который будет генерировать содержимое отчета об ошибке по запросу. В случае сбоя InputStreamSource создаст пустой InputStream .

getBugreportz 

public abstract InputStreamSource getBugreportz ()

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

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

Возвраты
InputStreamSource InputStreamSource это объект, содержащий zip-файл с отчетом об ошибке; в случае сбоя возвращает 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 Set<DeviceFoldableState> getFoldableStates ()

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

Возвраты
Set< DeviceFoldableState >

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

getInstalledPackageNames 

public abstract Set<String> getInstalledPackageNames ()

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

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

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

получить IP-адрес 

public abstract String getIpAddress ()

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

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

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

getKeyguardState 

public abstract KeyguardControllerState getKeyguardState ()

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

Возвраты
KeyguardControllerState Объект KeyguardControllerState содержит снимок состояния блокировки клавиатуры и возвращает Null, если запрос Keyguard не поддерживается.

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

getMainUserId 

public abstract Integer getMainUserId ()

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

Возвраты
Integer Идентификатор пользователя (userId) основного пользователя, если он есть, и null, если основного пользователя нет.

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

getMainlineModuleInfo 

public abstract Set<String> getMainlineModuleInfo ()

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

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

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

Параметры
userType String : тип пользователя, определенный в UserManager, например, "android.os.usertype.full.SECONDARY".

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

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

getMaxNumberOfUsersSupported 

public abstract int getMaxNumberOfUsersSupported ()

Этот метод устарел.
Используйте функцию getMaxNumberOfUsersSupported(String userType), чтобы получить максимальное количество поддерживаемых пользователей для заданного типа пользователей.

Укажите максимальное количество поддерживаемых переключаемых пользователей, не включая гостей. После версии API 36 это количество не включает пользователей, не подлежащих переключению (например, профили). По умолчанию — 0.

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

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

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

public abstract TestDeviceOptions getOptions ()

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

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

getPrimaryUserId 

public abstract Integer getPrimaryUserId ()

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

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

Возвраты
Integer Идентификатор пользователя (userId) основного пользователя, если таковой имеется, и null, если основного пользователя нет.

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

getRemainingCreatableUserCount 

public abstract int getRemainingCreatableUserCount (String userType)

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

Параметры
userType String : тип пользователя, определенный в UserManager, например, "android.os.usertype.full.SECONDARY".

Возвраты
int Сколько пользователей данного типа можно добавить?

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

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

public abstract InputStreamSource getScreenshot (Long displayId, 
                String format, 
                boolean rescale)

Делает снимок экрана с устройства с заданным идентификатором дисплея в поддерживаемом формате. Разрешается масштабирование для поддержки меньших размеров.

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

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

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

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

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

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

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

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

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

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

public abstract InputStreamSource getScreenshot (String format)

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

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

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

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

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

public abstract InputStreamSource getScreenshot (long displayId)

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

TODO: расширить приведенные выше реализации для поддержки функций 'format' и 'rescale'.

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

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

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

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

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)

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

Параметры
userId int

namespace String

key String

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

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

getSetting 

public abstract String getSetting (String namespace, 
                String key)

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

Параметры
namespace String

key String

Возвраты
String

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

getUninstallablePackageNames 

public abstract Set<String> getUninstallablePackageNames ()

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

Возвраты
Set<String> 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 Map<Integer, UserInfo> getUserInfos ()

Получает карту соответствия useId и UserInfo на устройстве. Если выходные данные с устройства не соответствуют ожиданиям, будет выброшено исключение DeviceRuntimeException .

Возвраты
Map<Integer, UserInfo > список объектов UserInfo.

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

getUserSerialNumber 

public abstract int getUserSerialNumber (int userId)

Возвращает серийный номер, связанный с userId, если он найден, -10000 в остальных случаях.

Параметры
userId int

Возвраты
int

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

getUserVisibleOnDisplay 

public abstract int getUserVisibleOnDisplay (int displayId)

Получает идентификатор пользователя, видимого на заданном экране.

Параметры
displayId int : идентификатор дисплея.

Возвраты
int Идентификатор пользователя, видимого на данном экране. Он не различает видимого фонового пользователя от текущего активного пользователя, поскольку оба типа являются видимыми. Для дальнейшего различения сравните с результатом вызова getCurrentUser().

Броски
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, 
                boolean grantPermissions, 
                String... extraArgs)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

installPackageForUser 

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

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

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

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

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

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

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

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

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

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

installPackageForUser 

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

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

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

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

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

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

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

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

installPackageWithIncrementalMode 

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

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

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

extraArgs String

userId String

Возвраты
boolean

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

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

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                String... extraArgs)

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

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

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

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

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

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

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

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

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

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

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

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

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

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

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

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

installPackagesForUser 

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

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

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

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

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

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

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

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

installPackagesForUser 

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

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

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

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

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

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

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

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

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

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

isHeadlessSystemUserMode 

public abstract boolean isHeadlessSystemUserMode ()

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

Возвраты
boolean

Броски
DeviceNotAvailableException

isMainUserPermanentAdmin 

public abstract boolean isMainUserPermanentAdmin ()

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

Возвраты
boolean

Броски
DeviceNotAvailableException

isMultiUserSupported 

public abstract boolean isMultiUserSupported ()

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

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

This also checks config_enableMultiUserUI. By demand, we are allowed to assume that devices for which this is true are configured to allow adding secondary users via adb.

Возвраты
boolean whether the device supports multiple switchable users.

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

isPackageInstalled 

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Query the device for a given package name and given user id to check if it's currently installed or not for that user.

Параметры
packageName String : the package we are checking if it's installed.

userId String : The user id we are checking the package is installed for. If null, primary user zero will be used.

Возвраты
boolean True if the package is reported as installed. False otherwise.

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

isPackageInstalled 

public abstract boolean isPackageInstalled (String packageName)

Query the device for a given package name to check if it's currently installed or not.

Параметры
packageName String

Возвраты
boolean True if the package is reported as installed. False otherwise.

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

isUserRunning 

public abstract boolean isUserRunning (int userId)

Check if a given user is running.

Параметры
userId int

Возвраты
boolean True if the user is running, false in every other cases.

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

isUserSecondary 

public abstract boolean isUserSecondary (int userId)

Return whether the specified user is a secondary user according to it's flags.

Параметры
userId int

Возвраты
boolean true if the user is secondary, false otherwise.

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

isUserVisible 

public abstract boolean isUserVisible (int userId)

Checks if the given user is visible.

A "visible" user is a user that is interacting with the "human" user and hence is able to launch launch activities (typically in the default display).

Параметры
userId int

Возвраты
boolean

Броски
DeviceNotAvailableException

isUserVisibleOnDisplay 

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Checks if the given user is visible in the given display.

A "visible" user is a user that is interacting with the "human" user and hence is able to launch launch activities in that display.

Параметры
userId int

displayId int

Возвраты
boolean

Броски
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported 

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Returns whether the device allow users to be started visible in the background in the ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

If it does, you could call startVisibleBackgroundUser(int, int, boolean) , passing a display returned by listDisplayIdsForStartingVisibleBackgroundUsers() (which should include ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

Возвраты
boolean

Броски
DeviceNotAvailableException

isVisibleBackgroundUsersSupported 

public abstract boolean isVisibleBackgroundUsersSupported ()

Returns whether the device allow users to be started visible in the background.

If it does, you could call startVisibleBackgroundUser(int, int, boolean) , passing a display returned by listDisplayIdsForStartingVisibleBackgroundUsers() .

Возвраты
boolean

Броски
DeviceNotAvailableException

isWifiEnabled 

public abstract boolean isWifiEnabled ()

Test if wifi is enabled.

Checks if wifi is enabled on device. Useful for asserting wifi status before tests that shouldn't run with wifi, eg mobile data tests.

Возвраты
boolean true if wifi is enabled. false if disabled

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

listDisplayIds 

public abstract Set<Long> listDisplayIds ()

Collect the list of available displays id on the device as reported by "dumpsys SurfaceFlinger".

Возвраты
Set<Long> The list of displays. Default always returns the default display 0.

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

listDisplayIdsForStartingVisibleBackgroundUsers 

public abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

Gets the list of displays that can be used to start a user visible in the background .

Возвраты
Set<Integer>

Броски
DeviceNotAvailableException

listUsers 

public abstract ArrayList<Integer> listUsers ()

Gets the list of users on the device. Will throw DeviceRuntimeException if output from device is not as expected.

Возвраты
ArrayList<Integer> the list of user ids.

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

logBugreport 

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Helper method to take a bugreport and log it to the reporters.

Параметры
dataName String : name under which the bugreport will be reported.

listener ITestLogger : an ITestLogger to log the bugreport.

Возвраты
boolean True if the logging was successful, false otherwise.

notifySnapuserd 

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Notify the device to wait for snapuserd completion.

Параметры
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver 

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registers a IDeviceActionReceiver for this device.

All registered IDeviceActionReceiver s will be notified before a device action starts and after the device action ends.

Параметры
deviceActionReceiver IDeviceActionReceiver : A IDeviceActionReceiver which will be registered.

removeAdmin 

public abstract boolean removeAdmin (String componentName, 
                int userId)

Remove given device admin in given user and return true if it is successful, false otherwise.

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

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

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

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

removeOwners 

public abstract void removeOwners ()

Remove all existing device profile owners with the best effort.

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

removeUser 

public abstract boolean removeUser (int userId)

Remove a given user from the device.

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

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

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

setDeviceOwner 

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

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

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

setSetting 

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

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

Параметры
namespace String

key String

value String

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

setSetting 

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

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

Параметры
userId int

namespace String

key String

value String

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

startUser 

public abstract boolean startUser (int userId)

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

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

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

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

startUser 

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

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

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

startVisibleBackgroundUser 

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

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

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

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

displayId int : display to start user visible on

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

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

Броски
DeviceNotAvailableException

stopUser 

public abstract boolean stopUser (int userId)

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

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

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

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

stopUser 

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

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

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

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

forceFlag boolean : will force stop the user.

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

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

switchUser 

public abstract boolean switchUser (int userId)

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

Параметры
userId int

Возвраты
boolean True if the new userId matches the userId provider. False otherwise.

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

switchUser 

public abstract boolean switchUser (int userId, 
                long timeout)

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

Параметры
userId int

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

Возвраты
boolean True if the new userId matches the userId provider. False otherwise.

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

takeBugreport 

public abstract Bugreport takeBugreport ()

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

Возвраты
Bugreport

uninstallPackage 

public abstract String uninstallPackage (String packageName)

Uninstall an Android package from device.

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

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

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

uninstallPackageForUser 

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Uninstall an Android package from device for a given user.

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

userId int : the integer user id to uninstall for.

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

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

waitForSnapuserd 

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

If expected, wait for snapuserd to complete.

Параметры
currentPhase SnapuserdWaitPhase

Броски
DeviceNotAvailableException