Dispositivo de prueba

public class TestDevice
extends NativeDevice

Objeto java.lang.
↳	com.android.tradefed.device.NativeDevice
	↳	com.android.tradefed.device.TestDevice.

Subclases directas conocidas ManagedRemoteDevice, NestedRemoteDevice y RemoteAndroidDevice ManagedRemoteDevice Un dispositivo que se ejecuta en una máquina virtual que administramos de forma remota mediante una instancia de Tradefed la VM.  NestedRemoteDevice Representación del dispositivo que se ejecuta dentro de una VM de Cuttlefish remota.  RemoteAndroidDevice Implementación de un ITestDevice para un dispositivo Android de pila completa conectado a través de adb connect.

Subcategorías indirectas conocidas LocalAndroidVirtualDevice y RemoteAndroidVirtualDevice. LocalAndroidVirtualDevice. Es la clase para dispositivos virtuales locales que se ejecutan en el host de TradeFed.  RemoteAndroidVirtualDevice Extiende el comportamiento de RemoteAndroidDevice para un dispositivo Android de pila completa que se ejecuta en Google Compute Engine (GCE)

---

Implementación de ITestDevice para un dispositivo Android de pila completa

Resumen

Clases anidadas
class	TestDevice.MicrodroidBuilder Es un compilador que se usa para crear un Microdroid TestDevice.

Campos
public static final String	DISMISS_KEYGUARD_CMD Comandos que se pueden usar para descartar el bloqueo de teclado

Constructores públicos
TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Métodos públicos
boolean	canSwitchToHeadlessSystemUser() Muestra si se le permite cambiar al usuario de SYSTEM sin interfaz gráfica.
boolean	clearErrorDialogs() Intenta descartar los diálogos de error que se muestran actualmente en la IU del dispositivo.
int	createUser(String name) Crea un usuario con un nombre determinado y las marcas predeterminadas 0.
int	createUser(String name, boolean guest, boolean ephemeral, boolean forTesting) Crea un usuario con un nombre determinado y las marcas proporcionadas
int	createUser(String name, boolean guest, boolean ephemeral) Crea un usuario con un nombre determinado y las marcas proporcionadas
int	createUserNoThrow(String name) Crea un usuario con un nombre determinado y las marcas predeterminadas 0.
void	disableKeyguard() Intenta inhabilitar el bloqueo del teclado.
boolean	doesFileExist(String deviceFilePath) Es un método de ayuda para determinar si existe un archivo en el dispositivo.
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.
File	dumpHeap(String process, String devicePath) Intenta volcar el montón desde system_server.
	getActiveApexes() Recupera la información sobre los APEX activados en el dispositivo.
	getAllSettings(String namespace) Muestra los pares clave-valor del espacio de nombres solicitado.
String	getAndroidId(int userId) Busca y muestra el android-id asociado con un userId; si no lo encuentras, es nulo.
	getAndroidIds() Crea un mapa de los ID de Android encontrados que coincidan con los ID de usuario.
PackageInfo	getAppPackageInfo(String packageName) Recupera información sobre un paquete instalado en el dispositivo.
	getAppPackageInfos() Recupera información de paquetes instalados en el dispositivo.
InputStreamSource	getBugreport() Recupera un informe de errores del dispositivo.
InputStreamSource	getBugreportz() Recupera un bugreportz del dispositivo.
DeviceFoldableState	getCurrentFoldableState() Muestra el estado plegable actual del dispositivo o un valor nulo si se produjeron algunos problemas.
int	getCurrentUser() Muestra el ID del usuario en ejecución actual.
	getFoldableStates() Devuelve la lista de estados plegables en el dispositivo.
	getInstalledPackageNames() Recupera los nombres de paquetes de aplicaciones presentes en el dispositivo.
KeyguardControllerState	getKeyguardState() Muestra un objeto para obtener el estado actual de la protección de teclado o un valor nulo si no se admite.
Integer	getMainUserId() Muestra el ID de usuario principal.
	getMainlineModuleInfo() Obtén información sobre los módulos de línea principales instalados en el dispositivo.
int	getMaxNumberOfRunningUsersSupported() Obtén la cantidad máxima de usuarios que se ejecutan de manera simultánea.
int	getMaxNumberOfUsersSupported() Obtén la cantidad máxima de usuarios admitidos.
Integer	getPrimaryUserId() Muestra el ID de usuario principal.
InputStreamSource	getScreenshot() Toma una captura de pantalla del dispositivo.
InputStreamSource	getScreenshot(String format, boolean rescale) Toma una captura de pantalla del dispositivo.
InputStreamSource	getScreenshot(String format) Toma una captura de pantalla del dispositivo.
InputStreamSource	getScreenshot(long displayId) Toma una captura de pantalla del ID de visualización del dispositivo.
String	getSetting(String namespace, String key) Consulta getSetting(int, String, String) y se realizó en el usuario del sistema.
String	getSetting(int userId, String namespace, String key) Muestra el valor de la configuración solicitada.
	getUninstallablePackageNames() Recupera los nombres de los paquetes de aplicaciones que se pueden desinstalar.
int	getUserFlags(int userId) Busca y muestra las marcas de un usuario determinado.
	getUserInfos() Obtiene el mapa de useId como UserInfo en el dispositivo.
int	getUserSerialNumber(int userId) Devuelve el número de serie asociado con el userId si lo encuentras; -10000 en cualquier otro caso.
boolean	hasFeature(String feature) Comprueba si una función está disponible en un dispositivo.
String	installPackage(File packageFile, boolean reinstall, String... extraArgs) Instala un paquete de Android en el dispositivo.
String	installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Instala un paquete de Android en el dispositivo.
String	installPackage(File packageFile, File certFile, boolean reinstall, String... extraArgs) Instala un paquete de Android en el dispositivo.
String	installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Instala un paquete de Android en el dispositivo para un usuario determinado.
String	installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs) Instala un paquete de Android en el dispositivo para un usuario determinado.
String	installPackages( packageFiles, boolean reinstall, String... extraArgs)
String	installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
String	installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
String	installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)
String	installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)
String	installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)
boolean	isAppEnumerationSupported() Cómo comprobar si la plataforma en el dispositivo admite la enumeración de apps
boolean	isHeadlessSystemUserMode() Indica si el dispositivo usa el modo de usuario del sistema sin interfaz gráfica.
boolean	isMainUserPermanentAdmin() Muestra si el usuario principal es un administrador permanente y si no se puede borrar ni cambiar a una versión inferior no es administrador.
boolean	isMultiUserSupported() Determina si se admite multiusuario.
boolean	isPackageInstalled(String packageName) Consulta el dispositivo para obtener un nombre de paquete determinado para comprobar si está instalado o no.
boolean	isPackageInstalled(String packageName, String userId) Consulta el dispositivo para obtener un nombre de paquete y un ID de usuario determinados para comprobar si está actualmente instalado o no para ese usuario.
boolean	isUserRunning(int userId) Verifica si un usuario determinado está en ejecución.
boolean	isUserSecondary(int userId) Muestra si el usuario especificado es un usuario secundario según sus marcas.
boolean	isUserVisible(int userId) Comprueba si el usuario especificado es visible.
boolean	isUserVisibleOnDisplay(int userId, int displayId) Comprueba si el usuario determinado es visible en la pantalla determinada.
boolean	isVisibleBackgroundUsersOnDefaultDisplaySupported() Muestra si el dispositivo permite que los usuarios se inicien visibles en segundo plano en ERROR(/java.android.view.Display#DEFAULT_DISPLAY).
boolean	isVisibleBackgroundUsersSupported() Muestra si el dispositivo permite que los usuarios se inicien visibles en segundo plano.
	listDisplayIds() Recopila la lista de ID de pantallas disponibles en el dispositivo según lo informa "dumpsys". SurfaceFlinger”.
	listDisplayIdsForStartingVisibleBackgroundUsers() Obtiene la lista de pantallas que se pueden usar para start a user visible in the background.
	listUsers() Obtiene la lista de usuarios en el dispositivo.
boolean	logBugreport(String dataName, ITestLogger listener) Es un método de ayuda para tomar un informe de errores y registrarlo en los generadores.
void	notifySnapuserd(SnapuserdWaitPhase waitPhase)
void	postInvocationTearDown(Throwable exception) Pasos adicionales para la limpieza obligatoria específica del dispositivo que se ejecutará después de la invocación el proyecto.
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.
void	removeOwners() Quita a todos los propietarios de perfiles de dispositivo existentes con todo lo que puedas.
boolean	removeUser(int userId) Quitar a un usuario determinado del dispositivo
boolean	setDeviceOwner(String componentName, int userId) Establece un componente de administración de dispositivos como propietario para un usuario determinado.
void	setSetting(String namespace, String key, String value) Consulta setSetting(int, String, String, String) y se realizó en el usuario del sistema.
void	setSetting(int userId, String namespace, String key, String value) Agrega un valor de configuración al espacio de nombres de un usuario determinado.
void	shutdownMicrodroid(ITestDevice microdroidDevice) Apaga el dispositivo microdroide, si hay uno.
boolean	startUser(int userId) Inicia un usuario determinado en segundo plano si está detenido.
boolean	startUser(int userId, boolean waitFlag) Inicia un usuario determinado en segundo plano si está detenido.
boolean	startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag) Inicia un usuario determinado en segundo plano, visible en la pantalla determinada (es decir, permitiendo al usuario para iniciar actividades en esa pantalla).
boolean	stopUser(int userId, boolean waitFlag, boolean forceFlag) Detener un usuario determinado
boolean	stopUser(int userId) Detiene a un usuario determinado.
boolean	supportsMicrodroid() Verifica las condiciones previas para ejecutar un microdroid.
boolean	supportsMicrodroid(boolean protectedVm) Verifica las condiciones previas para ejecutar un microdroid.
boolean	switchUser(int userId) Cambia a otro userId con un tiempo de espera predeterminado.
boolean	switchUser(int userId, long timeout) Cambia a otro userId con el tiempo de espera proporcionado como fecha límite.
Bugreport	takeBugreport() Toma un informe de errores y lo muestra dentro de un objeto Bugreport para controlarlo.
String	uninstallPackage(String packageName) Desinstala un paquete de Android del dispositivo.
String	uninstallPackageForUser(String packageName, int userId) Desinstala el paquete de Android del dispositivo para un usuario determinado.
void	waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Métodos protegidos
AaptParser	createParser(File appFile)
void	doAdbReboot(NativeDevice.RebootMode rebootMode, String reason) Ejecuta un reinicio de adb.
InputStreamSource	getBugreportInternal()
File	getBugreportzInternal() Es un método de ayuda interno para obtener el archivo ZIP bugreportz como ERROR(/File).
long	getCheckNewUserSleep() Expuesto para realizar pruebas.
long	getHostCurrentTime() Expuesto para realizar pruebas
void	prePostBootSetup() Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) anule este método para una configuración específica posterior al inicio.

Campos

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Comandos que se pueden usar para descartar el bloqueo de teclado

Constructores públicos

Dispositivo de prueba

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

Métodos públicos

Cambiar a usuario del sistema sin cabeza

public boolean canSwitchToHeadlessSystemUser ()

Muestra si se le permite cambiar al usuario de SYSTEM sin interfaz gráfica.

Muestra
boolean

Arroja
DeviceNotAvailableException

deleteErrorDialogs

public 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. De lo contrario, false.

Arroja
DeviceNotAvailableException

createUser

public int createUser (String name)

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

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

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

Arroja
DeviceNotAvailableException

createUser

public 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 de usuario --efímeros durante la creación
forTesting	boolean: Habilita la marca de prueba --for-testing durante la creación

Muestra
int	ID del usuario creado

Arroja
DeviceNotAvailableException

createUser

public 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 de usuario --efímeros durante la creación

Muestra
int	ID del usuario creado

Arroja
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

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

Parámetros
name	String: del 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
DeviceNotAvailableException

deshabilitar bloqueo de teclado

public void disableKeyguard ()

Intenta inhabilitar el bloqueo del teclado.

Primero, espera a que esté listo el envío. Esto sucede casi al mismo tiempo que El dispositivo informa BOOT_COMPLETE, aparentemente de forma asíncrona, porque el framework actual. implementación tiene una condición de carrera ocasional. A continuación, se envía el comando para descartar el bloqueo del teclado (funciona solo en las que no son seguras)

Arroja
DeviceNotAvailableException

haceArchivoexist

public boolean doesFileExist (String deviceFilePath)

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

Parámetros
deviceFilePath	String: Es la ruta de acceso absoluta del archivo en el dispositivo que se debe verificar.

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

Arroja
DeviceNotAvailableException

haceArchivoexist

public 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 ya existe; de lo contrario, false.

Arroja
DeviceNotAvailableException

Volcado de montón

public File dumpHeap (String process, 
                String devicePath)

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

Parámetros
process	String: Es el nombre del proceso del dispositivo en el que se realizará el volcado de nuevo.
devicePath	String: Es la ruta de acceso en el dispositivo en el que 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. Nulo si algo falló.

Arroja
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

Muestra
	Actualmente, hay ERROR(/Set) de ApexInfo activados en el dispositivo

Arroja
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

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

Parámetros
namespace	String: debe ser {"system", "secure", "global"}

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

Arroja
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

Busca y muestra el android-id asociado con un userId; si no lo encuentras, es nulo.

Parámetros
userId	int

Muestra
String

Arroja
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

Crea un mapa de los ID de Android encontrados que coincidan con los ID de usuario. No hay un seguro de que cada usuario id encontrará un ID de Android asociado en esta función, por lo que algunos ID de usuario pueden coincidir con el valor nulo.

Muestra
	Mapa de los IDs de Android encontrados con los IDs de usuario.

Arroja
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

Parámetros
packageName	String

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

Arroja
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Recupera información de paquetes instalados en el dispositivo.

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

Arroja
DeviceNotAvailableException

informe getBug

public InputStreamSource getBugreport ()

Recupera un informe de errores del dispositivo.

Se garantiza que la implementación de esto seguirá funcionando en un dispositivo sin tarjeta sd (o cuando la sdcard aún no está activada).

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

getBugreportz

public InputStreamSource getBugreportz ()

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

Solo es compatible con "adb version". > 1.0.36

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

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

Muestra
DeviceFoldableState

Arroja
DeviceNotAvailableException

getCurrentUser.

public int getCurrentUser ()

Muestra el ID del usuario en ejecución actual. En caso de error, muestra -10000.

Muestra
int

Arroja
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

Devuelve la lista de estados plegables en el dispositivo. Se puede obtener con “cmd device_state”. estados de impresión”.

Muestra

Arroja
DeviceNotAvailableException

getInstallPackageNames

public  getInstalledPackageNames ()

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

Muestra
	Actualmente, hay ERROR(/Set) de String nombres de paquetes instalados en el dispositivo.

Arroja
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Muestra un objeto para obtener el estado actual de la protección de teclado o un valor nulo si no se admite.

Muestra
KeyguardControllerState	un KeyguardControllerState que contiene una instantánea del estado del bloqueo de teclado y muestra Null si la consulta de bloqueo de teclado no es compatible.

Arroja
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

Muestra el ID de usuario principal.

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

Arroja
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Obtén información sobre los módulos de línea principales instalados en el dispositivo.

Muestra
	Hay ERROR(/Set) de String módulos de línea principales instalados en el dispositivo actualmente.

Arroja
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public 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 simultáneamente

Arroja
DeviceNotAvailableException

getMaxNumberOfUsersSupported

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

ID de usuario principal de getPrimary

public Integer getPrimaryUserId ()

Muestra el ID de usuario principal.

Muestra
Integer	El userId del usuario principal si existe uno y nulo si no hay uno.

Arroja
DeviceNotAvailableException

obtener captura de pantalla

public InputStreamSource getScreenshot ()

Toma una captura de pantalla del dispositivo.

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

Arroja
DeviceNotAvailableException

obtener captura de pantalla

public 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 un tamaño más pequeño.

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

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

Arroja
DeviceNotAvailableException

obtener captura de pantalla

public InputStreamSource getScreenshot (String format)

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

Parámetros
format	String: PNG y JPEG compatibles

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

Arroja
DeviceNotAvailableException

obtener captura de pantalla

public InputStreamSource getScreenshot (long displayId)

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

PENDIENTE: Extender las implementaciones anteriores para admitir "formato" y reescalarla

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

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

Arroja
DeviceNotAvailableException

getSetting

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

getSetting

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

Muestra el valor de la configuración solicitada. el espacio de nombres debe ser uno de los siguientes: {"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. Nulo si no se encuentra.

Arroja
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

Muestra
	Actualmente, hay ERROR(/Set) de nombres de paquetes desinstalables de String instalados en el dispositivo.

Arroja
DeviceNotAvailableException

getUserFlags.

public int getUserFlags (int userId)

Busca y muestra las marcas de un usuario determinado. Las marcas se definen en "android.content.pm.UserInfo" en el 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
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

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

Muestra
	la lista de objetos UserInfo.

Arroja
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

Devuelve el número de serie asociado con el userId si lo encuentras; -10000 en cualquier otro caso.

Parámetros
userId	int

Muestra
int

Arroja
DeviceNotAvailableException

hasFeature

public boolean hasFeature (String feature)

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

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

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

Arroja
DeviceNotAvailableException

installPackage

public 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: Es la true si se debe reinstalar el sistema.
extraArgs	String: Son argumentos adicionales opcionales que se deben pasar. Consulta "adb shell pm -h". disponible opciones de estado.

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

Arroja
DeviceNotAvailableException

installPackage

public 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 requieren un control explícito para otorgar permisos de tiempo de ejecución en el tiempo de instalación debería llamar a esta función.

Parámetros
packageFile	File: Es el archivo APK que se instalará.
reinstall	boolean: Es la true si se debe reinstalar el sistema.
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 que se deben pasar. Consulta "adb shell pm -h". disponible opciones de estado.

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

Arroja
DeviceNotAvailableException

installPackage

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

Instala un paquete de Android en el dispositivo.

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

Parámetros
packageFile	File: Es el archivo APK que se instalará.
certFile	File: Es la true si se debe reinstalar el sistema.
reinstall	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 que se deben pasar. Consulta "adb shell pm -h". disponible opciones de estado.

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

Arroja
DeviceNotAvailableException

installPackageForUser

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

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

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

Parámetros
packageFile	File: Es el archivo APK que se instalará.
reinstall	boolean: Es la true si se debe reinstalar el sistema.
grantPermissions	boolean: 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 que se deben pasar. Consulta "adb shell pm -h". disponible opciones de estado.

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

Arroja
DeviceNotAvailableException

installPackageForUser

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

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

Parámetros
packageFile	File: Es el archivo APK que se instalará.
reinstall	boolean: Es la true si se debe reinstalar el sistema.
userId	int: Es el ID de usuario entero para el que se instalará.
extraArgs	String: Son argumentos adicionales opcionales que se deben pasar. Consulta "adb shell pm -h". disponible opciones de estado.

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

Arroja
DeviceNotAvailableException

installPackages

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

Parámetros
packageFiles
reinstall	boolean
extraArgs	String

Muestra
String

Arroja
DeviceNotAvailableException

installPackages

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

Parámetros
packageFiles
reinstall	boolean
grantPermissions	boolean
extraArgs	String

Muestra
String

Arroja
DeviceNotAvailableException

installPackagesForUser

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

Parámetros
packageFiles
reinstall	boolean
grantPermissions	boolean
userId	int
extraArgs	String

Muestra
String

Arroja
DeviceNotAvailableException

installPackagesForUser

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

Parámetros
packageFiles
reinstall	boolean
userId	int
extraArgs	String

Muestra
String

Arroja
DeviceNotAvailableException

installRemotePackages

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

Parámetros
remoteApkPaths
reinstall	boolean
extraArgs	String

Muestra
String

Arroja
DeviceNotAvailableException

installRemotePackages

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

Parámetros
remoteApkPaths
reinstall	boolean
grantPermissions	boolean
extraArgs	String

Muestra
String

Arroja
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Cómo comprobar si la plataforma en el dispositivo admite la enumeración de apps

Muestra
boolean	Es verdadero si se admite la enumeración de app. De lo contrario, es falso.

Arroja
DeviceNotAvailableException

Modo de usuario del sistema sin interfaz gráfica

public boolean isHeadlessSystemUserMode ()

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

Muestra
boolean

Arroja
DeviceNotAvailableException

EsMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

Muestra si el usuario principal es un administrador permanente y si no se puede borrar ni cambiar a una versión inferior no es administrador.

Muestra
boolean

Arroja
DeviceNotAvailableException

Compatibilidad con múltiples usuarios

public boolean isMultiUserSupported ()

Determina si se admite multiusuario.

Muestra
boolean	true si se admite multiusuarios; de lo contrario, false

Arroja
DeviceNotAvailableException

PaqueteInstalado

public boolean isPackageInstalled (String packageName)

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

Parámetros
packageName	String

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

Arroja
DeviceNotAvailableException

PaqueteInstalado

public boolean isPackageInstalled (String packageName, 
                String userId)

Consulta el dispositivo para obtener un nombre de paquete y un ID de usuario determinados para comprobar si está actualmente 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 verificaremos que el paquete esté instalado. Si es nulo, el usuario principal se usará cero.

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

Arroja
DeviceNotAvailableException

EstáUserRunning

public 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á en ejecución y es falso en todos los demás casos.

Arroja
DeviceNotAvailableException

UsuarioSecundario

public boolean isUserSecondary (int userId)

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

Parámetros
userId	int

Muestra
boolean	true si el usuario es secundario; de lo contrario, false

Arroja
DeviceNotAvailableException

esUserVisible

public boolean isUserVisible (int userId)

Comprueba si el usuario especificado es visible.

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

Parámetros
userId	int

Muestra
boolean

Arroja
DeviceNotAvailableException

esUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

Parámetros
userId	int
displayId	int

Muestra
boolean

Arroja
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Muestra si el dispositivo permite que los usuarios se inicien visibles 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 devuelve listDisplayIdsForStartingVisibleBackgroundUsers() (que debe incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Muestra
boolean

Arroja
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

Muestra
boolean

Arroja
DeviceNotAvailableException

IDDisplayDisplay

public  listDisplayIds ()

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

Muestra
	Es la lista de pantallas. El valor predeterminado siempre muestra el valor de visualización predeterminado 0.

Arroja
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Muestra

Arroja
DeviceNotAvailableException

usuarios de la lista

public  listUsers ()

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

Muestra
	la lista de IDs de usuario.

Arroja
DeviceNotAvailableException

informe de errores de registro

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Es un método de ayuda para tomar un informe de errores y registrarlo en los generadores.

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

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

notificaremos aSnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Parámetros
waitPhase	SnapuserdWaitPhase

TearDown después de la invocación

public void postInvocationTearDown (Throwable exception)

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

Parámetros
exception	Throwable: Si existe, es la excepción final que generó el error de invocación.

quitarAdministrador

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

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

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

Arroja
DeviceNotAvailableException

quitarPropietarios

public void removeOwners ()

Quita a todos los propietarios de perfiles de dispositivo existentes con todo lo que puedas.

Arroja
DeviceNotAvailableException

quitar el usuario

public boolean removeUser (int userId)

Quitar a un usuario determinado del dispositivo

Parámetros
userId	int: del usuario que se quitará

Muestra
boolean	true si logramos eliminar al usuario correctamente; de lo contrario, false.

Arroja
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Establece un componente de administración de dispositivos como propietario para 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
DeviceNotAvailableException

setSetting

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

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

Parámetros
namespace	String
key	String
value	String

Arroja
DeviceNotAvailableException

setSetting

public 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 un reinicio. el espacio de nombres debe ser uno de los siguientes: {"system", "secure", "global"}

Parámetros
userId	int
namespace	String
key	String
value	String

Arroja
DeviceNotAvailableException

apagadoMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Apaga el dispositivo microdroide, si hay uno.

Parámetros
microdroidDevice	ITestDevice

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Usuario de inicio

public boolean startUser (int userId)

Inicia un usuario determinado en segundo plano si está detenido. Si el usuario ya está que se ejecuta en segundo plano, este es un NOOP.

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

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

Arroja
DeviceNotAvailableException

Usuario de inicio

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

Arroja
DeviceNotAvailableException

startVisibleBackgroundUser

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

Inicia un usuario determinado en segundo plano, visible en la pantalla determinada (es decir, permitiendo al usuario para 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 que se iniciará en segundo plano
displayId	int: Muestra para que el usuario sea visible en
waitFlag	boolean: Hace que el comando espere hasta que el usuario se inicie y se desbloquee.

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

Arroja
DeviceNotAvailableException

usuario detención

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

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

Parámetros
userId	int: del usuario que debe detenerse
waitFlag	boolean: Hace que el comando espere hasta que se detenga el usuario.
forceFlag	boolean: Forzará la detención del usuario.

Muestra
boolean	true si el usuario se detuvo correctamente.

Arroja
DeviceNotAvailableException

usuario detención

public 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 debe detenerse

Muestra
boolean	true si el usuario se detuvo correctamente.

Arroja
DeviceNotAvailableException

admiteMicrodroid

public boolean supportsMicrodroid ()

Verifica las condiciones previas para ejecutar un microdroid.

Muestra
boolean	devuelve el valor true si se cumplen las condiciones previas; de lo contrario, false.

admiteMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

Verifica las condiciones previas para ejecutar un microdroid.

Parámetros
protectedVm	boolean: Es verdadero si microdroid se ejecutará en una VM protegida.

Muestra
boolean	devuelve el valor true si se cumplen las condiciones previas; de lo contrario, false.

Cambiar de usuario

public 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, el valor es falso.

Arroja
DeviceNotAvailableException

Cambiar de usuario

public boolean switchUser (int userId, 
                long timeout)

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

Parámetros
userId	int
timeout	long: Espera antes de mostrar un valor falso para switch-user.

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

Arroja
DeviceNotAvailableException

informe de errores de toma

public Bugreport takeBugreport ()

Toma un informe de errores y lo muestra dentro de un objeto Bugreport para controlarlo. Se 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 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	una String con un código de error, o null si se ejecuta de forma correcta.

Arroja
DeviceNotAvailableException

desinstalarPaqueteParaUsuario

public String uninstallPackageForUser (String packageName, 
                int userId)

Desinstala el paquete de Android del dispositivo para 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	una String con un código de error, o null si se ejecuta de forma correcta.

Arroja
DeviceNotAvailableException

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Parámetros
currentPhase	SnapuserdWaitPhase

Arroja
DeviceNotAvailableException

Métodos protegidos

createParser

protected AaptParser createParser (File appFile)

Parámetros
appFile	File

Muestra
AaptParser

Reinicio de doAdb

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

Ejecuta un reinicio de adb.

Parámetros
rebootMode	NativeDevice.RebootMode: Es un modo de este reinicio.
reason	String: Para este reinicio.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreportInterno

protected InputStreamSource getBugreportInternal ()

Muestra
InputStreamSource

getBugreportzInterno

protected File getBugreportzInternal ()

Es un método de ayuda interno para obtener el archivo ZIP bugreportz como ERROR(/File).

Muestra
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Expuesto para realizar pruebas.

Muestra
long

getHostCurrentTime

protected long getHostCurrentTime ()

Expuesto para realizar pruebas

Muestra
long

Configuración previa al inicio posterior

protected void prePostBootSetup ()

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

Arroja
DeviceNotAvailableException