Повторяет команды устройства в заданном количестве и предоставляет интерфейс восстановления устройства для устройств, которые не отвечают.
Вложенные классы |
---|
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 ()
Возвращает, разрешено ли переключение на безголового пользователя системы.
checkConnectivity
public abstract boolean checkConnectivity ()
Убедитесь, что устройство имеет подключение к сети.
Возврат |
---|
boolean | true , если устройство имеет работающее сетевое соединение, в противном случае false . |
ClearErrorDialogs
public abstract boolean clearErrorDialogs ()
Попытайтесь закрыть все диалоговые окна ошибок, отображаемые в настоящее время в пользовательском интерфейсе устройства.
Возврат |
---|
boolean | true , если диалоговые окна не присутствовали или диалоги были успешно очищены. false в противном случае. |
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 в противном случае |
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 в противном случае |
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 в противном случае |
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 в противном случае |
ConnectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Вариант connectToWifiNetwork(String, String)
, который подключается только в том случае, если устройство в данный момент не имеет подключения к сети.
Параметры |
---|
scanSsid | boolean : следует ли сканировать скрытый SSID для этой сети. |
Возврат |
---|
boolean | true , если подключение к сети Wi-Fi успешно. false в противном случае |
ConnectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk)
Вариант connectToWifiNetwork(String, String)
, который подключается только в том случае, если устройство в данный момент не имеет подключения к сети.
Возврат |
---|
boolean | true , если подключение к сети Wi-Fi успешно. false в противном случае |
создать пользователя
public abstract int createUser (String name)
Создайте пользователя с заданным именем и флагами по умолчанию 0.
Параметры |
---|
name | String : пользователя, которого нужно создать на устройстве. |
Возврат |
---|
int | целое число для созданного идентификатора пользователя |
создать пользователя
public abstract int createUser (String name,
boolean guest,
boolean ephemeral)
Создайте пользователя с заданным именем и предоставленными флагами.
Параметры |
---|
name | String : пользователя, которого нужно создать на устройстве. |
guest | boolean : включить пользовательский флаг --guest во время создания |
ephemeral | boolean : включить пользовательский флаг --ephemeral во время создания |
Возврат |
---|
int | идентификатор созданного пользователя |
создать пользователя
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 | идентификатор созданного пользователя |
createUserNoThrow
public abstract int createUserNoThrow (String name)
Создайте пользователя с заданным именем и флагами по умолчанию 0.
Параметры |
---|
name | String : пользователя, которого нужно создать на устройстве. |
Возврат |
---|
int | целое число для созданного идентификатора пользователя или -1 в случае ошибки. |
отключитьKeyguard
public abstract void disableKeyguard ()
Пытается отключить защиту клавиатуры.
Сначала дождитесь готовности отправки ввода. Это происходит примерно в то же время, когда устройство сообщает BOOT_COMPLETE, по-видимому, асинхронно, поскольку в текущей реализации платформы время от времени возникает состояние гонки. Затем отправляется команда для отключения защиты клавиатуры (работает только на незащищенных устройствах).
отключитьNetworkMonitor
public abstract boolean disableNetworkMonitor ()
Отключает мониторинг сети на устройстве.
Возврат |
---|
boolean | true , если мониторинг успешно отключен. false если это не удалось. |
отключить от Wi-Fi
public abstract boolean disconnectFromWifi ()
Отключается от сети Wi-Fi.
Удаляет все сети из списка известных сетей и отключает Wi-Fi.
Возврат |
---|
boolean | true , если успешно отключено от сети Wi-Fi. false если отключение не удалось. |
делаетFileExist
public abstract boolean doesFileExist (String deviceFilePath,
int userId)
Вспомогательный метод для определения наличия файла на устройстве для данного пользователя.
Параметры |
---|
deviceFilePath | String : абсолютный путь к файлу на устройстве для проверки. |
userId | int : идентификатор пользователя, по которому можно проверить существование файла. |
Возврат |
---|
boolean | true , если файл существует, в противном случае false . |
дампКуча
public abstract File dumpHeap (String process,
String devicePath)
Попытайтесь сбросить кучу с system_server. Ответственность за очистку сброшенного файла лежит на вызывающей стороне.
Параметры |
---|
process | String : имя процесса устройства, на который создается дамп кучи. |
devicePath | String : путь на устройстве, куда поместить дамп. Это должно быть место, где разрешения позволяют это. |
Возврат |
---|
File | ERROR(/File) содержащая отчет. Нуль, если что-то не удалось. |
включитьNetworkMonitor
public abstract boolean enableNetworkMonitor ()
Включает сетевой мониторинг на устройстве.
Возврат |
---|
boolean | true , если мониторинг включен успешно. false если это не удалось. |
getActiveApexes
public abstract getActiveApexes ()
Получите информацию об APEX, активированных на устройстве.
получить все настройки
public abstract getAllSettings (String namespace)
Возвращает пары ключ-значение запрошенного пространства имен.
Параметры |
---|
namespace | String : должна быть одной из {"системных", "безопасных", "глобальных"}. |
Возврат |
---|
| карта пар ключевых значений. Значение NULL, если пространство имен не поддерживается. |
получитьAndroidId
public abstract String getAndroidId (int userId)
Найдите и верните идентификатор Android, связанный с идентификатором пользователя, нулевой, если он не найден.
получитьAndroidIds
public abstract getAndroidIds ()
Создайте карту идентификаторов Android, найденных совпадающими с идентификаторами пользователей. Нет никакой гарантии, что каждый идентификатор пользователя найдет идентификатор Android, связанный с этой функцией, поэтому некоторые идентификаторы пользователей могут соответствовать нулю.
Возврат |
---|
| На карте идентификаторов Android найдены соответствующие идентификаторы пользователей. |
getAppPackageInfo
public abstract PackageInfo getAppPackageInfo (String packageName)
Получить информацию о пакете, установленном на устройстве.
Параметры |
---|
packageName | String |
getAppPackageInfos
public abstract getAppPackageInfos ()
Получите информацию о пакетах, установленных на устройстве.
getBugreport
public abstract InputStreamSource getBugreport ()
Получает отчет об ошибке с устройства.
Реализация этого гарантированно продолжит работать на устройстве без SD-карты (или где SD-карта еще не смонтирована).
getBugreportz
public abstract InputStreamSource getBugreportz ()
Получает отчет об ошибке с устройства. Отчет об ошибках в формате ZIP содержит основной отчет об ошибках и другие файлы журналов, полезные для отладки.
Поддерживается только для версии adb > 1.0.36.
getCurrentFoldableState
public abstract DeviceFoldableState getCurrentFoldableState ()
Возвращает текущее состояние складного устройства или значение NULL, если возникли какие-либо проблемы.
getCurrentUser
public abstract int getCurrentUser ()
Возвращает идентификатор текущего работающего пользователя. В случае ошибки верните -10000.
getFoldableStates
public abstract getFoldableStates ()
Возвращает список складных состояний на устройстве. Можно получить с помощью «cmd device_state print-states».
getInstalledPackageNames
public abstract getInstalledPackageNames ()
Получите имена пакетов приложений, присутствующих на устройстве.
Возврат |
---|
| ERROR(/Set) имен String пакетов, установленных в данный момент на устройстве. |
получитьIpAddress
public abstract String getIpAddress ()
Получает IP-адрес устройства.
Возврат |
---|
String | IP-адрес устройства или null , если у устройства нет IP-адреса |
getKeyguardState
public abstract KeyguardControllerState getKeyguardState ()
Верните объект, чтобы получить текущее состояние защиты клавиатуры или значение null, если оно не поддерживается.
getMainUserId
public abstract Integer getMainUserId ()
Возвращает основной идентификатор пользователя.
Возврат |
---|
Integer | userId основного пользователя, если он есть, и значение null, если основного пользователя нет. |
getMainlineModuleInfo
public abstract getMainlineModuleInfo ()
Получите информацию об основных модулях, установленных на устройстве.
Возврат |
---|
| ERROR(/Set) основных модулей String , установленных в данный момент на устройстве. |
public abstract int getMaxNumberOfRunningUsersSupported ()
Получите максимальное количество поддерживаемых одновременно работающих пользователей. По умолчанию 0.
Возврат |
---|
int | целое число, указывающее количество одновременно работающих пользователей |
public abstract int getMaxNumberOfUsersSupported ()
Получите максимальное количество поддерживаемых пользователей. По умолчанию 0.
Возврат |
---|
int | целое число, указывающее количество поддерживаемых пользователей |
getOptions
public abstract TestDeviceOptions getOptions ()
Получите параметры тестирования для устройства.
получитьPrimaryUserId
public abstract Integer getPrimaryUserId ()
Возвращает основной идентификатор пользователя.
Возврат |
---|
Integer | userId основного пользователя, если он есть, и значение null, если основного пользователя нет. |
getScreenshot
public abstract InputStreamSource getScreenshot (String format,
boolean rescale)
Делает скриншот с устройства. Рекомендуется использовать getScreenshot(String)
вместо кодировки JPEG для меньшего размера.
Параметры |
---|
format | String : поддерживается PNG, JPEG. |
rescale | boolean : если снимок экрана необходимо масштабировать, чтобы уменьшить размер результирующего изображения. |
getScreenshot
public abstract InputStreamSource getScreenshot (long displayId)
Делает снимок экрана с устройства с заданным идентификатором дисплея. Формат: PNG.
ЗАДАЧА: расширить приведенные выше реализации для поддержки «форматирования» и «масштабирования».
Параметры |
---|
displayId | long : идентификатор экрана, с которого нужно получить снимок экрана. |
getScreenshot
public abstract InputStreamSource getScreenshot (String format)
Делает скриншот с устройства. Рекомендуется использовать getScreenshot(format) вместо кодировки JPEG для меньшего размера.
Параметры |
---|
format | String : поддерживается PNG, JPEG. |
getScreenshot
public abstract InputStreamSource getScreenshot ()
Делает скриншот с устройства.
getSetting
public abstract String getSetting (int userId,
String namespace,
String key)
Верните значение запрошенного параметра. пространство имен должно быть одним из: {"системный", "безопасный", "глобальный"}
Параметры |
---|
userId | int |
namespace | String |
key | String |
Возврат |
---|
String | значение, связанное с пространством имен: ключ пользователя. Нуль, если не найден. |
getSetting
public abstract String getSetting (String namespace,
String key)
См. getSetting(int, String, String)
и выполняется для системного пользователя.
Параметры |
---|
namespace | String |
key | String |
getUninstallablePackageNames
public abstract getUninstallablePackageNames ()
Получите имена пакетов приложений, которые можно удалить. В настоящее время это определяется как несистемные пакеты и обновленные системные пакеты.
Возврат |
---|
| ERROR(/Set) имен неустановимых String пакетов, установленных в настоящее время на устройстве. |
getUserFlags
public abstract int getUserFlags (int userId)
Найдите и верните флаги данного пользователя. Флаги определяются в классе «android.content.pm.UserInfo» в проекте Android с открытым исходным кодом.
Возврат |
---|
int | флаги, связанные с предоставленным идентификатором пользователя, если они найдены, -10000 в любых других случаях. |
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 в любых других случаях.
имеет особенность
public abstract boolean hasFeature (String feature)
Проверьте, доступна ли функция на устройстве.
Параметры |
---|
feature | String : какой формат должен быть "feature: " или " " напрямую. |
Возврат |
---|
boolean | True, если функция найдена, в противном случае — false. |
установитьПакет
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 в случае успеха. |
установитьПакет
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 в случае успеха. |
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 ()
Возвращает, использует ли устройство пользовательский режим безголовой системы.
isMainUserPermanentAdmin
public abstract boolean isMainUserPermanentAdmin ()
Возвращает, является ли основной пользователь постоянным администратором и его нельзя удалить или понизить до статуса без администратора.
isMultiUserSupported
public abstract boolean isMultiUserSupported ()
Определяет, поддерживается ли многопользовательский режим.
Возврат |
---|
boolean | true, если поддерживается многопользовательский режим, в противном случае — false |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName,
String userId)
Запросите у устройства заданное имя пакета и заданный идентификатор пользователя, чтобы проверить, установлено ли оно в данный момент для этого пользователя или нет.
Параметры |
---|
packageName | String : пакет, который мы проверяем, установлен ли он. |
userId | String : идентификатор пользователя, для которого мы проверяем пакет, установлен. Если значение равно нулю, будет использоваться нулевой основной пользователь. |
Возврат |
---|
boolean | Истинно, если пакет указан как установленный. В противном случае неверно. |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName)
Запросите у устройства заданное имя пакета, чтобы проверить, установлен ли он в данный момент или нет.
Параметры |
---|
packageName | String |
Возврат |
---|
boolean | Истинно, если пакет указан как установленный. В противном случае неверно. |
isUserRunning
public abstract boolean isUserRunning (int userId)
Проверьте, работает ли данный пользователь.
Возврат |
---|
boolean | True, если пользователь работает, и false во всех остальных случаях. |
isUserSecondary
public abstract boolean isUserSecondary (int userId)
Возвращает информацию о том, является ли указанный пользователь дополнительным пользователем в соответствии с его флагами.
Возврат |
---|
boolean | true, если пользователь является второстепенным, в противном случае — false. |
isUserVisible
public abstract boolean isUserVisible (int userId)
Проверяет, виден ли данный пользователь.
«Видимый» пользователь — это пользователь, который взаимодействует с «человеком» и, следовательно, может запускать действия по запуску (обычно на дисплее по умолчанию).
isUserVisibleOnDisplay
public abstract boolean isUserVisibleOnDisplay (int userId,
int displayId)
Проверяет, виден ли данный пользователь на данном дисплее.
«Видимый» пользователь — это пользователь, который взаимодействует с «человеком»-пользователем и, следовательно, может запускать действия по запуску на этом дисплее.
Параметры |
---|
userId | int |
displayId | int |
isWiFiEnabled
public abstract boolean isWifiEnabled ()
Проверьте, включен ли Wi-Fi.
Проверяет, включен ли Wi-Fi на устройстве. Полезно для подтверждения статуса Wi-Fi перед тестами, которые не должны выполняться с Wi-Fi, например, тестами мобильных данных.
Возврат |
---|
boolean | true , если Wi-Fi включен. false если отключено |
списокдисплейидс
public abstract listDisplayIds ()
Соберите список идентификаторов доступных дисплеев на устройстве, как сообщает «dumpsys SurfaceFlinger».
Возврат |
---|
| Список дисплеев. Default всегда возвращает отображение по умолчанию 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public abstract listDisplayIdsForStartingVisibleBackgroundUsers ()
Получает список дисплеев, которые можно использовать, чтобы start a user visible in the background
.
списокПользователи
public abstract listUsers ()
Получает список пользователей на устройстве. Вызовет DeviceRuntimeException
, если вывод с устройства не соответствует ожиданиям.
Возврат |
---|
| список идентификаторов пользователей. |
Броски |
---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException | |
журнал ошибок
public abstract boolean logBugreport (String dataName,
ITestLogger listener)
Вспомогательный метод для получения отчета об ошибке и его передачи репортерам.
Параметры |
---|
dataName | String : имя, под которым будет сообщаться об ошибке. |
listener | ITestLogger : ITestLogger для регистрации отчета об ошибке. |
Возврат |
---|
boolean | True, если регистрация прошла успешно, в противном случае — false. |
уведомитьSnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
Сообщите устройству, чтобы оно дождалось завершения snapuserd.
Параметры |
---|
waitPhase | SnapuserdWaitPhase |
удалить администратора
public abstract boolean removeAdmin (String componentName,
int userId)
Удалите данного администратора устройства у данного пользователя и верните true
если операция прошла успешно, в противном случае — false
.
Параметры |
---|
componentName | String : администратора устройства, который необходимо удалить. |
userId | int : пользователя, у которого живет администратор устройства. |
Возврат |
---|
boolean | Истина, если операция успешна, и ложь в противном случае. |
удалить владельцев
public abstract void removeOwners ()
Удалите всех существующих владельцев профилей устройств, приложив все усилия.
удалить пользователя
public abstract boolean removeUser (int userId)
Удалить данного пользователя с устройства.
Параметры |
---|
userId | int : пользователя, которого нужно удалить |
Возврат |
---|
boolean | true, если нам удалось удалить пользователя, в противном случае — false. |
setDeviceOwner
public abstract boolean setDeviceOwner (String componentName,
int userId)
Установите компонент администратора устройства в качестве владельца устройства для данного пользователя.
Параметры |
---|
componentName | String : администратор устройства будет владельцем устройства. |
userId | int : пользователя, под которым проживает владелец устройства. |
Возврат |
---|
boolean | Истина, если операция успешна, и ложь в противном случае. |
УстановитьНастройки
public abstract void setSetting (String namespace,
String key,
String value)
См. setSetting(int, String, String, String)
и выполняется для системного пользователя.
Параметры |
---|
namespace | String |
key | String |
value | String |
УстановитьНастройки
public abstract void setSetting (int userId,
String namespace,
String key,
String value)
Добавьте значение параметра в пространство имен данного пользователя. Некоторые настройки будут доступны только после перезагрузки. пространство имен должно быть одним из: {"системный", "безопасный", "глобальный"}
Параметры |
---|
userId | int |
namespace | String |
key | String |
value | String |
startUser
public abstract boolean startUser (int userId)
Запускает данного пользователя в фоновом режиме, если он в данный момент остановлен. Если пользователь уже работает в фоновом режиме, этот метод является NOOP.
Параметры |
---|
userId | int : пользователя, который запускается в фоновом режиме |
Возврат |
---|
boolean | true, если пользователь был успешно запущен в фоновом режиме. |
startUser
public abstract boolean startUser (int userId,
boolean waitFlag)
Запускает данного пользователя в фоновом режиме, если он в данный момент остановлен. Если пользователь уже работает в фоновом режиме, этот метод является NOOP. Можно указать дополнительный флаг для ожидания эффекта операции.
Параметры |
---|
userId | int : пользователя, который запускается в фоновом режиме |
waitFlag | boolean : заставит команду ждать, пока пользователь не запустится и не разблокируется. |
Возврат |
---|
boolean | true, если пользователь был успешно запущен в фоновом режиме. |
startVisibleBackgroundUser
public abstract boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Запускает данного пользователя в фоновом режиме, видимом на данном дисплее (т. е. позволяя пользователю запускать действия на этом дисплее).
ПРИМЕЧАНИЕ. Эта команда не проверяет, существует ли пользователь, доступен ли дисплей, device supports such feature
и т. д.
Параметры |
---|
userId | int : пользователя, который запускается в фоновом режиме |
displayId | int : дисплей, на котором пользователь будет виден |
waitFlag | boolean : заставит команду ждать, пока пользователь не запустится и не разблокируется. |
Возврат |
---|
boolean | true если пользователь был успешно запущен в фоновом режиме. |
стоппользователь
public abstract boolean stopUser (int userId)
Останавливает данного пользователя. Если пользователь уже остановлен, этот метод является NOOP. Невозможно остановить текущего пользователя и пользователя системы.
Параметры |
---|
userId | int : пользователя, которого нужно остановить. |
Возврат |
---|
boolean | true, если пользователь был успешно остановлен. |
стоппользователь
public abstract boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Остановить данного пользователя. Можно предоставить дополнительные флаги для ожидания эффекта операции и принудительного завершения работы пользователя. Невозможно остановить текущего пользователя и пользователя системы.
Параметры |
---|
userId | int : пользователя, которого нужно остановить. |
waitFlag | boolean : заставит команду ждать, пока пользователь не будет остановлен. |
forceFlag | boolean : принудительно остановит пользователя. |
Возврат |
---|
boolean | true, если пользователь был успешно остановлен. |
переключательПользователь
public abstract boolean switchUser (int userId)
Переключитесь на другой идентификатор пользователя с таймаутом по умолчанию. switchUser(int, long)
.
Возврат |
---|
boolean | Истинно, если новый идентификатор пользователя соответствует поставщику идентификаторов пользователей. В противном случае неверно. |
переключательПользователь
public abstract boolean switchUser (int userId,
long timeout)
Переключитесь на другой идентификатор пользователя с указанным тайм-аутом в качестве крайнего срока. Попытайтесь отключить защиту клавиатуры после успешной смены пользователя.
Параметры |
---|
userId | int |
timeout | long : ждать, прежде чем вернуть false в случае сбоя переключения пользователя. |
Возврат |
---|
boolean | Истинно, если новый идентификатор пользователя соответствует поставщику идентификаторов пользователей. В противном случае неверно. |
взятьBugreport
public abstract Bugreport takeBugreport ()
Возьмите отчет об ошибке и верните его в объект Bugreport
для его обработки. Верните ноль в случае проблемы. Файл, на который ссылается объект Bugreport, необходимо очистить с помощью Bugreport.close()
.
удалить пакет
public abstract String uninstallPackage (String packageName)
Удалите пакет Android с устройства.
Параметры |
---|
packageName | String : пакет Android для удаления. |
Возврат |
---|
String | String с кодом ошибки или null в случае успеха. |
деинсталлироватьПакажефорюсер
public abstract String uninstallPackageForUser (String packageName,
int userId)
Удалите пакет Android с устройства для данного пользователя.
Параметры |
---|
packageName | String : пакет Android для удаления. |
userId | int : целочисленный идентификатор пользователя, для которого требуется удалить. |
Возврат |
---|
String | String с кодом ошибки или null в случае успеха. |
waitForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
Если ожидается, дождитесь завершения snapuserd.
Параметры |
---|
currentPhase | SnapuserdWaitPhase |
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-10 UTC.
[null,null,["Последнее обновление: 2024-11-10 UTC."],[],[]]