Dispositivo de prueba

public class TestDevice
extends NativeDevice

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


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