Dispositivo de Prueba

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Subcategorías indirectas conocidas IManagedTestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice y TestDevice. IManagedTestDevice Un ITestDevice cuyo ciclo de vida se administra.  LocalAndroidVirtualDevice Es la clase para dispositivos virtuales locales que se ejecutan en el host de TradeFed.  ManagedRemoteDevice Un dispositivo que se ejecuta dentro de una máquina virtual que administramos de forma remota a través de una instancia de Tradefed dentro de la VM.  NativeDevice Implementación predeterminada de un dispositivo Android ITestDevice sin pila completa.  NestedRemoteDevice Representación del dispositivo que se ejecuta dentro de una VM de Cuttlefish remota.  RemoteAndroidDevice Es la implementación de un ITestDevice para un dispositivo Android de pila completa conectado mediante adb connect.  RemoteAndroidVirtualDevice Extiende el comportamiento de RemoteAndroidDevice para un dispositivo Android de pila completa que se ejecuta en Google Compute Engine (GCE).  TestDevice Implementación de ITestDevice para un dispositivo Android de pila completa

---

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

Vuelve a intentar los comandos del dispositivo por un período 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 struct simple para almacenar información sobre un solo APEX
class	ITestDevice.MountPointInfo Una clase de struct simple para almacenar información sobre un solo punto de activación

Métodos públicos
abstract boolean	canSwitchToHeadlessSystemUser() Muestra si se permite cambiar al usuario del sistema sin interfaz gráfica.
abstract boolean	checkConnectivity() Verifica que el dispositivo tenga conectividad de red.
abstract boolean	clearErrorDialogs() Intenta descartar los diálogos de error que se muestran actualmente en la IU del dispositivo.
abstract void	clearLastConnectedWifiNetwork() Borra la última red Wi-Fi conectada.
abstract boolean	connectToWifiNetwork( wifiSsidToPsk) Se conecta a una red Wi-Fi.
abstract boolean	connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid) Se conecta a una red Wi-Fi.
abstract boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk) Se conecta a una red Wi-Fi.
abstract boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid) Se conecta a una red Wi-Fi.
abstract boolean	connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid) Es una variante de connectToWifiNetwork(String, String) que solo se conecta si el dispositivo no tiene conectividad de red en ese momento.
abstract boolean	connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk) Es una variante de connectToWifiNetwork(String, String) que solo se conecta si el dispositivo no tiene conectividad de red en ese momento.
abstract int	createUser(String name) Crea un usuario con un nombre determinado y las marcas predeterminadas 0.
abstract int	createUser(String name, boolean guest, boolean ephemeral) Crea un usuario con un nombre determinado y las marcas proporcionadas
abstract int	createUser(String name, boolean guest, boolean ephemeral, boolean forTesting) Crea un usuario con un nombre determinado y las marcas proporcionadas
abstract int	createUserNoThrow(String name) Crea un usuario con un nombre determinado y las marcas predeterminadas 0.
abstract void	deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver) Quita el IDeviceActionReceiver registrado.
abstract void	disableKeyguard() Intenta inhabilitar el bloqueo de teclas.
abstract boolean	disableNetworkMonitor() Inhabilita la supervisión de red en el dispositivo.
abstract boolean	disconnectFromWifi() Se desconecta de una red Wi-Fi.
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) Intenta volcar el montón desde system_server.
abstract boolean	enableNetworkMonitor() Habilita la supervisión de red en el dispositivo.
abstract	getActiveApexes() Recupera la información sobre los APEX activados en el dispositivo.
abstract	getAllSettings(String namespace) Muestra los pares clave-valor del espacio de nombres solicitado.
abstract String	getAndroidId(int userId) Busca y muestra el android-id asociado con un userId (valor nulo si no se encuentra).
abstract	getAndroidIds() Crea un mapa de los IDs de Android que coincidan con los IDs de usuario.
abstract PackageInfo	getAppPackageInfo(String packageName) Recupera información sobre un paquete instalado en el dispositivo.
abstract	getAppPackageInfos() Recupera información de los paquetes instalados en el dispositivo.
abstract InputStreamSource	getBugreport() Recupera un informe de errores del dispositivo.
abstract InputStreamSource	getBugreportz() Recupera un bugreportz del dispositivo.
abstract DeviceFoldableState	getCurrentFoldableState() Devuelve el estado plegable actual del dispositivo o un valor nulo si se produjeron algunos problemas.
abstract int	getCurrentUser() Muestra el ID del usuario que se está ejecutando actualmente.
abstract	getFoldableStates() Muestra la lista de estados plegables en el dispositivo.
abstract	getInstalledPackageNames() Recupera los nombres de 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 de la protección de teclado o un valor nulo si no se admite.
abstract Integer	getMainUserId() Muestra el ID de usuario principal.
abstract	getMainlineModuleInfo() Obtén información sobre los módulos principales instalados en el dispositivo.
abstract int	getMaxNumberOfRunningUsersSupported() Obtén la cantidad máxima de usuarios que se ejecutan de forma simultánea.
abstract int	getMaxNumberOfUsersSupported() Obtén la cantidad máxima de usuarios admitidos.
abstract TestDeviceOptions	getOptions() Recupera las opciones de prueba del dispositivo.
abstract Integer	getPrimaryUserId() Muestra el ID de usuario principal.
abstract InputStreamSource	getScreenshot(String format, boolean rescale) Toma una captura de pantalla del dispositivo.
abstract InputStreamSource	getScreenshot(long displayId) Toma una captura de pantalla del ID de visualización del dispositivo.
abstract InputStreamSource	getScreenshot(String format) Toma una captura de pantalla del dispositivo.
abstract InputStreamSource	getScreenshot() Toma una captura de pantalla del dispositivo.
abstract String	getSetting(int userId, String namespace, String key) Muestra el valor del parámetro de configuración solicitado.
abstract String	getSetting(String namespace, String key) Consulta getSetting(int, String, String) y se realizó en el usuario del sistema.
abstract	getUninstallablePackageNames() Recupera los nombres de los paquetes de la aplicación que se pueden desinstalar.
abstract int	getUserFlags(int userId) Busca y muestra las marcas de un usuario determinado.
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 userId si se encuentra, -10000 en cualquier otro caso.
abstract boolean	hasFeature(String feature) Verifica si una función está disponible en un dispositivo.
abstract String	installPackage(File packageFile, boolean reinstall, String... extraArgs) Instala un paquete de Android en el dispositivo.
abstract String	installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Instala un paquete de Android en el dispositivo.
abstract String	installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs) Instala un paquete de Android en el dispositivo de un usuario determinado.
abstract String	installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Instala un paquete de Android en el dispositivo de un usuario determinado.
default String	installPackages( packageFiles, boolean reinstall, String... extraArgs) Instala una aplicación para Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales).
default String	installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) Instala una aplicación para Android compuesta por varios archivos APK (un paquete dividido principal y uno adicional) que se encuentren en el dispositivo Android.
default String	installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs) Instala una aplicación para Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales) para un usuario determinado.
default String	installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Instala una aplicación para Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales) para un usuario determinado.
default String	installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs) Instala una aplicación para 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) Instala una aplicación para Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales) que se encuentran en el dispositivo Android.
abstract boolean	isHeadlessSystemUserMode() Muestra si el dispositivo usa el modo de usuario del sistema sin interfaz gráfica.
abstract boolean	isMainUserPermanentAdmin() Muestra si el usuario principal es un administrador permanente y no se puede borrar ni cambiar a un estado que no sea de administrador.
abstract boolean	isMultiUserSupported() Determina si se admite el modo multiusuario.
abstract boolean	isPackageInstalled(String packageName, String userId) Consulta el dispositivo para un nombre de paquete y un ID de usuario determinados para verificar si está instalado o no para ese usuario.
abstract boolean	isPackageInstalled(String packageName) Consulta el dispositivo para un nombre de paquete determinado y comprueba si está instalado o no.
abstract boolean	isUserRunning(int userId) Verifica si un usuario determinado está en ejecución.
abstract boolean	isUserSecondary(int userId) Muestra si el usuario especificado es un usuario secundario según sus marcas.
abstract boolean	isUserVisible(int userId) Verifica si el usuario determinado es visible.
abstract boolean	isUserVisibleOnDisplay(int userId, int displayId) Verifica si el usuario determinado es visible en la pantalla determinada.
abstract boolean	isVisibleBackgroundUsersOnDefaultDisplaySupported() Devuelve si el dispositivo permite que los usuarios se inicien de forma visible en segundo plano en ERROR(/java.android.view.Display#DEFAULT_DISPLAY).
abstract boolean	isVisibleBackgroundUsersSupported() Muestra si el dispositivo permite que los usuarios se inicien de forma visible en segundo plano.
abstract boolean	isWifiEnabled() Prueba si la red Wi-Fi está habilitada.
abstract	listDisplayIds() Recopila la lista de ID de pantallas disponibles en el dispositivo según lo informa "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) Es un método de ayuda para tomar un informe de errores y registrarlo en los generadores.
default void	notifySnapuserd(SnapuserdWaitPhase waitPhase) Notifica al dispositivo que espere a que se complete snapuserd.
abstract void	registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver) Registra un IDeviceActionReceiver para este dispositivo.
abstract boolean	removeAdmin(String componentName, int userId) Quita el administrador de dispositivo determinado de un usuario determinado y muestra true si se realiza correctamente; de lo contrario, muestra false.
abstract void	removeOwners() Quita todos los propietarios de perfiles de dispositivos existentes con el mejor esfuerzo.
abstract boolean	removeUser(int userId) Quitar a un usuario determinado del dispositivo
abstract boolean	setDeviceOwner(String componentName, int userId) Establece un componente de administrador de dispositivos como propietario del dispositivo en un usuario determinado.
abstract void	setSetting(String namespace, String key, String value) Consulta setSetting(int, String, String, String) y realiza la acción en el usuario del sistema.
abstract void	setSetting(int userId, String namespace, String key, String value) Agrega 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 está detenido.
abstract boolean	startUser(int userId, boolean waitFlag) Inicia un usuario determinado en segundo plano si está detenido.
abstract boolean	startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag) Inicia un usuario determinado en segundo plano, visible en la pantalla determinada (es decir, permite que el usuario inicie actividades en esa pantalla).
abstract boolean	stopUser(int userId) Detiene a un usuario determinado.
abstract boolean	stopUser(int userId, boolean waitFlag, boolean forceFlag) Detener un usuario determinado.
abstract boolean	switchUser(int userId) Cambia a otro userId con un tiempo de espera predeterminado.
abstract boolean	switchUser(int userId, long timeout) Cambia a otro userId con el tiempo de espera proporcionado como fecha límite.
abstract Bugreport	takeBugreport() Toma un informe de errores y devuélvelo dentro de un objeto Bugreport para controlarlo.
abstract String	uninstallPackage(String packageName) Desinstala un paquete de Android del dispositivo.
abstract String	uninstallPackageForUser(String packageName, int userId) Desinstala un paquete de Android del dispositivo de un usuario determinado.
default void	waitForSnapuserd(SnapuserdWaitPhase currentPhase) Si se espera, espera a que Snapuserd se complete.

Métodos públicos

Cambiar a usuario del sistema sin cabeza

public abstract boolean canSwitchToHeadlessSystemUser ()

Muestra si se permite cambiar al usuario del sistema sin interfaz gráfica.

Muestra
boolean

Arroja
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

Verifica que el dispositivo tenga conectividad de red.

Muestra
boolean	true si el dispositivo tiene una conexión de red que funciona, false de lo contrario.

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

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Intenta descartar los diálogos de error que se muestran actualmente en la IU del dispositivo.

Muestra
boolean	true si no hay diálogos presentes o estos se borraron correctamente. false en caso contrario.

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

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Borra la última red Wi-Fi conectada. Se debe llamar a esta función cuando se inicia una nueva invocación para evitar conectarse a la red Wi-Fi que se usó en la prueba anterior después de que se reinicie el dispositivo.

conectarAlaredWi-Fi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Se conecta a una red Wi-Fi.

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

Parámetros
wifiSsidToPsk	: Es un mapa de SSID de Wi-Fi a contraseñas.

Muestra
boolean	true si se conectó correctamente a la red Wi-Fi. false de lo contrario

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se conecta a una red Wi-Fi.

Activa el Wi-Fi y bloquea hasta que se establece una conexión exitosa con una de las redes Wi-Fi que se indican en el mapa wifiSsidToPsk. Una vez que se establezca una conexión, la instancia intentará restablecerla después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork().

Parámetros
wifiSsidToPsk	: Es un mapa de SSID de Wi-Fi a contraseñas.
scanSsid	boolean: Indica si se deben buscar SSID ocultos para esta red.

Muestra
boolean	true si se conectó correctamente a la red Wi-Fi. false de lo contrario

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se conecta a una red Wi-Fi.

Activa el Wi-Fi y lo bloquea hasta que se establece una conexión correcta con la red Wi-Fi especificada. Una vez que se establezca una conexión, la instancia intentará restablecerla después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork().

Parámetros
wifiSsid	String: El SSID de Wi-Fi al que te conectarás
wifiPsk	String: Frase de contraseña de PSK o nula si no está encriptada

Muestra
boolean	true si se conecta correctamente a la red Wi-Fi. false otherwise

Arroja
DeviceNotAvailableException	Si se pierde la conexión con el dispositivo y no se puede recuperar.

connectToWifiNetwork

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

Se conecta a una red Wi-Fi.

Activa el Wi-Fi y bloquea hasta que se establezca una conexión exitosa a la red Wi-Fi especificada. Una vez que se establezca una conexión, la instancia intentará restablecerla después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork().

Parámetros
wifiSsid	String: El SSID de Wi-Fi al que te conectarás
wifiPsk	String: La frase de contraseña del PSK o un valor nulo si no está encriptada
scanSsid	boolean: Indica si se debe buscar un SSID oculto para esta red.

Muestra
boolean	true si se conecta correctamente a la red Wi-Fi. false otherwise

Arroja
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)

Es una variante de connectToWifiNetwork(String, String) que solo se conecta si el dispositivo no tiene conectividad de red en ese momento.

Parámetros
scanSsid	boolean: Indica si se debe buscar un SSID oculto para esta red.

Muestra
boolean	true si se conecta correctamente a la red Wi-Fi. false otherwise

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ConectarConWi-FiNetworkSi Es necesario

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Es una variante de connectToWifiNetwork(String, String) que solo se conecta si el dispositivo no tiene conectividad de red en ese momento.

Muestra
boolean	true si se conecta correctamente a la red Wi-Fi. false otherwise

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

Crea un usuario con un nombre determinado y las marcas predeterminadas 0.

Parámetros
name	String: Es el usuario que se creará en el dispositivo.

Muestra
int	el número entero para el ID de usuario creado

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

Crea un usuario con un nombre determinado y las marcas proporcionadas

Parámetros
name	String: del usuario que se creará en el dispositivo
guest	boolean: Habilita la marca de usuario --guest durante la creación.
ephemeral	boolean: Habilita la marca del usuario --ephemeral durante la creación.

Muestra
int	ID del usuario creado

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

Crea un usuario con un nombre determinado y las marcas proporcionadas

Parámetros
name	String: del usuario que se creará en el dispositivo
guest	boolean: Habilita la marca de usuario --guest durante la creación.
ephemeral	boolean: Habilita la marca del usuario --ephemeral durante la creación.
forTesting	boolean: Habilita la marca de prueba --for-testing durante la creación.

Muestra
int	ID del usuario creado

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

Crea un usuario con un nombre determinado y las marcas predeterminadas 0.

Parámetros
name	String: Es el usuario que se creará en el dispositivo.

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

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Quita el IDeviceActionReceiver registrado.

Parámetros
deviceActionReceiver	IDeviceActionReceiver: Es un IDeviceActionReceiver que se quitará.

deshabilitar bloqueo de teclado

public abstract void disableKeyguard ()

Intenta inhabilitar el bloqueo de teclas.

Primero, espera a que el envío de entrada esté listo. Esto ocurre aproximadamente al mismo tiempo que el dispositivo informa BOOT_COMPLETE, aparentemente de forma asíncrona, porque la implementación actual del framework 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).

Arroja
DeviceNotAvailableException

inhabilitarNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Inhabilita la supervisión de red en el dispositivo.

Muestra
boolean	Es true si la supervisión se inhabilitó correctamente. false si falló.

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

desconectardeWi-Fi

public abstract boolean disconnectFromWifi ()

Se desconecta de una red Wi-Fi.

Quita todas las redes de la lista de redes conocidas e inhabilita el Wi-Fi.

Muestra
boolean	true si se desconectó correctamente de la red Wi-Fi. false si no se pudo desconectar.

Arroja
DeviceNotAvailableException	Si se pierde la conexión con el dispositivo y no se puede recuperar.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

Es un método de ayuda para determinar si existe un archivo en el dispositivo para un usuario determinado.

Parámetros
deviceFilePath	String: Es la ruta de acceso absoluta del archivo en el dispositivo que se debe verificar.
userId	int: Es el ID de usuario con el que se comprueba la existencia del archivo.

Muestra
boolean	true si el archivo existe, false de lo contrario.

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

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

Intenta volcar el montón desde system_server. El llamador es responsable de limpiar el archivo volcado.

Parámetros
process	String: Es el nombre del proceso del dispositivo en el que se volcará el heap.
devicePath	String: Es la ruta de acceso en el dispositivo donde se debe colocar el volcado. Debe ser una ubicación donde los permisos lo permitan.

Muestra
File	el objeto ERROR(/File) que contiene el informe. Es nulo si se produjo un error.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Habilita la supervisión de red en el dispositivo.

Muestra
boolean	true si la supervisión se habilita correctamente. false si falló.

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

getActiveApexes

public abstract  getActiveApexes ()

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

Muestra
	ERROR(/Set) de ApexInfo activados actualmente en el dispositivo

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

Muestra los pares clave-valor del espacio de nombres solicitado.

Parámetros
namespace	String: Debe ser uno de {"system", "secure", "global"}.

Muestra
	el mapa de pares clave-valor. Nulo si el espacio de nombres no es compatible.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

Busca y muestra el android-id asociado a un userId, nulo si no se encuentra.

Parámetros
userId	int

Muestra
String

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Crea un mapa de los IDs de Android que coincidan con los IDs de usuario. No hay garantía de que cada ID de usuario encuentre un ID de Android asociado en esta función, por lo que algunos IDs de usuario pueden coincidir con nulos.

Muestra
	Mapa de IDs de Android que coinciden con los IDs de usuario

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

Parámetros
packageName	String

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

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Recupera información de paquetes instalados en el dispositivo.

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

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

Recupera un informe de errores del dispositivo.

Se garantiza que la implementación de esto seguirá funcionando en un dispositivo sin una sdcard (o en el que la sdcard aún no esté montada).

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

Recupera un informe de errores de bugreportz desde el 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 es compatible con "versión de adb" > 1.0.36.

Muestra
InputStreamSource	un InputStreamSource del archivo ZIP que contiene el bugreportz, muestra un valor nulo en caso de falla.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

Muestra el estado plegable actual del dispositivo o un valor nulo si se produjeron algunos problemas.

Muestra
DeviceFoldableState

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

Muestra el ID del usuario que se está ejecutando actualmente. En caso de error, muestra -10000.

Muestra
int

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

Muestra

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Recupera los nombres de los paquetes de la aplicación presentes en el dispositivo.

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

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Obtiene la dirección IP del dispositivo.

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

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

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

Muestra
KeyguardControllerState	un KeyguardControllerState que contiene una instantánea del estado del bloqueo de teclas y muestra un valor nulo si no se admite la consulta del bloqueo de teclas.

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

getMainUserId

public abstract Integer getMainUserId ()

Muestra el ID de usuario principal.

Muestra
Integer	El userId del usuario principal, si existe, es nulo si no lo hay.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException	si el resultado del dispositivo no es el esperado.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Obtén información sobre los módulos principales instalados en el dispositivo.

Muestra
	ERROR(/Set) de los String módulos principales instalados actualmente en el dispositivo.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

Obtén la cantidad máxima de usuarios que se ejecutan de manera simultánea. La configuración predeterminada es 0.

Muestra
int	Un número entero que indica la cantidad de usuarios que se ejecutan de forma simultánea.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Obtén la cantidad máxima de usuarios admitidos. La configuración predeterminada es 0.

Muestra
int	un número entero que indica la cantidad de usuarios admitidos

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Recupera las opciones de prueba del dispositivo.

Muestra
TestDeviceOptions	TestDeviceOptions relacionado con el dispositivo en prueba.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Muestra el ID de usuario principal.

Muestra
Integer	el userId del usuario principal si hay uno y nulo si no hay un usuario principal.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException	si el resultado del dispositivo no es el esperado.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

Parámetros
format	String: PNG y JPEG compatibles
rescale	boolean: Indica si se debe cambiar el tamaño de la captura de pantalla para reducir el tamaño de la imagen resultante.

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

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

Toma una captura de pantalla del ID de visualización del dispositivo. El formato es PNG.

TODO: Extiende las implementaciones anteriores para admitir "format" y "rescale".

Parámetros
displayId	long: Es el ID de la pantalla de la que se realizará la captura de pantalla.

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

Arroja
	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(format) con codificación JPEG para obtener un tamaño más pequeño.

Parámetros
format	String: Se admiten PNG y JPEG.

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

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtener captura de pantalla

public abstract InputStreamSource getScreenshot ()

Toma una captura de pantalla del dispositivo.

Muestra
InputStreamSource	Un InputStreamSource de la captura de pantalla en formato PNG o null si la captura de pantalla no se realizó correctamente

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

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

Muestra el valor de la configuración solicitada. namespace debe ser una de las siguientes opciones: {"system", "secure", "global"}

Parámetros
userId	int
namespace	String
key	String

Muestra
String	el valor asociado con el espacio de nombres:clave de un usuario. Es nulo si no se encuentra.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

Consulta getSetting(int, String, String) y se realizó en el usuario del sistema.

Parámetros
namespace	String
key	String

Muestra
String

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Recupera los nombres de los paquetes de la aplicación que se pueden desinstalar. En la actualidad, se define como paquetes que no son del sistema y paquetes del sistema actualizados.

Muestra
	ERROR(/Set) de nombres de paquetes String que se pueden desinstalar instalados actualmente en el dispositivo.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

Busca y muestra las marcas de un usuario determinado. Las marcas se definen en la clase "android.content.pm.UserInfo" del Proyecto de código abierto de Android.

Parámetros
userId	int

Muestra
int	las marcas asociadas con el userId proporcionado si se encuentra, -10000 en cualquier otro caso

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Obtiene el mapa de useId a UserInfo en el dispositivo. Lanzará DeviceRuntimeException si el resultado del dispositivo no es el esperado.

Muestra
	la lista de objetos UserInfo.

Arroja
	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 userId si se encuentra, -10000 en cualquier otro caso.

Parámetros
userId	int

Muestra
int

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

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

Parámetros
feature	String: Indica qué formato debe ser "feature:" o "" directamente.

Muestra
boolean	Es verdadero si se encuentra el atributo. De lo contrario, es falso.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

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

Instala un paquete de Android en el dispositivo.

Parámetros
packageFile	File: Es el archivo APK que se instalará.
reinstall	boolean: true si se debe realizar una reinstalación
extraArgs	String: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para conocer las opciones disponibles.

Muestra
String	Un String con un código de error o null si se realiza correctamente.

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

installPackage

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

Instala 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: Es el archivo APK que se 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: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

Muestra
String	Un String con un código de error o null si se realiza correctamente.

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

installPackageForUser

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

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

Parámetros
packageFile	File: Es el archivo APK que se instalará.
reinstall	boolean: true si se debe realizar una reinstalación
userId	int: Es el ID de usuario entero para el que se instalará.
extraArgs	String: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para conocer las opciones disponibles.

Muestra
String	una String con un código de error, o null si se ejecuta de forma correcta.

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

instalarPackageForUser

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

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

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

Parámetros
packageFile	File: Es el archivo APK que se instalará.
reinstall	boolean: true si se debe realizar una reinstalación
grantPermissions	boolean: Indica si se deben otorgar todos los permisos de tiempo de ejecución en el momento de la instalación.
userId	int: Es el ID de usuario entero para el que se instalará.
extraArgs	String: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para conocer las opciones disponibles.

Muestra
String	Un String con un código de error o null si se realiza correctamente.

Arroja
DeviceNotAvailableException	Si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException	si la plataforma del dispositivo no admite el permiso de tiempo de ejecución.

installPackages

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

Instala una aplicación para Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales). Consulta "https://developer.android.com/studio/build/configure-apk-splits" para aprender a dividir el APK en varios archivos.

Parámetros
packageFiles	: Los archivos APK locales
reinstall	boolean: Es la true si se debe reinstalar el sistema.
extraArgs	String: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para conocer las opciones disponibles.

Muestra
String	Un String con un código de error o null si se realiza correctamente.

Arroja
DeviceNotAvailableException	Si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException	si la plataforma del dispositivo no admite el permiso de tiempo de ejecución.

installPackages

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

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

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

Parámetros
packageFiles	: Las rutas de acceso de los archivos APK remotos que se instalarán
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: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

Muestra
String	Un String con un código de error o null si se realiza correctamente.

Arroja
DeviceNotAvailableException	Si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException	si la plataforma del dispositivo no admite el permiso de tiempo de ejecución.

installPackagesForUser

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

Instala una aplicación para Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales) para un usuario determinado. Consulta "https://developer.android.com/studio/build/configure-apk-splits" para aprender a dividir el APK en varios archivos.

Parámetros
packageFiles	: Los archivos APK locales
reinstall	boolean: true si se debe realizar una reinstalación
userId	int: Es el ID de usuario entero para el que se instalará.
extraArgs	String: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para conocer las opciones disponibles.

Muestra
String	Un String con un código de error o null si se realiza correctamente.

Arroja
DeviceNotAvailableException	Si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException	si la plataforma del dispositivo no admite el permiso de tiempo de ejecución.

installPackagesForUser

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

Instala una aplicación para Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales) para un usuario determinado. Consulta "https://developer.android.com/studio/build/configure-apk-splits" para obtener información sobre cómo dividir el 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: Indica si se deben otorgar todos los permisos de tiempo de ejecución en el momento de la instalación.
userId	int: Es el ID de usuario entero para el que se instalará.
extraArgs	String: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para conocer las opciones disponibles.

Muestra
String	una String con un código de error, o null si se ejecuta de forma correcta.

Arroja
DeviceNotAvailableException	Si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException	si la plataforma del dispositivo no admite el permiso de tiempo de ejecución.

installRemotePackages

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

Instala una aplicación para Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales) que se encuentran en el dispositivo Android. Consulta "https://developer.android.com/studio/build/configure-apk-splits" para obtener información sobre cómo dividir el APK en varios archivos.

Parámetros
remoteApkPaths	: Las rutas de acceso de los archivos APK remotos
reinstall	boolean: true si se debe realizar una reinstalación
extraArgs	String: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para conocer las opciones disponibles.

Muestra
String	Un String con un código de error o null si se realiza correctamente.

Arroja
DeviceNotAvailableException	Si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException	si la plataforma del dispositivo no admite el permiso de tiempo de ejecución.

installRemotePackages

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

Instala una aplicación para Android compuesta por varios archivos APK (uno principal y paquetes divididos adicionales) que se encuentran en el dispositivo Android. Consulta "https://developer.android.com/studio/build/configure-apk-splits" para obtener información sobre cómo dividir el APK en varios archivos.

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

Parámetros
remoteApkPaths	: Las rutas de acceso de los 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: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

Muestra
String	Un String con un código de error o null si se realiza correctamente.

Arroja
DeviceNotAvailableException	Si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException	si la plataforma del dispositivo no admite el permiso de tiempo de ejecución.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Muestra si el dispositivo usa el modo de usuario del sistema sin interfaz gráfica.

Muestra
boolean

Arroja
DeviceNotAvailableException

EsMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

Muestra si el usuario principal es un administrador permanente y no se puede borrar ni cambiar a un estado que no sea de administrador.

Muestra
boolean

Arroja
DeviceNotAvailableException

Compatibilidad con múltiples usuarios

public abstract boolean isMultiUserSupported ()

Determina si se admite el modo multiusuario.

Muestra
boolean	Es verdadero si se admite el uso multiusuario; de lo contrario, es falso.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

PaqueteInstalado

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Consulta el dispositivo para un nombre de paquete y un ID de usuario determinados para verificar si está instalado o no para ese usuario.

Parámetros
packageName	String: Es el paquete que estamos verificando si está instalado.
userId	String: Es el ID de usuario para el que estamos verificando que se haya instalado el paquete. Si es nulo, se usará el usuario principal cero.

Muestra
boolean	Es verdadero si el paquete se informa como instalado. De lo contrario, el valor es falso.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

Consulta el dispositivo para un nombre de paquete determinado y comprueba si está instalado o no.

Parámetros
packageName	String

Muestra
boolean	Es verdadero si el paquete se informa como instalado. De lo contrario, el valor es falso.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

EstáUserRunning

public abstract boolean isUserRunning (int userId)

Verifica si un usuario determinado está en ejecución.

Parámetros
userId	int

Muestra
boolean	Es verdadero si el usuario está corriendo y falso en todos los demás casos.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

Muestra si el usuario especificado es un usuario secundario según sus marcas.

Parámetros
userId	int

Muestra
boolean	Es verdadero si el usuario es secundario; de lo contrario, es falso.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

Verifica si el usuario determinado es visible.

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

Parámetros
userId	int

Muestra
boolean

Arroja
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Verifica si el usuario determinado es visible en la pantalla determinada.

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

Parámetros
userId	int
displayId	int

Muestra
boolean

Arroja
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

Si es así, puedes llamar a startVisibleBackgroundUser(int, int, boolean) y pasar una pantalla que muestra listDisplayIdsForStartingVisibleBackgroundUsers() (que debe incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Muestra
boolean

Arroja
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

Si es así, puedes llamar a startVisibleBackgroundUser(int, int, boolean) y pasar una pantalla que muestra listDisplayIdsForStartingVisibleBackgroundUsers().

Muestra
boolean

Arroja
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Prueba si la red Wi-Fi está habilitada.

Comprueba si el Wi-Fi está habilitado en el dispositivo. Es útil para confirmar el estado de Wi-Fi antes de las pruebas que no deben ejecutarse con Wi-Fi, p.ej., pruebas de datos móviles.

Muestra
boolean	true si el Wi-Fi está habilitado. false si está inhabilitado

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

listDisplayIds

public abstract  listDisplayIds ()

Recopila la lista de ID de pantallas disponibles en el dispositivo según lo informa "dumpsys SurfaceFlinger".

Muestra
	La lista de pantallas El valor predeterminado siempre muestra la pantalla predeterminada 0.

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

Muestra

Arroja
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

Obtiene la lista de usuarios del dispositivo. Lanzará DeviceRuntimeException si el resultado del dispositivo no es el esperado.

Muestra
	la lista de IDs de usuario.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Método auxiliar para tomar un informe de errores y registrarlo en los generadores de informes.

Parámetros
dataName	String: Es el nombre con el que se informará el informe de errores.
listener	ITestLogger: Un ITestLogger para registrar el informe de errores.

Muestra
boolean	Es verdadero si el registro se realizó correctamente; de lo contrario, es falso.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Notifica al dispositivo que espere a que se complete snapuserd.

Parámetros
waitPhase	SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver para este dispositivo.

Todos los IDeviceActionReceiver registrados recibirán una notificación antes de que se inicie una acción del dispositivo y después de que esta finalice.

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

quitarAdministrador

public abstract boolean removeAdmin (String componentName, 
                int userId)

Quita el administrador del dispositivo determinado en el usuario determinado y muestra true si se realiza correctamente, false de lo contrario.

Parámetros
componentName	String: Es el administrador de dispositivos que se quitará.
userId	int: del usuario en el que reside el administrador del dispositivo.

Muestra
boolean	Es verdadero si tiene éxito. De lo contrario, es falso.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

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

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

Quita a un usuario determinado del dispositivo.

Parámetros
userId	int: Es el usuario que se quitará.

Muestra
boolean	Es verdadero si se quitó correctamente el usuario; de lo contrario, es falso.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Establece un componente de administrador de dispositivos como propietario del dispositivo en un usuario determinado.

Parámetros
componentName	String: del administrador del dispositivo será propietario del dispositivo.
userId	int: del usuario en el que vive el propietario del dispositivo.

Muestra
boolean	Es verdadero si tiene éxito. De lo contrario, es falso.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

Consulta setSetting(int, String, String, String) y realiza la acción en el usuario del sistema.

Parámetros
namespace	String
key	String
value	String

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

Agrega un valor de configuración al espacio de nombres de un usuario determinado. Algunos parámetros de configuración solo estarán disponibles después de reiniciar el dispositivo. namespace debe ser una de las siguientes opciones: {"system", "secure", "global"}

Parámetros
userId	int
namespace	String
key	String
value	String

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

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

Parámetros
userId	int: Del usuario que se iniciará en segundo plano

Muestra
boolean	Es verdadero si el usuario se inició correctamente en segundo plano.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

Parámetros
userId	int: del usuario para iniciar en segundo plano
waitFlag	boolean: Hará que el comando espere hasta que se inicie y desbloquee el usuario.

Muestra
boolean	Es verdadero si el usuario se inició correctamente en segundo plano.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

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

Parámetros
userId	int: del usuario para iniciar en segundo plano
displayId	int: Muestra para que el usuario sea visible en
waitFlag	boolean: Hará que el comando espere hasta que se inicie y desbloquee el usuario.

Muestra
boolean	true si el usuario se inició correctamente y es visible en segundo plano.

Arroja
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

Detiene a un usuario determinado. Si el usuario ya se detuvo, este método es un NOOP. No se pueden detener el usuario actual y el del sistema.

Parámetros
userId	int: del usuario que se detendrá.

Muestra
boolean	Es verdadero si se detuvo al usuario correctamente.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

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

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

Parámetros
userId	int: del usuario que se detendrá.
waitFlag	boolean: Hará que el comando espere hasta que se detenga el usuario.
forceFlag	boolean: Detendrá el usuario de forma forzosa.

Muestra
boolean	Es verdadero si se detuvo al usuario correctamente.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

Cambia a otro userId con un tiempo de espera predeterminado. switchUser(int, long).

Parámetros
userId	int

Muestra
boolean	Es verdadero si el userId nuevo coincide con el proveedor de userId. De lo contrario, es falso.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Cambia a otro userId con el tiempo de espera proporcionado como fecha límite. Intenta inhabilitar el bloqueo de teclado después de que se realiza correctamente el cambio de usuario.

Parámetros
userId	int
timeout	long: Esperar antes de mostrar un valor falso para que falle el cambio de usuario.

Muestra
boolean	Es verdadero si el userId nuevo coincide con el proveedor de userId. De lo contrario, es falso.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Toma un informe de errores y devuélvelo dentro de un objeto Bugreport para controlarlo. Muestra un valor nulo en caso de que haya un problema. El archivo al que se hace referencia en el objeto del informe de errores se debe limpiar a través de Bugreport.close().

Muestra
Bugreport

desinstalarPaquete

public abstract String uninstallPackage (String packageName)

Desinstala un paquete de Android del dispositivo.

Parámetros
packageName	String: Es el paquete de Android que se desinstalará.

Muestra
String	Un String con un código de error o null si se realiza correctamente.

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

desinstalarPaqueteParaUsuario

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Desinstala un paquete de Android del dispositivo de un usuario determinado.

Parámetros
packageName	String: Es el paquete de Android que se desinstalará.
userId	int: Es el ID de usuario entero para el que se debe desinstalar.

Muestra
String	Un String con un código de error o null si se realiza correctamente.

Arroja
DeviceNotAvailableException	Si se pierde la conexión con el dispositivo y no se puede recuperar.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Si corresponde, espera a que se complete snapuserd.

Parámetros
currentPhase	SnapuserdWaitPhase

Arroja
DeviceNotAvailableException