Тестовое устройство

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

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

Тестовое устройство

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

можетSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

ClearErrorDialogs

public boolean clearErrorDialogs ()

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

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

public int createUser (String name)

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

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

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

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

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

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

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

создатьUserNoThrow

public int createUserNoThrow (String name)

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

отключитьKeyguard

public void disableKeyguard ()

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

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

делаетFileExist

public boolean doesFileExist (String deviceFilePath)

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

делаетFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

дампКуча

public File dumpHeap (String process, 
                String devicePath)

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

getActiveApexes

public  getActiveApexes ()

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

получить все настройки

public  getAllSettings (String namespace)

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

getAndroidId

public String getAndroidId (int userId)

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

getAndroidIds

public  getAndroidIds ()

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

GetAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

getAppPackageInfos

public  getAppPackageInfos ()

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

getBugreport

public InputStreamSource getBugreport ()

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

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

получитьBugreportz

public InputStreamSource getBugreportz ()

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

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

жеткуррентфолдаблестате

public DeviceFoldableState getCurrentFoldableState ()

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

getCurrentUser

public int getCurrentUser ()

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

getFoldableStates

public  getFoldableStates ()

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

getInstalledPackageNames

public  getInstalledPackageNames ()

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

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

получитьMainUserId

public Integer getMainUserId ()

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

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

getPrimaryUserId

public Integer getPrimaryUserId ()

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

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

public InputStreamSource getScreenshot ()

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

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

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

public InputStreamSource getScreenshot (String format)

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

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

public InputStreamSource getScreenshot (long displayId)

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

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

getSetting

public String getSetting (String namespace, 
                String key)

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

getSetting

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

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

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

getUserFlags

public int getUserFlags (int userId)

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

getUserInfos

public  getUserInfos ()

Получает карту useId для UserInfo на устройстве. Вызовет DeviceRuntimeException , если вывод с устройства не соответствует ожидаемому.

получитьсерийный номер пользователя

public int getUserSerialNumber (int userId)

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

hasFeature

public boolean hasFeature (String feature)

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

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

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

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

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

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

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

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

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

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

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

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

установитьПакетажефорузер

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

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

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

установитьПакетажефорузер

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

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

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

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

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

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

установитьПакеты для пользователя

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

установитьПакеты для пользователя

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

установитьRemotePackages

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

установитьRemotePackages

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

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

isMultiUserSupported

public boolean isMultiUserSupported ()

Определяет, поддерживается ли многопользовательский режим.

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

isUserRunning

public boolean isUserRunning (int userId)

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

isUserSecondary

public boolean isUserSecondary (int userId)

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

isUserVisible

public boolean isUserVisible (int userId)

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

«Видимый» пользователь — это пользователь, который взаимодействует с «человеком» и, следовательно, может запускать действия по запуску (обычно на дисплее по умолчанию).

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

«Видимый» пользователь — это пользователь, который взаимодействует с «человеком» и, следовательно, может запускать действия запуска на этом дисплее.

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Возвращает значение, позволяющее устройству запускать пользователей в фоновом режиме в ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

Если это так, вы можете вызвать startVisibleBackgroundUser(int, int, boolean) , передав отображение, возвращаемое listDisplayIdsForStartingVisibleBackgroundUsers() (которое должно включать ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

Если это так, вы можете вызвать startVisibleBackgroundUser(int, int, boolean) , передав отображение, возвращаемое listDisplayIdsForStartingVisibleBackgroundUsers() .

списокDisplayIds

public  listDisplayIds ()

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

списокDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

listПользователи

public  listUsers ()

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

logBugотчет

public boolean logBugreport (String dataName, 
                ITestLogger listener)

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

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

удалитьАдмин

public boolean removeAdmin (String componentName, 
                int userId)

Удалите данного администратора устройства у данного пользователя и верните true , если он успешен, иначе false .

удалитьВладельцы

public void removeOwners ()

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

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

public boolean removeUser (int userId)

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

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

setSetting

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

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

setSetting

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

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

выключениеMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Выключает устройство microdroid, если оно существует.

startUser

public boolean startUser (int userId)

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

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

startVisibleBackgroundUser

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

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

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

остановитьпользователя

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

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

остановитьпользователя

public boolean stopUser (int userId)

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

поддерживаетMicrodroid

public boolean supportsMicrodroid ()

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

поддерживаетMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

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

поменять пользователя

public boolean switchUser (int userId)

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

поменять пользователя

public boolean switchUser (int userId, 
                long timeout)

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

возьмисообщить об ошибке

public Bugreport takeBugreport ()

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

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

public String uninstallPackage (String packageName)

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

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

public String uninstallPackageForUser (String packageName, 
                int userId)

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

создатьпарсер

protected AaptParser createParser (File appFile)

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

Выполните перезагрузку adb.

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

getBugreportzInternal

protected File getBugreportzInternal ()

Внутренний вспомогательный метод для получения zip-файла bugreportz как ERROR(/File) .

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Выставлен на тестирование.

getHostCurrentTime

protected long getHostCurrentTime ()

Выставлено для тестирования

prePostBootSetup

protected void prePostBootSetup ()

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