Dispositivo de prueba

puede cambiar a usuario del sistema sin cabeza

public abstract boolean canSwitchToHeadlessSystemUser ()

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

checkConectividad

public abstract boolean checkConnectivity ()

Verifique que el dispositivo tenga conectividad de red.

clearErrorDiálogos

public abstract boolean clearErrorDialogs ()

Intente descartar cualquier cuadro de diálogo de error que se muestre actualmente en la interfaz de usuario del dispositivo.

borrarÚltimoConectadoRedWifi

public abstract void clearLastConnectedWifiNetwork ()

Borra la última red wifi conectada. Esto debe llamarse al iniciar una nueva invocación para evitar conectarse a la red wifi utilizada en la prueba anterior después de reiniciar el dispositivo.

conectarse a la red wifi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Se conecta a una red wifi.

Enciende wifi y bloquea hasta que se establece una conexión exitosa con una de las redes wifi que figuran en el mapa wifiSsidToPsk. Una vez que se establece una conexión, la instancia intentará restaurar la conexión después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

conectarse a la red wifi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se conecta a una red wifi.

Enciende wifi y bloquea hasta que se establece una conexión exitosa con una de las redes wifi que figuran en el mapa wifiSsidToPsk. Una vez que se establece una conexión, la instancia intentará restaurar la conexión después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

conectarse a la red wifi

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se conecta a una red wifi.

Enciende wifi y bloquea hasta que se realiza una conexión exitosa a la red wifi especificada. Una vez que se establece una conexión, la instancia intentará restaurar la conexión después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

conectarse a la red wifi

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

Se conecta a una red wifi.

Enciende wifi y bloquea hasta que se realiza una conexión exitosa a la red wifi especificada. Una vez que se establece una conexión, la instancia intentará restaurar la conexión después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

conectarse a la red Wifi si es necesario

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

Una variante de connectToWifiNetwork(String, String) que solo se conecta si el dispositivo actualmente no tiene conectividad de red.

conectarse a la red Wifi si es necesario

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Una variante de connectToWifiNetwork(String, String) que solo se conecta si el dispositivo actualmente no tiene conectividad de red.

crear usuario

public abstract int createUser (String name)

Cree un usuario con un nombre de pila y banderas predeterminadas 0.

crear usuario

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

Cree un usuario con un nombre de pila y las banderas proporcionadas

crear usuario

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

Cree un usuario con un nombre de pila y las banderas proporcionadas

crearUsuarioNoThrow

public abstract int createUserNoThrow (String name)

Cree un usuario con un nombre de pila y banderas predeterminadas 0.

cancelar el registroDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Elimina el IDeviceActionReceiver registrado.

desactivar Keyguard

public abstract void disableKeyguard ()

Intenta desactivar el bloqueo de teclas.

Primero espere a que el envío de entrada esté listo; esto sucede aproximadamente al mismo tiempo que el dispositivo informa BOOT_COMPLETE, aparentemente de forma asincrónica, porque la implementación actual del marco tiene condiciones de carrera ocasionales. Luego se envía el comando para descartar el bloqueo de teclas (sólo funciona en los no seguros)

desactivarNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Desactiva el monitoreo de red en el dispositivo.

desconectarse de Wifi

public abstract boolean disconnectFromWifi ()

Se desconecta de una red wifi.

Elimina todas las redes de la lista de redes conocidas y desactiva el wifi.

¿Existe el archivo?

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

montón de volcado

public abstract File dumpHeap (String process, 
                String devicePath)

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

habilitarNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Habilita el monitoreo de red en el dispositivo.

getActiveApexes

public abstract  getActiveApexes ()

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

obtener todas las configuraciones

public abstract  getAllSettings (String namespace)

Devuelve pares clave-valor del espacio de nombres solicitado.

obtenerID de Android

public abstract String getAndroidId (int userId)

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

obtenerIds de Android

public abstract  getAndroidIds ()

Cree un mapa de identificadores de Android que coincidan con los identificadores de usuario. No hay seguridad de que cada ID de usuario encuentre una ID de Android asociada en esta función, por lo que algunas ID de usuario pueden coincidir con NULL.

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

obtener informe de error

public abstract InputStreamSource getBugreport ()

Recupera un informe de error del dispositivo.

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

Recupera un informe de error 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 se admite para la 'versión adb' > 1.0.36

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

obtener usuario actual

public abstract int getCurrentUser ()

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

getFoldableStates

public abstract  getFoldableStates ()

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

obtener dirección IP

public abstract String getIpAddress ()

Obtiene la dirección IP del dispositivo.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

obtener ID de usuario principal

public abstract Integer getMainUserId ()

Devuelve la identificación del usuario principal.

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

obtener Opciones

public abstract TestDeviceOptions getOptions ()

Obtenga las opciones de prueba para el dispositivo.

obtener ID de usuario principal

public abstract Integer getPrimaryUserId ()

Devuelve la identificación del usuario principal.

obtener captura de pantalla

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

obtener captura de pantalla

public abstract InputStreamSource getScreenshot (String format)

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

obtener captura de pantalla

public abstract 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 'reescalar'

obtener captura de pantalla

public abstract InputStreamSource getScreenshot ()

Toma una captura de pantalla del dispositivo.

obtener configuración

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

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

obtener configuración

public abstract String getSetting (String namespace, 
                String key)

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

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Obtenga los nombres de los paquetes de aplicaciones que se pueden desinstalar. Actualmente, esto se define como paquetes que no son del sistema y paquetes del sistema actualizados.

obtener banderas de usuario

public abstract int getUserFlags (int userId)

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

obtener información de usuario

public abstract  getUserInfos ()

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

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

tiene característica

public abstract boolean hasFeature (String feature)

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

paquete de instalación

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

Instale un paquete de Android en el dispositivo.

paquete de instalación

public abstract 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 para otorgar permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta función.

instalarPaqueteParaUsuario

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

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

instalarPaqueteParaUsuario

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

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

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

instalarPaquetes

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

Instale una aplicación de Android compuesta por varios archivos APK (un paquete principal y uno adicional dividido). Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre cómo dividir apk en varios archivos.

instalarPaquetes

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y un paquete dividido adicional) que se encuentran en el dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre cómo dividir apk en varios archivos.

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

instalarPackagesForUser

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y un paquete dividido adicional) para un usuario determinado. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre cómo dividir apk en varios archivos.

instalarPackagesForUser

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y un paquete dividido adicional) para un usuario determinado. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre cómo dividir apk en varios archivos.

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

instalarRemotePackages

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y un paquete dividido adicional) que se encuentran en el dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre cómo dividir apk en varios archivos.

instalarRemotePackages

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y un paquete dividido adicional) que se encuentran en el dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre cómo dividir apk en varios archivos.

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

esHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

esMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

es compatible con múltiples usuarios

public abstract boolean isMultiUserSupported ()

Determina si se admite multiusuario.

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

Consulta en el dispositivo un nombre de paquete determinado para comprobar si está actualmente instalado o no.

esUsuarioRunning

public abstract boolean isUserRunning (int userId)

Compruebe si un usuario determinado se está ejecutando.

esUsuarioSecundario

public abstract boolean isUserSecondary (int userId)

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

esUsuarioVisible

public abstract 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 inicio (normalmente en la pantalla predeterminada).

esUsuarioVisibleEnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Comprueba si el usuario dado es 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.

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

Devuelve si el dispositivo permite que los usuarios se inicien de forma visible en segundo plano.

Si es así, puede llamar startVisibleBackgroundUser(int, int, boolean) , pasando una pantalla devuelta por listDisplayIdsForStartingVisibleBackgroundUsers() .

está habilitado para Wifi

public abstract boolean isWifiEnabled ()

Pruebe si el wifi está habilitado.

Comprueba si el wifi está habilitado en el dispositivo. Útil para afirmar el estado de wifi antes de pruebas que no deberían ejecutarse con wifi, por ejemplo, pruebas de datos móviles.

listaDisplayIds

public abstract  listDisplayIds ()

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

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

listaUsuarios

public abstract  listUsers ()

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

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

notificarSnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Notifique al dispositivo que espere a que se complete snapuserd.

registrarDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver para este dispositivo.

Todos IDeviceActionReceiver registrados serán notificados antes de que comience una acción del dispositivo y después de que finalice.

eliminarAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Elimine el administrador del dispositivo determinado en un usuario determinado y devuelva true si tiene éxito, false en caso contrario.

eliminarPropietarios

public abstract void removeOwners ()

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

eliminarUsuario

public abstract boolean removeUser (int userId)

Eliminar un usuario determinado del dispositivo.

setDevicowner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Establezca un componente de administrador del dispositivo como propietario del dispositivo en el usuario dado.

fijación

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

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

fijación

public abstract 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"}

comienzo

public abstract boolean startUser (int userId)

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

comienzo

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

startVisibleBackgroundUser

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

Inicia un usuario determinado en segundo plano, visible en la pantalla dada (es decir, permitiendo al usuario iniciar actividades en esa pantalla).

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

paro

public abstract 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 el usuario actual y del sistema.

paro

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

Detener a un usuario determinado. Posible proporcionar banderas adicionales para esperar a que la operación tenga efecto y la fuerza finalice al usuario. No se puede detener el usuario actual y del sistema.

cambiar de usuario

public abstract boolean switchUser (int userId)

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

cambiar de usuario

public abstract 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.

TakeBuGreport

public abstract Bugreport takeBugreport ()

Tome un bugreport y lo devuelva dentro de un objeto Bugreport para manejarlo. Devolver nulo en caso de emisión. Archivo referenciado en el objeto BuGreport debe limpiarse a través de Bugreport.close() .

desinstalada

public abstract String uninstallPackage (String packageName)

Desinstale un paquete de Android desde el dispositivo.

uninstaltpackageforuser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

waitforsnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Si se esperaba, espere a que Snapuserd se complete.