Dispositivo de prueba de TI

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


Proporciona una API fiable y de un nivel ligeramente superior a un IDevice ddmlib.

Vuelve a intentar los comandos del dispositivo por una cantidad configurable y proporciona una interfaz de recuperación del dispositivo para los dispositivos que no responden.

Resumen

Clases anidadas

class ITestDevice.ApexInfo

Una clase de estructura simple para almacenar información sobre un solo APEX

class ITestDevice.MountPointInfo

Una clase de estructura simple para almacenar información sobre un solo punto de montaje

Métodos públicos

abstract boolean canSwitchToHeadlessSystemUser ()

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

abstract boolean checkConnectivity ()

Compruebe que el dispositivo tiene conectividad de red.

abstract boolean clearErrorDialogs ()

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

abstract void clearLastConnectedWifiNetwork ()

Borra la última red wifi conectada.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

Se conecta a una red wifi.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

Se conecta a una red wifi.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Se conecta a una red wifi.

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

Se conecta a una red wifi.

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.

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.

abstract int createUser (String name)

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

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

Cree un usuario con un nombre dado y las banderas proporcionadas

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

Cree un usuario con un nombre dado y las banderas proporcionadas

abstract int createUserNoThrow (String name)

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

abstract void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Elimina el IDeviceActionReceiver registrado.

abstract void disableKeyguard ()

Intenta desactivar el bloqueo del teclado.

abstract boolean disableNetworkMonitor ()

Desactiva la supervisión de la red en el dispositivo.

abstract boolean disconnectFromWifi ()

Se desconecta de una red wifi.

abstract boolean doesFileExist (String deviceFilePath, int userId)

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

abstract File dumpHeap (String process, String devicePath)

Intente volcar el montón de system_server.

abstract boolean enableNetworkMonitor ()

Habilita el monitoreo de la red en el dispositivo.

abstract getActiveApexes ()

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

abstract getAllSettings (String namespace)

Devuelve pares de valores clave del espacio de nombres solicitado.

abstract String getAndroidId (int userId)

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

abstract getAndroidIds ()

Cree un mapa de ID de Android que coincidan con los ID de usuario.

abstract PackageInfo getAppPackageInfo (String packageName)

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

abstract getAppPackageInfos ()

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

abstract InputStreamSource getBugreport ()

Recupera un informe de error del dispositivo.

abstract InputStreamSource getBugreportz ()

Recupera un bugreportz del dispositivo.

abstract DeviceFoldableState getCurrentFoldableState ()

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

abstract int getCurrentUser ()

Devuelve la identificación del usuario actual en ejecución.

abstract getFoldableStates ()

Devuelve la lista de estados plegables en el dispositivo.

abstract getInstalledPackageNames ()

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

abstract String getIpAddress ()

Obtiene la dirección IP del dispositivo.

abstract KeyguardControllerState getKeyguardState ()

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

abstract Integer getMainUserId ()

Devuelve el ID de usuario principal.

abstract getMainlineModuleInfo ()

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

abstract int getMaxNumberOfRunningUsersSupported ()

Obtenga la cantidad máxima de usuarios compatibles que se ejecutan simultáneamente.

abstract int getMaxNumberOfUsersSupported ()

Obtenga el número máximo de usuarios admitidos.

abstract TestDeviceOptions getOptions ()

Obtener las opciones de prueba para el dispositivo.

abstract Integer getPrimaryUserId ()

Devuelve el ID de usuario principal.

abstract InputStreamSource getScreenshot ()

Toma una captura de pantalla del dispositivo.

abstract InputStreamSource getScreenshot (String format, boolean rescale)

Toma una captura de pantalla del dispositivo.

abstract InputStreamSource getScreenshot (String format)

Toma una captura de pantalla del dispositivo.

abstract InputStreamSource getScreenshot (long displayId)

Toma una captura de pantalla del dispositivo con la identificación de pantalla dada.

abstract String getSetting (String namespace, String key)

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

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

Devuelve el valor de la configuración solicitada.

abstract getUninstallablePackageNames ()

Obtenga los nombres de los paquetes de aplicaciones que se pueden desinstalar.

abstract int getUserFlags (int userId)

Encuentra y devuelve las banderas de un usuario dado.

abstract getUserInfos ()

Obtiene el mapa de useId a UserInfo en el dispositivo.

abstract int getUserSerialNumber (int userId)

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

abstract boolean hasFeature (String feature)

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

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

Instale un paquete de Android en el dispositivo.

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

Instale un paquete de Android en el dispositivo.

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

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

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

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

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales).

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales) que se encuentran en el dispositivo Android.

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales) para un usuario determinado.

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales) para un usuario determinado.

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales) que se encuentran en el dispositivo Android.

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales) que se encuentran en el dispositivo Android.

abstract boolean isHeadlessSystemUserMode ()

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

abstract boolean isMainUserPermanentAdmin ()

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

abstract boolean isMultiUserSupported ()

Determina si se admite multiusuario.

abstract boolean isPackageInstalled (String packageName)

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

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

abstract boolean isUserRunning (int userId)

Compruebe si un usuario determinado se está ejecutando.

abstract boolean isUserSecondary (int userId)

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

abstract boolean isUserVisible (int userId)

Comprueba si el usuario dado es visible.

abstract boolean isUserVisibleOnDisplay (int userId, int displayId)

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

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

abstract boolean isVisibleBackgroundUsersSupported ()

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

abstract boolean isWifiEnabled ()

Prueba si el wifi está habilitado.

abstract listDisplayIds ()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers ()

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

abstract listUsers ()

Obtiene la lista de usuarios en el dispositivo.

abstract boolean logBugreport (String dataName, ITestLogger listener)

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

abstract void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver para este dispositivo.

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

abstract void removeOwners ()

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

abstract boolean removeUser (int userId)

Eliminar un usuario determinado del dispositivo.

abstract boolean setDeviceOwner (String componentName, int userId)

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

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

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

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.

abstract boolean startUser (int userId)

Inicia un usuario determinado en segundo plano si actualmente está detenido.

abstract boolean startUser (int userId, boolean waitFlag)

Inicia un usuario determinado en segundo plano si actualmente está detenido.

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

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

Detener a un usuario determinado.

abstract boolean stopUser (int userId)

Detiene a un usuario determinado.

abstract boolean switchUser (int userId)

Cambie a otro ID de usuario con un tiempo de espera predeterminado.

abstract boolean switchUser (int userId, long timeout)

Cambie a otro ID de usuario con el tiempo de espera proporcionado como fecha límite.

abstract Bugreport takeBugreport ()

Tome un informe de error y devuélvalo dentro de un objeto Bugreport para manejarlo.

abstract String uninstallPackage (String packageName)

Desinstale un paquete de Android del dispositivo.

abstract String uninstallPackageForUser (String packageName, int userId)

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

Métodos públicos

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Devoluciones
boolean

Lanza
DeviceNotAvailableException

checkConectividad

public abstract boolean checkConnectivity ()

Compruebe que el dispositivo tiene conectividad de red.

Devoluciones
boolean true si el dispositivo tiene una conexión de red en funcionamiento, false en caso contrario.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

borrar diálogos de error

public abstract boolean clearErrorDialogs ()

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

Devoluciones
boolean true si no había cuadros de diálogo o los cuadros de diálogo se borraron correctamente. false en caso contrario.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

clearLastConnectedWifiNetwork

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 que se reinicie el dispositivo.

conectarse a la red Wi-Fi

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 proporcionadas 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() .

Parámetros
wifiSsidToPsk : Un mapa de wifi SSID a contraseñas.

scanSsid boolean : si buscar SSID ocultos para esta red.

Devoluciones
boolean true si está conectado a la red wifi con éxito. false de lo contrario

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

conectarse a la red Wi-Fi

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 proporcionadas 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() .

Parámetros
wifiSsidToPsk : Un mapa de wifi SSID a contraseñas.

Devoluciones
boolean true si está conectado a la red wifi con éxito. false de lo contrario

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

conectarse a la red Wi-Fi

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se conecta a una red wifi.

Enciende wifi y bloquea hasta que se establece 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() .

Parámetros
wifiSsid String : el ssid wifi para conectarse

wifiPsk String : frase de contraseña de PSK o nula si no está cifrada

Devoluciones
boolean true si está conectado a la red wifi con éxito. false de lo contrario

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

conectarse a la red Wi-Fi

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

Se conecta a una red wifi.

Enciende wifi y bloquea hasta que se establece 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() .

Parámetros
wifiSsid String : el ssid wifi para conectarse

wifiPsk String : frase de contraseña de PSK o nula si no está cifrada

scanSsid boolean : si buscar SSID oculto para esta red.

Devoluciones
boolean true si está conectado a la red wifi con éxito. false de lo contrario

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

connectToWifiNetworkIfNeeded

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.

Parámetros
scanSsid boolean : si buscar SSID oculto para esta red

Devoluciones
boolean true si está conectado a la red wifi con éxito. false de lo contrario

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

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.

Devoluciones
boolean true si está conectado a la red wifi con éxito. false de lo contrario

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

crear usuario

public abstract int createUser (String name)

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

Parámetros
name String : del usuario a crear en el dispositivo

Devoluciones
int el número entero para la identificación de usuario creada

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

crear usuario

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

Cree un usuario con un nombre dado y las banderas proporcionadas

Parámetros
name String : del usuario a crear en el dispositivo

guest boolean : habilita la marca de usuario --guest durante la creación

ephemeral boolean : habilitar el indicador de usuario --efímero durante la creación

forTesting boolean : habilita el indicador de prueba --para probar durante la creación

Devoluciones
int id del usuario creado

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

crear usuario

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

Cree un usuario con un nombre dado y las banderas proporcionadas

Parámetros
name String : del usuario a crear en el dispositivo

guest boolean : habilita la marca de usuario --guest durante la creación

ephemeral boolean : habilitar el indicador de usuario --efímero durante la creación

Devoluciones
int id del usuario creado

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

crearUsuarioNoLanzar

public abstract int createUserNoThrow (String name)

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

Parámetros
name String : del usuario a crear en el dispositivo

Devoluciones
int el número entero para el ID de usuario creado o -1 para el error.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Elimina el IDeviceActionReceiver registrado.

Parámetros
deviceActionReceiver IDeviceActionReceiver : un IDeviceActionReceiver que se eliminará.

desactivar Keyguard

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

Lanza
DeviceNotAvailableException

deshabilitar NetworkMonitor

public abstract boolean disableNetworkMonitor ()

Desactiva la supervisión de la red en el dispositivo.

Devoluciones
boolean true si la supervisión se deshabilita correctamente. false si falla.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

desconectar de Wifi

public abstract boolean disconnectFromWifi ()

Se desconecta de una red wifi.

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

Devoluciones
boolean true si se desconecta de la red wifi con éxito. false si falla la desconexión.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

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.

Parámetros
deviceFilePath String : la ruta absoluta del archivo en el dispositivo para verificar

userId int : la identificación de usuario contra la cual verificar la existencia del archivo

Devoluciones
boolean true si el archivo existe, false en caso contrario.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

basurero

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

Parámetros
process String : el nombre del proceso del dispositivo en el que se va a realizar el volcado.

devicePath String : la ruta en el dispositivo donde colocar el volcado. Esta debe ser una ubicación donde los permisos lo permitan.

Devoluciones
File el ERROR(/File) que contiene el informe. Nulo si algo falla.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

habilitarNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Habilita el monitoreo de la red en el dispositivo.

Devoluciones
boolean true si la supervisión se habilita correctamente. false si falla.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

getActiveApexes

public abstract  getActiveApexes ()

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

Devoluciones
ERROR(/Set) de ApexInfo actualmente activado en el dispositivo

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

Devuelve pares de valores clave del espacio de nombres solicitado.

Parámetros
namespace String : debe ser uno de {"sistema", "seguro", "global"}

Devoluciones
el mapa de pares clave-valor. Nulo si no se admite el espacio de nombres.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtenerAndroidId

public abstract String getAndroidId (int userId)

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

Parámetros
userId int

Devoluciones
String

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtener ID de Android

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

Devoluciones
Mapa de ID de Android encontrados ID de usuario coincidentes.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

Parámetros
packageName String

Devoluciones
PackageInfo el PackageInfo o null si no se pudo recuperar la información

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

Devoluciones
ERROR(/List) de PackageInfo s instalados en el dispositivo.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtener informe de error

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

Devoluciones
InputStreamSource Un InputStreamSource que producirá el contenido del informe de errores a pedido. En caso de falla, InputStreamSource generará un ERROR(/InputStream) vacío.

getBugreportz

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

Devoluciones
InputStreamSource un InputStreamSource del archivo zip que contiene bugreportz, devuelve nulo en caso de falla.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Devoluciones
DeviceFoldableState

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtenerUsuarioActual

public abstract int getCurrentUser ()

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

Devoluciones
int

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

Devoluciones

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

Devoluciones
ERROR(/Set) de nombres de paquetes String actualmente instalados en el dispositivo.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtener dirección IP

public abstract String getIpAddress ()

Obtiene la dirección IP del dispositivo.

Devoluciones
String la dirección IP del dispositivo, o null si el dispositivo no tiene dirección IP

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

Devoluciones
KeyguardControllerState un KeyguardControllerState que contiene una instantánea del estado de Keyguard y devuelve Null si no se admite la consulta de Keyguard.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

getMainUserId

public abstract Integer getMainUserId ()

Devuelve el ID de usuario principal.

Devoluciones
Integer el ID de usuario del usuario principal si lo hay, y nulo si no hay un usuario principal.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException si la salida del dispositivo no es la esperada.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

Devoluciones
ERROR(/Set) de los módulos de línea principal String actualmente instalados en el dispositivo.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSoportado

public abstract int getMaxNumberOfRunningUsersSupported ()

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

Devoluciones
int un número entero que indica el número de usuarios que se ejecutan simultáneamente

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSoportado

public abstract int getMaxNumberOfUsersSupported ()

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

Devoluciones
int un número entero que indica el número de usuarios admitidos

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Obtener las opciones de prueba para el dispositivo.

Devoluciones
TestDeviceOptions TestDeviceOptions relacionadas con el dispositivo bajo prueba.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Devuelve el ID de usuario principal.

Devoluciones
Integer el ID de usuario del usuario principal, si lo hay, y nulo si no hay ningún usuario principal.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException si la salida del dispositivo no es la esperada.
DeviceNotAvailableException

obtener captura de pantalla

public abstract InputStreamSource getScreenshot ()

Toma una captura de pantalla del dispositivo.

Devoluciones
InputStreamSource un InputStreamSource de la captura de pantalla en formato png, o null si la captura de pantalla no se realizó correctamente.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtener captura de pantalla

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

Parámetros
format String : PNG compatible, JPEG

rescale boolean : si se debe cambiar la escala de la captura de pantalla para reducir el tamaño de la imagen resultante

Devoluciones
InputStreamSource un InputStreamSource de la captura de pantalla en formato, o null si la captura de pantalla no se realizó correctamente.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtener captura de pantalla

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

Parámetros
format String : PNG compatible, JPEG

Devoluciones
InputStreamSource un InputStreamSource de la captura de pantalla en formato, o null si la captura de pantalla no se realizó correctamente.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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 'reescalado'

Parámetros
displayId long : la identificación de visualización de la pantalla para obtener la captura de pantalla.

Devoluciones
InputStreamSource un InputStreamSource de la captura de pantalla en formato, o null si la captura de pantalla no se realizó correctamente.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

Parámetros
namespace String

key String

Devoluciones
String

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

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: {"sistema", "seguro", "global"}

Parámetros
userId int

namespace String

key String

Devoluciones
String el valor asociado con el espacio de nombres: clave de un usuario. Nulo si no se encuentra.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

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

Devoluciones
ERROR(/Set) de nombres de paquetes String desinstalables actualmente instalados en el dispositivo.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

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

Parámetros
userId int

Devoluciones
int las banderas asociadas con el ID de usuario proporcionado si se encuentra, -10000 en cualquier otro caso.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

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

Devoluciones
la lista de objetos UserInfo.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

Parámetros
userId int

Devoluciones
int

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

tieneCaracterística

public abstract boolean hasFeature (String feature)

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

Parámetros
feature String : cuyo formato debe ser "característica: " o " directamente.

Devoluciones
boolean Verdadero si se encuentra la función, falso en caso contrario.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

paquete de instalación

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

Instale un paquete de Android en el dispositivo.

Parámetros
packageFile File : el archivo apk para instalar

reinstall boolean : true si se debe realizar una reinstalación

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm -h' para conocer las opciones disponibles.

Devoluciones
String una String con un código de error o null si se realiza correctamente.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

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

Parámetros
packageFile File : el archivo apk para instalar

reinstall boolean : true si se debe realizar una reinstalación

grantPermissions boolean : si se deben otorgar todos los permisos de tiempo de ejecución en el momento de la instalación

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm -h' para conocer las opciones disponibles.

Devoluciones
String una String con un código de error o null si se realiza correctamente.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si el permiso de tiempo de ejecución no es compatible con la plataforma en el dispositivo.

instalarPaqueteParaUsuario

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

Parámetros
packageFile File : el archivo apk para instalar

reinstall boolean : true si se debe realizar una reinstalación

grantPermissions boolean : si se deben otorgar todos los permisos de tiempo de ejecución en el momento de la instalación

userId int : el ID de usuario entero para instalar.

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm -h' para conocer las opciones disponibles.

Devoluciones
String una String con un código de error o null si se realiza correctamente.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si el permiso de tiempo de ejecución no es compatible con la plataforma en el dispositivo.

instalarPaqueteParaUsuario

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

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

Parámetros
packageFile File : el archivo apk para instalar

reinstall boolean : true si se debe realizar una reinstalación

userId int : el ID de usuario entero para instalar.

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm -h' para conocer las opciones disponibles.

Devoluciones
String una String con un código de error o null si se realiza correctamente.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

instalarPaquetes

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

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

Parámetros
packageFiles : los archivos apk locales

reinstall boolean : true si se debe realizar una reinstalación

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm -h' para conocer las opciones disponibles.

Devoluciones
String una String con un código de error o null si se realiza correctamente.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si el permiso de tiempo de ejecución no es compatible con la plataforma en el dispositivo.

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 paquetes divididos adicionales) 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 de la concesión de permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta función.

Parámetros
packageFiles : las rutas de archivo apk remoto para instalar

reinstall boolean : true si se debe realizar una reinstalación

grantPermissions boolean : si se deben otorgar todos los permisos de tiempo de ejecución en el momento de la instalación

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm -h' para conocer las opciones disponibles.

Devoluciones
String una String con un código de error o null si se realiza correctamente.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si el permiso de tiempo de ejecución no es compatible con la plataforma en el dispositivo.

instalarPaquetesParaUsuario

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 paquetes divididos adicionales) 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 de la concesión de permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta función.

Parámetros
packageFiles : los archivos apk locales

reinstall boolean : true si se debe realizar una reinstalación

grantPermissions boolean : si se deben otorgar todos los permisos de tiempo de ejecución en el momento de la instalación

userId int : el ID de usuario entero para instalar.

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm -h' para conocer las opciones disponibles.

Devoluciones
String una String con un código de error o null si se realiza correctamente.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si el permiso de tiempo de ejecución no es compatible con la plataforma en el dispositivo.

instalarPaquetesParaUsuario

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

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

Parámetros
packageFiles : los archivos apk locales

reinstall boolean : true si se debe realizar una reinstalación

userId int : el ID de usuario entero para instalar.

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm -h' para conocer las opciones disponibles.

Devoluciones
String una String con un código de error o null si se realiza correctamente.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si el permiso de tiempo de ejecución no es compatible con la plataforma en el dispositivo.

instalar paquetes remotos

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales) 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.

Parámetros
remoteApkPaths : las rutas de archivos apk remotos

reinstall boolean : true si se debe realizar una reinstalación

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm -h' para conocer las opciones disponibles.

Devoluciones
String una String con un código de error o null si se realiza correctamente.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si el permiso de tiempo de ejecución no es compatible con la plataforma en el dispositivo.

instalar paquetes remotos

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales) 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 de la concesión de permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta función.

Parámetros
remoteApkPaths : las rutas de archivos apk remotos

reinstall boolean : true si se debe realizar una reinstalación

grantPermissions boolean : si se deben otorgar todos los permisos de tiempo de ejecución en el momento de la instalación

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm -h' para conocer las opciones disponibles.

Devoluciones
String una String con un código de error o null si se realiza correctamente.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si el permiso de tiempo de ejecución no es compatible con la plataforma en el dispositivo.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

Devoluciones
boolean

Lanza
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

Devoluciones
boolean

Lanza
DeviceNotAvailableException

es multiusuario compatible

public abstract boolean isMultiUserSupported ()

Determina si se admite multiusuario.

Devoluciones
boolean verdadero si se admite multiusuario, falso en caso contrario

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

esPaqueteInstalado

public abstract boolean isPackageInstalled (String packageName)

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

Parámetros
packageName String

Devoluciones
boolean True si el paquete se informa como instalado. Falso en caso contrario.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

esPaqueteInstalado

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

Parámetros
packageName String : el paquete que estamos comprobando si está instalado.

userId String : la identificación de usuario para la que estamos verificando el paquete está instalado. Si es nulo, se utilizará el usuario principal cero.

Devoluciones
boolean True si el paquete se informa como instalado. Falso en caso contrario.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

Compruebe si un usuario determinado se está ejecutando.

Parámetros
userId int

Devoluciones
boolean Verdadero si el usuario está ejecutando, falso en todos los demás casos.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

esUsuarioSecundario

public abstract boolean isUserSecondary (int userId)

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

Parámetros
userId int

Devoluciones
boolean true si el usuario es secundario, false en caso contrario.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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

Parámetros
userId int

Devoluciones
boolean

Lanza
DeviceNotAvailableException

isUserVisibleOnDisplay

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

Parámetros
userId int

displayId int

Devoluciones
boolean

Lanza
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySoportado

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

Devoluciones
boolean

Lanza
DeviceNotAvailableException

isVisibleBackgroundUsersSoportado

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

Devoluciones
boolean

Lanza
DeviceNotAvailableException

esWifiEnabled

public abstract boolean isWifiEnabled ()

Prueba si el wifi está habilitado.

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

Devoluciones
boolean true si wifi está habilitado. false si está deshabilitado

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

listDisplayIds

public abstract  listDisplayIds ()

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

Devoluciones
La lista de pantallas. Predeterminado siempre devuelve la pantalla predeterminada 0.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Devoluciones

Lanza
DeviceNotAvailableException

listaUsuarios

public abstract  listUsers ()

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

Devoluciones
la lista de ID de usuario.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

informe de error de registro

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

Parámetros
dataName String : nombre bajo el cual se informará el informe de error.

listener ITestLogger : un ITestLogger para registrar el informe de errores.

Devoluciones
boolean Verdadero si el registro fue exitoso, falso en caso contrario.

registrarseDispositivoAcciónReceptor

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver para este dispositivo.

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

Parámetros
deviceActionReceiver IDeviceActionReceiver : un IDeviceActionReceiver que se registrará.

removeAdmin

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

Parámetros
componentName String : del administrador del dispositivo que se eliminará.

userId int : del usuario en el que vive el administrador del dispositivo.

Devoluciones
boolean Verdadero si tiene éxito, falso en caso contrario.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removePropietarios

public abstract void removeOwners ()

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

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

eliminarUsuario

public abstract boolean removeUser (int userId)

Eliminar un usuario determinado del dispositivo.

Parámetros
userId int : del usuario a eliminar

Devoluciones
boolean true si logramos eliminar al usuario, false en caso contrario.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

Parámetros
componentName String : del administrador del dispositivo para que sea el propietario del dispositivo.

userId int : del usuario en el que vive el propietario del dispositivo.

Devoluciones
boolean Verdadero si tiene éxito, falso en caso contrario.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

establecerConfiguración

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

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

Parámetros
namespace String

key String

value String

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

establecerConfiguració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"}

Parámetros
userId int

namespace String

key String

value String

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

inicioUsuario

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

Parámetros
userId int : del usuario para iniciar en segundo plano

Devoluciones
boolean true si el usuario se inició correctamente en segundo plano.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

inicioUsuario

public abstract 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. Possible to provide extra flag to wait for the operation to have effect.

Parámetros
userId int : of the user to start in the background

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

Devoluciones
boolean true if the user was successfully started in the background.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

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

Parámetros
userId int : of the user to start in the background

displayId int : display to start user visible on

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

Devoluciones
boolean true if the user was successfully started visible in the background.

Lanza
DeviceNotAvailableException

stopUser

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

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

Parámetros
userId int : of the user to stop.

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

forceFlag boolean : will force stop the user.

Devoluciones
boolean true if the user was successfully stopped.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

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

Parámetros
userId int : of the user to stop.

Devoluciones
boolean true if the user was successfully stopped.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

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

Parámetros
userId int

Devoluciones
boolean True if the new userId matches the userId provider. False otherwise.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

Parámetros
userId int

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

Devoluciones
boolean True if the new userId matches the userId provider. False otherwise.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

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

Devoluciones
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Uninstall an Android package from device.

Parámetros
packageName String : the Android package to uninstall

Devoluciones
String a String with an error code, or null if success.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Uninstall an Android package from device for a given user.

Parámetros
packageName String : the Android package to uninstall

userId int : the integer user id to uninstall for.

Devoluciones
String a String with an error code, or null if success.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.