Dispositivo de prueba

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Comandos que se pueden usar para descartar el bloqueo del teclado.

Dispositivo de prueba

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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Devuelve si está permitido cambiar al usuario del SISTEMA sin cabeza.

borrar diálogos de error

public boolean clearErrorDialogs ()

Intente descartar los cuadros de diálogo de error que se muestran actualmente en la interfaz de usuario del dispositivo.

crear usuario

public int createUser (String name)

Cree un usuario con un nombre dado y banderas predeterminadas 0.

crear usuario

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

Cree un usuario con un nombre dado y las banderas proporcionadas

crear usuario

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

Cree un usuario con un nombre dado y las banderas proporcionadas

crearUsuarioNoLanzar

public int createUserNoThrow (String name)

Cree un usuario con un nombre dado y banderas predeterminadas 0.

desactivar Keyguard

public void disableKeyguard ()

Intenta desactivar el bloqueo del teclado.

Primero espere a que el envío de entrada esté listo, esto sucede casi al mismo tiempo cuando el dispositivo informa BOOT_COMPLETE, aparentemente de forma asíncrona, porque la implementación del marco actual tiene una condición de carrera ocasional. Luego se envía el comando para descartar el bloqueo del teclado (solo funciona en los que no son seguros)

existe el archivo

public boolean doesFileExist (String deviceFilePath)

Método auxiliar para determinar si existe un archivo en el dispositivo.

existe el archivo

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Método auxiliar para determinar si existe un archivo en el dispositivo para un usuario determinado.

basurero

public File dumpHeap (String process, 
                String devicePath)

Intente volcar el montón de system_server. Es responsabilidad de la persona que llama limpiar el archivo volcado.

getActiveApexes

public  getActiveApexes ()

Obtenga la información sobre los APEX activados en el dispositivo.

getAllSettings

public  getAllSettings (String namespace)

Devuelve pares de valores clave del espacio de nombres solicitado.

obtenerAndroidId

public String getAndroidId (int userId)

Busque y devuelva el ID de Android asociado a un ID de usuario, nulo si no se encuentra.

obtener ID de Android

public  getAndroidIds ()

Cree un mapa de ID de Android que coincidan con los ID de usuario. No hay garantía de que cada identificación de usuario encuentre una identificación de Android asociada en esta función, por lo que algunas identificaciones de usuario pueden coincidir con nulas.

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Obtenga información sobre un paquete instalado en el dispositivo.

getAppPackageInfos

public  getAppPackageInfos ()

Obtener información de los paquetes instalados en el dispositivo.

obtener informe de error

public InputStreamSource getBugreport ()

Recupera un informe de error del dispositivo.

Se garantiza que la implementación de esto continúe funcionando en un dispositivo sin una tarjeta SD (o donde la tarjeta SD aún no está montada).

getBugreportz

public InputStreamSource getBugreportz ()

Recupera un bugreportz del dispositivo. El informe de errores en formato zip contiene el informe de errores principal y otros archivos de registro que son útiles para la depuración.

Solo compatible con 'versión adb' > 1.0.36

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Devuelve el estado plegable actual del dispositivo o nulo si ocurrieron algunos problemas.

obtenerUsuarioActual

public int getCurrentUser ()

Devuelve la identificación del usuario actual en ejecución. En caso de error, devuelve -10000.

getFoldableStates

public  getFoldableStates ()

Devuelve la lista de estados plegables en el dispositivo. Se puede obtener con "cmd device_state print-states".

getInstalledPackageNames

public  getInstalledPackageNames ()

Obtenga los nombres de los paquetes de aplicaciones presentes en el dispositivo.

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Devuelve un objeto para obtener el estado actual del bloqueo de teclado o nulo si no es compatible.

getMainUserId

public Integer getMainUserId ()

Devuelve el ID de usuario principal.

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Obtenga la información sobre los módulos principales instalados en el dispositivo.

getMaxNumberOfRunningUsersSoportado

public int getMaxNumberOfRunningUsersSupported ()

Obtenga la cantidad máxima de usuarios compatibles que se ejecutan simultáneamente. El valor predeterminado es 0.

getMaxNumberOfUsersSoportado

public int getMaxNumberOfUsersSupported ()

Obtenga el número máximo de usuarios admitidos. El valor predeterminado es 0.

getPrimaryUserId

public Integer getPrimaryUserId ()

Devuelve el ID de usuario principal.

obtener captura de pantalla

public InputStreamSource getScreenshot ()

Toma una captura de pantalla del dispositivo.

obtener captura de pantalla

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Toma una captura de pantalla del dispositivo. Se recomienda usar getScreenshot(String) en lugar de la codificación JPEG para un tamaño más pequeño.

obtener captura de pantalla

public InputStreamSource getScreenshot (String format)

Toma una captura de pantalla del dispositivo. Se recomienda usar getScreenshot (formato) en lugar de la codificación JPEG para un tamaño más pequeño

obtener captura de pantalla

public InputStreamSource getScreenshot (long displayId)

Toma una captura de pantalla del dispositivo con la identificación de pantalla dada. El formato es PNG.

TODO: ampliar las implementaciones anteriores para admitir 'formato' y 'reescalado'

getSetting

public String getSetting (String namespace, 
                String key)

Ver getSetting(int, String, String) y realizado en el usuario del sistema.

getSetting

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

Devuelve el valor de la configuración solicitada. el espacio de nombres debe ser uno de: {"sistema", "seguro", "global"}

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Obtenga los nombres de los paquetes de aplicaciones que se pueden desinstalar. Esto se define actualmente como paquetes que no son del sistema y paquetes del sistema actualizados.

getUserFlags

public int getUserFlags (int userId)

Encuentra y devuelve las banderas de un usuario determinado. Los indicadores se definen en la clase "android.content.pm.UserInfo" en el proyecto de código abierto de Android.

getUserInfos

public  getUserInfos ()

Obtiene el mapa de useId a UserInfo en el dispositivo. Lanzará DeviceRuntimeException si la salida del dispositivo no es la esperada.

getUserSerialNumber

public int getUserSerialNumber (int userId)

Devuelve el número de serie asociado al ID de usuario si se encuentra, -10000 en cualquier otro caso.

tieneCaracterística

public boolean hasFeature (String feature)

Compruebe si una función está disponible en un dispositivo.

paquete de instalación

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

Instale un paquete de Android en el dispositivo.

paquete de instalación

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

Instale un paquete de Android en el dispositivo.

Nota: Solo los casos de uso que requieran un control explícito de la concesión de permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta función.

paquete de instalación

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

Instale un paquete de Android en el dispositivo.

Nota: Solo los casos de uso que requieran un control explícito de la concesión de permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta función.

instalarPaqueteParaUsuario

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

Instale un paquete de Android en el dispositivo para un usuario determinado.

Nota: Solo los casos de uso que requieran un control explícito de la concesión de permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta función.

instalarPaqueteParaUsuario

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

Instale un paquete de Android en el dispositivo para un usuario determinado.

instalarPaquetes

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

instalarPaquetes

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

instalarPaquetesParaUsuario

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

instalarPaquetesParaUsuario

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

instalar paquetes remotos

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

instalar paquetes remotos

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

isAppEnumerationSoportado

public boolean isAppEnumerationSupported ()

Compruebe si la plataforma en el dispositivo admite la enumeración de aplicaciones

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Devuelve si el dispositivo usa el modo de usuario del sistema sin cabeza.

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

Devuelve si el usuario principal es un administrador permanente y no se puede eliminar o degradar al estado de no administrador.

es multiusuario compatible

public boolean isMultiUserSupported ()

Determina si se admite multiusuario.

esPaqueteInstalado

public boolean isPackageInstalled (String packageName)

Consulte el dispositivo por un nombre de paquete dado para verificar si está instalado actualmente o no.

esPaqueteInstalado

public boolean isPackageInstalled (String packageName, 
                String userId)

Consulte el dispositivo para obtener un nombre de paquete dado y una identificación de usuario dada para verificar si está instalado actualmente o no para ese usuario.

isUserRunning

public boolean isUserRunning (int userId)

Compruebe si un usuario determinado se está ejecutando.

esUsuarioSecundario

public boolean isUserSecondary (int userId)

Devuelve si el usuario especificado es un usuario secundario según sus indicadores.

esUsuarioVisible

public boolean isUserVisible (int userId)

Comprueba si el usuario dado es visible.

Un usuario "visible" es un usuario que interactúa con el usuario "humano" y, por lo tanto, puede iniciar actividades de lanzamiento (normalmente en la pantalla predeterminada).

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Comprueba si el usuario dado está visible en la pantalla dada.

Un usuario "visible" es un usuario que interactúa con el usuario "humano" y, por lo tanto, puede iniciar actividades de lanzamiento en esa pantalla.

isVisibleBackgroundUsersOnDefaultDisplaySoportado

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Devuelve si el dispositivo permite que los usuarios se inicien visibles en segundo plano en el ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

Si es así, puede llamar startVisibleBackgroundUser(int, int, boolean) , pasando una pantalla devuelta por listDisplayIdsForStartingVisibleBackgroundUsers() (que debe incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

isVisibleBackgroundUsersSoportado

public boolean isVisibleBackgroundUsersSupported ()

Devuelve si el dispositivo permite que los usuarios se inicien visibles en segundo plano.

Si es así, podría llamar startVisibleBackgroundUser(int, int, boolean) y pasar una pantalla devuelta por listDisplayIdsForStartingVisibleBackgroundUsers() .

listDisplayIds

public  listDisplayIds ()

Recopile la lista de ID de pantallas disponibles en el dispositivo según lo informado por "dumpsys SurfaceFlinger".

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Obtiene la lista de pantallas que se pueden usar para start a user visible in the background .

listaUsuarios

public  listUsers ()

Obtiene la lista de usuarios en el dispositivo. Lanzará DeviceRuntimeException si la salida del dispositivo no es la esperada.

informe de error de registro

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Método de ayuda para tomar un informe de error y registrarlo para los reporteros.

postInvocaciónDerribar

public void postInvocationTearDown (Throwable exception)

Pasos adicionales para la limpieza requerida específica del dispositivo que se ejecutará después de que se realice la invocación.

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Elimine el administrador del dispositivo dado en el usuario dado y devuelva true si tiene éxito, false de lo contrario.

removePropietarios

public void removeOwners ()

Elimine todos los propietarios de perfiles de dispositivos existentes con el mejor esfuerzo.

eliminarUsuario

public boolean removeUser (int userId)

Eliminar un usuario determinado del dispositivo.

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Establezca un componente de administración del dispositivo como propietario del dispositivo en un usuario determinado.

establecerConfiguración

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

Consulte setSetting(int, String, String, String) y se realiza en el usuario del sistema.

establecerConfiguración

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

Agregue un valor de configuración al espacio de nombres de un usuario determinado. Algunas configuraciones solo estarán disponibles después de un reinicio. el espacio de nombres debe ser uno de: {"sistema", "seguro", "global"}

apagarMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Apaga el dispositivo microdroid, si existe.

inicioUsuario

public boolean startUser (int userId)

Inicia un usuario determinado en segundo plano si actualmente está detenido. Si el usuario ya se está ejecutando en segundo plano, este método es NOOP.

inicioUsuario

public boolean startUser (int userId, 
                boolean waitFlag)

Inicia un usuario determinado en segundo plano si actualmente está detenido. Si el usuario ya se está ejecutando en segundo plano, este método es NOOP. Es posible proporcionar un indicador adicional para esperar a que la operación tenga efecto.

startVisibleBackgroundUser

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

Inicia un usuario determinado en segundo plano, visible en la pantalla dada (es decir, permite que el usuario inicie actividades en esa pantalla).

NOTA: este comando no verifica si el usuario existe, si la pantalla está disponible, device supports such feature , etc.

detenerUsuario

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

Detener a un usuario determinado. Es posible proporcionar indicadores adicionales para esperar a que la operación tenga efecto y forzar la finalización del usuario. No se puede detener al usuario actual y del sistema.

detenerUsuario

public boolean stopUser (int userId)

Detiene a un usuario determinado. Si el usuario ya está detenido, este método es un NOOP. No se puede detener al usuario actual y del sistema.

es compatible con Microdroid

public boolean supportsMicrodroid ()

Comprueba las condiciones previas para ejecutar un microdroide.

es compatible con Microdroid

public boolean supportsMicrodroid (boolean protectedVm)

Comprueba las condiciones previas para ejecutar un microdroide.

cambiar de usuario

public boolean switchUser (int userId)

Cambie a otro ID de usuario con un tiempo de espera predeterminado. switchUser(int, long) .

cambiar de usuario

public boolean switchUser (int userId, 
                long timeout)

Cambie a otro ID de usuario con el tiempo de espera proporcionado como fecha límite. Intente deshabilitar Keyguard después de que el cambio de usuario sea exitoso.

tomarBugreinforme

public Bugreport takeBugreport ()

Tome un informe de error y devuélvalo dentro de un objeto Bugreport para manejarlo. Devuelve nulo en caso de problema. El archivo al que se hace referencia en el objeto Bugreport debe limpiarse a través de Bugreport.close() .

desinstalarPaquete

public String uninstallPackage (String packageName)

Desinstale un paquete de Android del dispositivo.

desinstalar paquete para usuario

public String uninstallPackageForUser (String packageName, 
                int userId)

Desinstale un paquete de Android del dispositivo para un usuario determinado.

crearParser

protected AaptParser createParser (File appFile)

doAdbReboot

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

Realice un reinicio adb.

getBureportInternal

protected InputStreamSource getBugreportInternal ()

getBugreportzInternal

protected File getBugreportzInternal ()

Método auxiliar interno para obtener el archivo zip bugreportz como ERROR(/File) .

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Expuesto para la prueba.

getHostCurrentTime

protected long getHostCurrentTime ()

Expuesto para la prueba

prePostBootSetup

protected void prePostBootSetup ()

Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) anule este método para una configuración posterior al arranque específica.