Dispositivo nativo

public class NativeDevice
extends Object implements IManagedTestDevice, IConfigurationReceiver, ITestLoggerReceiver

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


Es la implementación predeterminada de un dispositivo Android ITestDevice que no es de pila completa.

Resumen

Clases anidadas

class NativeDevice.AdbAction

Un ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) para ejecutar un comando “adb ....” del SO. 

class NativeDevice.AdbShellAction

 

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) para reiniciar un dispositivo. 

Constantes

int INVALID_USER_ID

Valor que se muestra para cualquier ID de usuario no válido o no encontrado: UserHandle definió el valor -10000

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

la cantidad predeterminada de reintentos de comando para realizar

Campos

public static final String DEBUGFS_PATH

protected static final String SD_CARD

protected static final String STORAGE_EMULATED

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

Constructores públicos

NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Crea un TestDevice.

Métodos públicos

void batchPrefetchStartupBuildProps()

Microoptimización (alrededor de 400 milisegundos) mediante la carga previa de todas las props que necesitamos, en lugar de llamar a "adb getprop" para cada una.

boolean canSwitchToHeadlessSystemUser()

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

boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Comprobar si una función es compatible actualmente con un nivel mínimamente admitido

boolean checkConnectivity()

Verifica que el dispositivo tenga conectividad de red.

boolean clearErrorDialogs()

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

void clearLastConnectedWifiNetwork()

Borra la última red Wi-Fi conectada.

void clearLogcat()

Borra todos los datos acumulados de logcat.

boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

Se conecta a una red Wi-Fi.

boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Se conecta a una red Wi-Fi.

boolean connectToWifiNetwork( wifiSsidToPsk)

Se conecta a una red Wi-Fi.

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

Se conecta a una red Wi-Fi.

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

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

boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

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

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

Crea un usuario con un nombre determinado y las marcas proporcionadas

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)

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

int createUserNoThrow(String name)

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

void deleteFile(String deviceFilePath, int userId)

Es un método de ayuda para borrar un archivo o directorio del dispositivo.

void deleteFile(String deviceFilePath)

Es un método de ayuda para borrar un archivo o directorio del dispositivo.

void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Quita el IDeviceActionReceiver registrado.

boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

Método de ayuda para verificar si el dispositivo se reinició de forma no definitiva comparando el system_server actual con el ProcessInfo anterior de system_server.

boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

Método de ayuda para verificar si el dispositivo se reinició de forma no definitiva desde la hora UTC desde la época del dispositivo y su ERROR(/TimeUnit).

boolean disableAdbRoot()

Desactiva la raíz de adb.

void disableKeyguard()

Intenta inhabilitar el bloqueo del teclado.

boolean disableNetworkMonitor()

Inhabilita la supervisión de red en el dispositivo.

boolean disconnectFromWifi()

Se desconecta de una red Wi-Fi.

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.

boolean doesFileExist(String deviceFilePath)

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

File dumpHeap(String process, String devicePath)

Intenta volcar el montón desde system_server.

boolean enableAdbRoot()

Activa la raíz de adb.

boolean enableNetworkMonitor()

Habilita la supervisión de red en el dispositivo.

String executeAdbCommand(long timeout, String... cmdArgs)

Es un método de ayuda que ejecuta un comando adb como un comando del sistema con un tiempo de espera especificado.

String executeAdbCommand(long timeout, envMap, String... cmdArgs)

Es un método de ayuda que ejecuta un comando adb como un comando del sistema con un tiempo de espera especificado.

String executeAdbCommand(String... cmdArgs)

Es un método de ayuda que ejecuta un comando adb como un comando del sistema.

CommandResult executeFastbootCommand(String... cmdArgs)

Método auxiliar que ejecuta un comando fastboot como un comando del sistema con un tiempo de espera predeterminado de 2 minutos.

CommandResult executeFastbootCommand(long timeout, String... cmdArgs)

Es un método de ayuda que ejecuta un comando fastboot como un comando del sistema.

CommandResult executeLongFastbootCommand(String... cmdArgs)

Es un método de ayuda que ejecuta un comando fastboot de larga duración como un comando del sistema.

CommandResult executeLongFastbootCommand( envVarMap, String... cmdArgs)

Método auxiliar que ejecuta un comando fastboot de larga duración como un comando del sistema con variables de entorno del sistema.

String executeShellCommand(String command)

Es un método de ayuda que ejecuta un comando shell de adb y muestra el resultado como String.

void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.

void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.

void executeShellCommand(String command, IShellOutputReceiver receiver)

Ejecuta el comando shell de adb determinado y vuelve a intentarlo varias veces si el comando falla.

CommandResult executeShellV2Command(String cmd)

Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como una CommandResult propagada correctamente con el resultado del estado del comando, stdout y stderr.

CommandResult executeShellV2Command(String cmd, OutputStream pipeToOutput)

Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como un CommandResult correctamente propagado con el resultado del estado del comando y stderr.

CommandResult executeShellV2Command(String cmd, File pipeAsInput)

Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como un CommandResult propagado correctamente con el resultado del estado del comando, stdout y stderr.

CommandResult executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.

CommandResult executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)

Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.

CommandResult executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.

CommandResult executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.

CommandResult fastbootWipePartition(String partition)

Es un método de ayuda que borra una partición del dispositivo.

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.

DeviceAllocationState getAllocationState()

Devuelve el estado de asignación actual del dispositivo

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.

int getApiLevel()

Obtén el nivel de API del dispositivo.

PackageInfo getAppPackageInfo(String packageName)

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

getAppPackageInfos()

Recupera información de paquetes instalados en el dispositivo.

String getBasebandVersion()

Método de conveniencia para obtener la versión de banda base (radio) de este dispositivo.

Integer getBattery()

Muestra el nivel de batería actual de un dispositivo o Valor Nulo si el nivel de batería no está disponible.

boolean getBooleanProperty(String name, boolean defaultValue)

Muestra el valor booleano de la propiedad especificada.

getBootHistory()

El método auxiliar recopila el mapa del historial de inicio con el tiempo y el motivo de inicio.

getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

El método auxiliar recopila el mapa del historial de inicio con el tiempo de inicio y el motivo de inicio desde el tiempo determinado desde el ciclo de entrenamiento del dispositivo y la unidad de tiempo especificada.

String getBootloaderVersion()

Método de conveniencia para obtener la versión del bootloader de este dispositivo.

InputStreamSource getBugreport()

Recupera un informe de errores del dispositivo.

InputStreamSource getBugreportz()

Recupera un bugreportz del dispositivo.

String getBuildAlias()

Recupera el alias de la compilación que el dispositivo está ejecutando actualmente.

String getBuildFlavor()

Recupera la variante de compilación para el dispositivo.

String getBuildId()

Recupera la compilación que el dispositivo está ejecutando actualmente.

String getBuildSigningKeys()

Devuelve el tipo de clave usado para firmar la imagen del dispositivo

Por lo general, los dispositivos Android pueden firmarse con claves de prueba (como en AOSP) o claves de lanzamiento (controladas por fabricantes de dispositivos individuales).

DeviceDescriptor getCachedDeviceDescriptor()

Muestra un DeviceDescriptor almacenado en caché si el dispositivo está asignado; de lo contrario, muestra el DeviceDescriptor actual.

DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

Muestra un DeviceDescriptor almacenado en caché si el dispositivo está asignado; de lo contrario, muestra el DeviceDescriptor actual.

String[] getChildren(String path)

Es una alternativa al uso de IFileEntry, que a veces no funciona debido a los permisos.

AbstractConnection getConnection()

La conexión actual asociada con el dispositivo.

ContentProviderHandler getContentProvider(int userId)

Muestra ContentProviderHandler o un valor nulo si no está disponible.

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.

String getDeviceClass()

Obtén la clase de dispositivo.

long getDeviceDate()

Muestra la fecha del dispositivo en milisegundos desde el ciclo de entrenamiento.

DeviceDescriptor getDeviceDescriptor()

Muestra un DeviceDescriptor a partir de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo en sí.

DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

Muestra un DeviceDescriptor a partir de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo en sí.

TestDeviceState getDeviceState()

Obtén el estado del dispositivo.

long getDeviceTimeOffset(Date date)

Es una herramienta de ayuda para obtener la diferencia de hora entre el dispositivo y un ERROR(/Date) determinado.

InputStreamSource getEmulatorOutput()

Cómo obtener la transmisión de stdout y stderr del emulador

Process getEmulatorProcess()

Muestra el Process correspondiente a este emulador.

final File getExecuteShellCommandLog()

El registro que contiene todos los registros de executeShellCommand(String).

long getExternalStoreFreeSpace()

Es un método de ayuda para determinar la cantidad de espacio libre en el almacenamiento externo del dispositivo.

String getFastbootPath()

Muestra la ruta de acceso del objeto binario de fastboot que se usa.

String getFastbootProductType()

Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.

String getFastbootProductVariant()

Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.

String getFastbootSerialNumber()

Devuelve el número de serie del modo fastboot.

String getFastbootVariable(String variableName)

Recupera el valor de la variable de fastboot específico del dispositivo.

String getFastbootVersion()

Muestra la cadena de versión del objeto binario de fastboot que se usa.

IFileEntry getFileEntry(String path)

Recupera una referencia a un archivo remoto en el dispositivo.

IFileEntry getFileEntry(FileListingService.FileEntry entry)

Es un asistente no oficial para obtener un FileEntry de una ruta no raíz.

getFoldableStates()

Devuelve la lista de estados plegables en el dispositivo.

IDevice getIDevice()

Muestra una referencia al IDevice de ddmlib asociado.

getInstalledPackageNames()

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

long getIntProperty(String name, long defaultValue)

Muestra el valor entero de la propiedad determinada del dispositivo.

String getIpAddress()

Obtiene la dirección IP del 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.

long getLastExpectedRebootTimeMillis()

Muestra la última vez que las APIs de Tradefed activaron un reinicio en milisegundos desde EPOCH, como lo muestra System.currentTimeMillis().

int getLaunchApiLevel()

Obtener el primer nivel de API iniciado en el dispositivo

InputStreamSource getLogcat()

Captura una transmisión de instantáneas de los datos de Logcat.

InputStreamSource getLogcat(int maxBytes)

Captura una transmisión de instantáneas del último maxBytes de los datos de logcat capturados.

InputStreamSource getLogcatDump()

Obtén un volcado del logcat actual del dispositivo.

InputStreamSource getLogcatSince(long date)

Captura una transmisión de instantáneas de los datos capturados de logcat a partir de la fecha proporcionada.

String getMacAddress()

Muestra la dirección MAC del dispositivo, que será nula si no se puede consultar desde el dispositivo.

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.

Process getMicrodroidProcess()
IDeviceStateMonitor getMonitor()

Devuelve el IDeviceStateMonitor asociado con el dispositivo.

String getMountPoint(String mountName)

Muestra un punto de activación.

ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

Muestra un MountPointInfo que corresponde a la ruta de acceso del punto de activación especificado, o null si esa ruta no tiene nada activado o no aparece en /proc/mounts como punto de activación.

getMountPointInfo()

Devuelve una versión analizada de la información en /proc/mounts en el dispositivo.

TestDeviceOptions getOptions()

Recupera las opciones de prueba para el dispositivo.

long getPartitionFreeSpace(String partition)

Método de ayuda para determinar la cantidad de espacio libre en la partición del dispositivo.

Integer getPrimaryUserId()

Muestra el ID de usuario principal.

ProcessInfo getProcessByName(String processName)

El método de ayuda ejecuta los comandos "pidof" y "stat", y muestra el objeto ProcessInfo con PID y la hora de inicio del proceso determinado.

String getProcessPid(String process)

Muestra el pid del servicio o un valor nulo si se produjo un error.

String getProductType()

Método de conveniencia para obtener el tipo de producto de este dispositivo.

String getProductVariant()

Método de conveniencia para obtener la variante de producto de este dispositivo.

String getProperty(String name)

Recupera el valor de propiedad determinado del dispositivo.

ITestDevice.RecoveryMode getRecoveryMode()

Obtén el modo de recuperación que se usa actualmente para el 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.

InputStreamSource getScreenshot(String format, boolean rescale)

Toma una captura de pantalla del dispositivo.

InputStreamSource getScreenshot()

Toma una captura de pantalla del dispositivo.

String getSerialNumber()

Método de conveniencia para obtener el número de serie de este dispositivo.

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

Muestra el valor de la configuración solicitada.

String getSetting(String namespace, String key)

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

String getSimOperator()

Muestra el operador de la tarjeta SIM o un valor nulo si no está disponible o si el dispositivo no está disponible.

String getSimState()

Devuelve el estado de la tarjeta SIM o muestra un valor nulo si no está disponible o el dispositivo no está disponible.

getTombstones()

Recupera y muestra la lista de tombstones de los dispositivos.

long getTotalMemory()

Devuelve el tamaño total de la memoria física en bytes o -1 en caso de error interno.

getUninstallablePackageNames()

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

boolean getUseFastbootErase()

Determina si se debe usar el formato de fastboot o borrado de fastboot para limpiar una partición del dispositivo.

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.

IManagedTestDevice.DeviceEventResponse handleAllocationEvent(DeviceEvent event)

Procesa un DeviceEvent determinado.

Procesar el DeviceEvent, lo que puede o no hacer la transición de este dispositivo a un nuevo estado de asignación

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 installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)

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

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

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

void invalidatePropertyCache()
boolean isAdbRoot()

boolean isAdbTcp()
boolean isAppEnumerationSupported()

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

boolean isBypassLowTargetSdkBlockSupported()

Verifica si la plataforma en el dispositivo admite la omisión del bloqueo del SDK de destino bajo en las instalaciones de apps

boolean isDebugfsMounted()

Verifica si el elemento debugfs está activado.

boolean isDeviceEncrypted()

Muestra si el dispositivo está encriptado.

boolean isDirectory(String path)

Muestra el valor True si la ruta de acceso en el dispositivo es un directorio. De lo contrario, muestra false.

boolean isEnableAdbRoot()
boolean isEncryptionSupported()

Se devuelve si el dispositivo admite la encriptación.

boolean isExecutable(String fullPath)

Muestra el valor True si la ruta de acceso al archivo en el dispositivo es ejecutable. De lo contrario, muestra false.

boolean isFastbootEnabled()

Muestra si fastboot está disponible para el dispositivo.

boolean isHeadless()

Muestra true si el dispositivo no tiene interfaz gráfica (sin pantalla). De lo contrario, muestra false.

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 no se puede borrar ni cambiar a el estado de no administrador.

boolean isMultiUserSupported()

Determina si se admite multiusuario.

boolean isPackageInstalled(String packageName, String userId)

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

boolean isPackageInstalled(String packageName)

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

boolean isRuntimePermissionSupported()

Verifica si la plataforma integrada en el dispositivo admite el otorgamiento de permisos de tiempo de ejecución

boolean isStateBootloaderOrFastbootd()

Muestra true si el dispositivo está en TestDeviceState#FASTBOOT o TestDeviceState.FASTBOOTD.

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.

boolean isWifiEnabled()

Prueba si el Wi-Fi está habilitado.

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 logAnrs(ITestLogger logger)

Recopila y registra ANR del 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 logOnDevice(String tag, Log.LogLevel level, String format, Object... args)

Registra un mensaje en el logcat del dispositivo.

void mountDebugfs()

Activa Debugfs.

void nonBlockingReboot()

Emite un comando para reiniciar el dispositivo y muestra cuando se completa el comando y cuando el dispositivo ya no es visible para adb.

void postAdbRootAction()

Anula si el dispositivo necesita que se realicen algunas acciones específicas después de la raíz de adb y antes de que el dispositivo vuelva a estar en línea.

void postAdbUnrootAction()

Anula si el dispositivo necesita que se realicen algunas acciones específicas después de quitar adb y antes de que el dispositivo vuelva a estar en línea.

void postBootSetup()

Sigue las instrucciones para configurar el dispositivo y probarlo después de cada inicio.

void postInvocationTearDown(Throwable exception)

Hay pasos adicionales para la limpieza específica del dispositivo que se requiere, que se ejecutará una vez que se complete la invocación.

void preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)

Pasos adicionales para la configuración requerida específica del dispositivo que se ejecutará en este antes del flujo de invocación.

boolean pullDir(String deviceFilePath, File localDir, int userId)

Extrae contenido del directorio del dispositivo de manera recurrente.

boolean pullDir(String deviceFilePath, File localDir)

Extrae contenido del directorio del dispositivo de manera recurrente.

boolean pullFile(String remoteFilePath, File localFile)

Recupera un archivo fuera del dispositivo.

File pullFile(String remoteFilePath, int userId)

Recupera un archivo fuera del dispositivo, lo almacena en un ERROR(/File) temporal local y muestra ese File.

File pullFile(String remoteFilePath)

Recupera un archivo fuera del dispositivo, lo almacena en un ERROR(/File) temporal local y muestra ese File.

boolean pullFile(String remoteFilePath, File localFile, int userId)

Recupera un archivo fuera del dispositivo.

String pullFileContents(String remoteFilePath)

Recupera un archivo fuera del dispositivo y muestra el contenido.

File pullFileFromExternal(String remoteFilePath)

Un método útil para recuperar un archivo del almacenamiento externo del dispositivo, almacenarlo en un ERROR(/File) local temporal y mostrar una referencia a ese File.

boolean pushDir(File localFileDir, String deviceFilePath, excludedDirectories)

Envía de manera recurrente el contenido del directorio al dispositivo y, al mismo tiempo, excluye algunos directorios filtrados.

boolean pushDir(File localFileDir, String deviceFilePath)

Envía de manera recurrente el contenido del directorio al dispositivo.

boolean pushDir(File localFileDir, String deviceFilePath, int userId)

Envía de manera recurrente el contenido del directorio al dispositivo.

boolean pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)

Es una variante de pushFile(File, String) que puede considerar de manera opcional evaluar la necesidad del proveedor de contenido.

boolean pushFile(File localFile, String remoteFilePath)

Envía un archivo al dispositivo.

boolean pushFile(File localFile, String remoteFilePath, int userId)

Envía un archivo al dispositivo.

boolean pushString(String contents, String remoteFilePath)

Envío de archivo creado a partir de una cadena al dispositivo

void reboot(String reason)

Reinicia el dispositivo en modo adb con el reason determinado para que persista durante el reinicio.

void reboot()

Reinicia el dispositivo en modo adb.

void rebootIntoBootloader()

Reinicia el dispositivo en el modo de bootloader.

void rebootIntoFastbootd()

Reinicia el dispositivo en el modo fastbootd.

void rebootIntoRecovery()

Reinicia el dispositivo en el modo de recuperación de adb.

void rebootIntoSideload()

Reinicia el dispositivo en el modo de transferencia de adb (ten en cuenta que se trata de un modo especial en recuperación).

Se bloquea hasta que el dispositivo entre en modo de transferencia

void rebootIntoSideload(boolean autoReboot)

Reinicia el dispositivo en el modo de transferencia de adb (ten en cuenta que se trata de un modo especial en recuperación).

Se bloquea hasta que el dispositivo entre en modo de transferencia

void rebootUntilOnline()

Una alternativa a reboot() que solo se bloquea hasta que el dispositivo esté en línea, es decir, visible para adb

void rebootUntilOnline(String reason)

Una alternativa a reboot() que solo se bloquea hasta que el dispositivo esté en línea, es decir, visible para adb

void rebootUserspace()

Reinicia solo una parte del espacio del usuario del dispositivo.

void rebootUserspaceUntilOnline()

Es una alternativa a rebootUserspace() ()} que solo se bloquea hasta que el dispositivo esté en línea, es decir, visible para adb.

boolean recoverDevice()

Intenta recuperar la comunicación con el dispositivo.

void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver para este dispositivo.

void remountSystemReadOnly()

Haz que la partición del sistema en el dispositivo sea de solo lectura.

void remountSystemWritable()

Permite que se pueda escribir en la partición del sistema del dispositivo.

void remountVendorReadOnly()

Haz que la partición del proveedor en el dispositivo sea de solo lectura.

void remountVendorWritable()

Permitir que se pueda escribir en la partición del proveedor en el dispositivo.

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 existentes de perfiles de dispositivo con todo lo que puedas.

boolean removeUser(int userId)

Quitar a un usuario determinado del dispositivo

void resetContentProviderSetup()

Restablece la marca de la configuración del proveedor de contenido para volver a activarla.

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)

Método de conveniencia para realizar ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) con uno o más objetos de escucha pasados como parámetros.

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

Ejecuta pruebas de instrumentación y proporciona recuperación de dispositivos.

boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)

Es igual que ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), pero ejecuta la prueba para el usuario determinado.

boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)

Es igual que ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), pero ejecuta la prueba para un usuario determinado.

void setConfiguration(IConfiguration configuration)

Inserta el IConfiguration en uso.

final void setConnectionAvdInfo(GceAvdInfo avdInfo)
void setDate(Date date)

Establece la fecha en el dispositivo

Nota: La configuración de la fecha en el dispositivo requiere permisos de administrador

boolean setDeviceOwner(String componentName, int userId)

Establece un componente de administración de dispositivos como propietario para un usuario determinado.

void setDeviceState(TestDeviceState deviceState)

Actualiza el estado del dispositivo.

void setEmulatorOutputStream(SizeLimitedOutputStream output)

Para el emulador, configura SizeLimitedOutputStream para registrar resultados

void setEmulatorProcess(Process p)

Establece Process, cuando este dispositivo es un emulador.

void setFastbootEnabled(boolean fastbootEnabled)

Configura la opción fastboot para el dispositivo.

void setFastbootPath(String fastbootPath)

Establece la ruta de acceso al objeto binario de fastboot que se debe usar.

void setIDevice(IDevice newDevice)

Actualiza el IDevice asociado con este ITestDevice.

void setLogStartDelay(int delay)

Establece el tiempo en ms que se debe esperar antes de iniciar la captura de logcat para un dispositivo en línea.

void setOptions(TestDeviceOptions options)

Establece el TestDeviceOptions para el dispositivo.

boolean setProperty(String propKey, String propValue)

Establece el valor de la propiedad determinada en el dispositivo.

void setRecovery(IDeviceRecovery recovery)

Configura el parámetro IDeviceRecovery que se usará en este dispositivo.

void setRecoveryMode(ITestDevice.RecoveryMode mode)

Configura el modo de recuperación que se usará en el dispositivo.

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 setTestLogger(ITestLogger testLogger)

Inserta la instancia ITestLogger.

void setUseFastbootErase(boolean useFastbootErase)

Configura si quieres usar el formato de fastboot o borrado de fastboot para limpiar una partición del dispositivo.

void startLogcat()

Comienza a capturar resultados de logcat del dispositivo en segundo plano.

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, le permite al usuario iniciar actividades en esa pantalla).

void stopEmulatorOutput()

Cierra y borra el resultado del emulador.

void stopLogcat()

Detén la captura de resultados de logcat del dispositivo y descarta los datos de logcat guardados actualmente.

boolean stopUser(int userId)

Detiene a un usuario determinado.

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

Detener un usuario determinado

String switchToAdbTcp()

Cambia el dispositivo al modo adb-over-tcp.

boolean switchToAdbUsb()

Cambia el dispositivo al modo adb mediante USB.

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.

boolean syncFiles(File localFileDir, String deviceFilePath)

Sincroniza de forma incremental el contenido de un directorio de archivos local con el dispositivo.

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.

boolean unlockDevice()

Desbloquea el dispositivo si está encriptado.

void unmountDebugfs()

Desactiva Debugfs.

boolean waitForBootComplete(long timeOut)

Se bloquea hasta que se establezca la marca de inicio completado del dispositivo.

boolean waitForDeviceAvailable()

Espera a que el dispositivo responda y esté disponible para las pruebas.

boolean waitForDeviceAvailable(long waitTime)

Espera a que el dispositivo responda y esté disponible para las pruebas.

boolean waitForDeviceAvailableInRecoverPath(long waitTime)

Espera a que el dispositivo responda y esté disponible sin considerar la ruta de recuperación.

void waitForDeviceBootloader()

Se bloquea hasta que el dispositivo sea visible mediante fastboot.

boolean waitForDeviceInRecovery(long waitTime)

Bloquea el dispositivo en el estado de "recuperación de adb" (ten en cuenta que es distinto de IDeviceRecovery).

boolean waitForDeviceInSideload(long waitTime)

Bloqueos para que el dispositivo tenga el estado "transferencia de adb"

boolean waitForDeviceNotAvailable(long waitTime)

Bloqueos para que el dispositivo no esté disponible, es decir, falta en adb

void waitForDeviceOnline()

Se bloquea hasta que el dispositivo sea visible mediante adb.

void waitForDeviceOnline(long waitTime)

Se bloquea hasta que el dispositivo sea visible mediante adb.

boolean waitForDeviceShell(long waitTime)

Espera a que el dispositivo responda a un comando shell adb básico.

Métodos protegidos

void addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
String[] buildAdbShellCommand(String command, boolean forceExitStatusDetection)

Compila el comando de SO para la sesión y los argumentos del comando de shell adb determinados.

void checkApiLevelAgainst(String feature, int strictMinLevel)
NativeDevice.RebootDeviceAction createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)

Crea un RebootDeviceAction para usar cuando se realice una acción de reinicio.

IRunUtil createRunUtil()
void doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)

Ejecuta un reinicio de adb.

void ensureRuntimePermissionSupported()

un método auxiliar para arrojar una excepción si no se admite el permiso de tiempo de ejecución

int getApiLevelSafe()
ITestLogger getLogger()
IRunUtil getRunUtil()

Obtén la instancia de RunUtil que se usará.

void initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
String internalGetProperty(String propName, String fastbootVar, String description)

Obtén una propiedad de dispositivo, de la caché de ddmlib de forma predeterminada, y recurre a `adb shell getprop` o `fastboot getvar` según si el dispositivo está en Fastboot o no.

boolean isInRebootCallback()

Muestra si las devoluciones de llamada de reinicio se están ejecutando actualmente o no.

boolean isNewer(File localFile, IFileEntry entry)

Muestra true si el archivo local es más reciente que el archivo remoto.

void notifyRebootEnded()

Notifica a todos los IDeviceActionReceiver sobre el evento de finalización de reinicio.

void notifyRebootStarted()

Notifica a todos los IDeviceActionReceiver sobre el evento de inicio de reinicio.

boolean performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)

Realiza una acción en este dispositivo.

void postAdbReboot()

Posibles acciones adicionales que se pueden realizar después de reiniciar el dispositivo.

void prePostBootSetup()

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

boolean pullFileInternal(String remoteFilePath, File localFile)
void setClock(Clock clock)

Configura la instancia de reloj que se usará.

void setMicrodroidProcess(Process process)

Marca el TestDevice como microdroid y establece su CID.

void setTestDeviceOptions( deviceOptions)
CommandResult simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)

Ejecuta un comando fastboot simple con variables de entorno y, además, informa el estado del comando.

CommandResult simpleFastbootCommand(long timeout, String[] fullCmd)

Ejecuta un comando fastboot simple y, luego, informa el estado del comando.

boolean waitForDeviceNotAvailable(String operationDesc, long time)

Espera a que el dispositivo deje de estar disponible (deja de informar a adb).

Constantes

ID DE USUARIO NO VÁLIDO

public static final int INVALID_USER_ID

Valor que se muestra para cualquier ID de usuario no válido o no encontrado: UserHandle definió el valor -10000

Valor constante: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Valor constante: 5,000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

la cantidad predeterminada de reintentos de comando para realizar

Valor constante: 2 (0x00000002)

Campos

RUTA_DE_BUGFS

public static final String DEBUGFS_PATH

TARJETA_SD

protected static final String SD_CARD

ALMACENAMIENTO_EMULADO

protected static final String STORAGE_EMULATED

Opciones de dispositivos móviles

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Constructores públicos

Dispositivo nativo

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

Crea un TestDevice.

Parámetros
device IDevice: Es el IDevice asociado.

stateMonitor IDeviceStateMonitor: Es el mecanismo IDeviceStateMonitor para usar.

allocationMonitor IDeviceMonitor: Es el IDeviceMonitor que se informará sobre los cambios de estado de la asignación. Puede ser nulo

Métodos públicos

batchPrefetchStartupBuildProps.

public void batchPrefetchStartupBuildProps ()

Microoptimización (alrededor de 400 milis) mediante la carga previa de todas las props que necesitamos, en lugar de llamar a "adb getprop" para cada una; es decir, obtener todas las propiedades es tan rápido como recuperar una. Algunos elementos, como device.getApiLevel(), checkApiLevelAgainstNextRelease y getBuildAlias, llaman a "adb getprop" de forma interna. Los recuperamos en una llamada y llamamos a NativeDevice.setProperty. Incluso si no hacemos esto, NativeDevice llamará a setProperty y almacenará en caché el resultado para llamadas futuras. Lo estamos haciendo un poco antes. Si el dispositivo está en recuperación o hay otros errores al obtener los objetos, simplemente se ignoran.

Cambiar a usuario del sistema sin cabeza

public boolean canSwitchToHeadlessSystemUser ()

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

Devuelve
boolean

Arroja
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Comprobar si una función es compatible actualmente con un nivel mínimamente admitido Este método tiene en cuenta las funciones no publicadas aún, antes de que se suba el nivel de API.

Parámetros
strictMinLevel int: Es el nivel mínimo posible estricto que admite la función.

Devuelve
boolean Es verdadero si el nivel es compatible. De lo contrario, el valor es falso.

Arroja
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity ()

Verifica que el dispositivo tenga conectividad de red.

Devuelve
boolean true si el dispositivo tiene una conexión de red en funcionamiento, false en exceso.

Arroja
DeviceNotAvailableException

deleteErrorDialogs

public boolean clearErrorDialogs ()

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

Devuelve
boolean true si no hay diálogos presentes o estos se borraron correctamente. De lo contrario, false.

Arroja
DeviceNotAvailableException

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Borra la última red Wi-Fi conectada. Se debe llamar a este método cuando se inicia una nueva invocación para evitar la conexión a la red Wi-Fi que se usó en la prueba anterior después de reiniciar el dispositivo.

deleteLogcat

public void clearLogcat ()

Borra todos los datos acumulados de logcat.

Esto es útil para casos en los que deseas asegurarte de que ITestDevice#getLogcat() solo muestre datos de registro producidos después de un momento determinado (por ejemplo, después de escribir en la memoria flash una nueva compilación de un dispositivo, etcétera).

conectarAlaredWi-Fi

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se conecta a una red Wi-Fi.

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

Parámetros
wifiSsidToPsk : Un mapa de los SSID de Wi-Fi a las contraseñas.

scanSsid boolean: Indica si se deben buscar SSID ocultos de esta red.

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

Arroja
DeviceNotAvailableException

conectarAlaredWi-Fi

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se conecta a una red Wi-Fi.

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

Parámetros
wifiSsid String: El cable de Wi-Fi al que se debe conectar

wifiPsk String: Frase de contraseña de PSK o nula si no está encriptada

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

Arroja
DeviceNotAvailableException

conectarAlaredWi-Fi

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Se conecta a una red Wi-Fi.

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

Parámetros
wifiSsidToPsk : Un mapa de los SSID de Wi-Fi a las contraseñas.

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

Arroja
DeviceNotAvailableException

conectarAlaredWi-Fi

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

Se conecta a una red Wi-Fi.

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

Parámetros
wifiSsid String: El cable de Wi-Fi al que se debe conectar

wifiPsk String: Frase de contraseña de PSK o nula si no está encriptada

scanSsid boolean: Indica si se debe buscar un SSID oculto de esta red.

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

Arroja
DeviceNotAvailableException

ConectarConWi-FiNetworkSi Es necesario

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

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

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

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

Arroja
DeviceNotAvailableException

ConectarConWi-FiNetworkSi Es necesario

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

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

Devuelve
int ID del 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

Devuelve
int ID del usuario creado

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

Devuelve
int el número entero para el ID de 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

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

Arroja
DeviceNotAvailableException

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

Es un método de ayuda para borrar un archivo o directorio del dispositivo.

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

userId int: Es el ID de usuario del que se borrará.

Arroja
DeviceNotAvailableException

deleteFile

public void deleteFile (String deviceFilePath)

Es un método de ayuda para borrar un archivo o directorio del dispositivo.

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

Arroja
DeviceNotAvailableException

anular el registro deDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Quita el IDeviceActionReceiver registrado.

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

Reinicio en segundo plano del dispositivo

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Método de ayuda para verificar si el dispositivo se reinició de forma no definitiva comparando el system_server actual con el ProcessInfo anterior de system_server. Usa getProcessByName(String) para obtener ProcessInfo.

Parámetros
prevSystemServerProcess ProcessInfo: Es el proceso anterior de system_server ProcessInfo.

Devuelve
boolean true si se reinició de forma no definitiva el dispositivo

Arroja
DeviceNotAvailableException

Reinicio no definitiva desde el dispositivo

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Método de ayuda para verificar si el dispositivo se reinició de forma no definitiva desde la hora UTC desde la época del dispositivo y su ERROR(/TimeUnit). El reinicio en segundo plano hace referencia al reinicio de system_server fuera del reinicio forzado de un dispositivo (por ejemplo: reinicio solicitado). El utcEpochTime del dispositivo actual en Milliseccond se puede obtener mediante el método getDeviceDate().

Parámetros
utcEpochTime long: Es la hora del dispositivo en segundos desde el ciclo de entrenamiento.

timeUnit TimeUnit: Es la unidad de tiempo TimeUnit para el utcEpochTime determinado.

Devuelve
boolean true si se reinició de forma no definitiva el dispositivo

Arroja
DeviceNotAvailableException

inhabilitarAdbRoot

public boolean disableAdbRoot ()

Desactiva la raíz de adb.

Si inhabilitas la raíz de adb, es posible que el dispositivo se desconecte de adb. Este método se bloqueará hasta que el dispositivo esté disponible.

Devuelve
boolean true si se realiza correctamente.

Arroja
DeviceNotAvailableException

deshabilitar bloqueo de teclado

public void disableKeyguard ()

Intenta inhabilitar el bloqueo del teclado.

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

Arroja
DeviceNotAvailableException

inhabilitarNetworkMonitor

public boolean disableNetworkMonitor ()

Inhabilita la supervisión de red en el dispositivo.

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

Arroja
DeviceNotAvailableException

desconectardeWi-Fi

public boolean disconnectFromWifi ()

Se desconecta de una red Wi-Fi.

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

Devuelve
boolean true si se desconectó correctamente de la red Wi-Fi. false si falló la desconexión.

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.

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

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.

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

Devuelve
File el objeto ERROR(/File) que contiene el informe. Nulo si algo falló.

Arroja
DeviceNotAvailableException

enableAdbRoot

public boolean enableAdbRoot ()

Activa la raíz de adb. Si la configuración “enable-root” es “false”, registrará un mensaje y se mostrará sin habilitar la raíz.

Si habilitas la raíz de adb, es posible que el dispositivo se desconecte de adb. Este método se bloqueará hasta que el dispositivo esté disponible.

Devuelve
boolean true si se realiza correctamente.

Arroja
DeviceNotAvailableException

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Habilita la supervisión de red en el dispositivo.

Devuelve
boolean Es true si la supervisión se habilitó correctamente. false si falló.

Arroja
DeviceNotAvailableException

EjecutarAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

Es un método de ayuda que ejecuta un comando adb como un comando del sistema con un tiempo de espera especificado.

En su lugar, se debe usar executeShellCommand(String) siempre que sea posible, ya que ese método proporciona una mejor detección de fallas y un mejor rendimiento.

Parámetros
timeout long: Es el tiempo en milisegundos antes de que el dispositivo se considere que no responde, 0L para sin tiempo de espera.

cmdArgs String: Es el comando adb y los argumentos para ejecutar.

Devuelve
String el stdout desde el comando. null si no se pudo ejecutar el comando.

Arroja
DeviceNotAvailableException

EjecutarAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

Es un método de ayuda que ejecuta un comando adb como un comando del sistema con un tiempo de espera especificado.

En su lugar, se debe usar executeShellCommand(String) siempre que sea posible, ya que ese método proporciona una mejor detección de fallas y un mejor rendimiento.

Parámetros
timeout long: Es el tiempo en milisegundos antes de que el dispositivo se considere que no responde, 0L para sin tiempo de espera.

envMap : Es el entorno que se configurará para el comando.

cmdArgs String: Es el comando adb y los argumentos para ejecutar.

Devuelve
String el stdout desde el comando. null si no se pudo ejecutar el comando.

Arroja
DeviceNotAvailableException

EjecutarAdbCommand

public String executeAdbCommand (String... cmdArgs)

Es un método de ayuda que ejecuta un comando adb como un comando del sistema.

En su lugar, se debe usar executeShellCommand(String) siempre que sea posible, ya que ese método proporciona una mejor detección de fallas y un mejor rendimiento.

Parámetros
cmdArgs String: Es el comando adb y los argumentos para ejecutar.

Devuelve
String el stdout desde el comando. null si no se pudo ejecutar el comando.

Arroja
DeviceNotAvailableException

EjecutarFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

Método auxiliar que ejecuta un comando fastboot como un comando del sistema con un tiempo de espera predeterminado de 2 minutos.

Se debe usar cuando el dispositivo ya está en Modo fastboot [Fastboot mode].

Parámetros
cmdArgs String: Es el comando fastboot y los argumentos para ejecutar.

Devuelve
CommandResult el CommandResult, que contiene la salida del comando

Arroja
DeviceNotAvailableException

EjecutarFastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

Es un método de ayuda que ejecuta un comando fastboot como un comando del sistema.

Se debe usar cuando el dispositivo ya está en Modo fastboot [Fastboot mode].

Parámetros
timeout long: Es el tiempo en milisegundos antes de que venza el comando

cmdArgs String: Es el comando fastboot y los argumentos para ejecutar.

Devuelve
CommandResult el CommandResult, que contiene la salida del comando

Arroja
DeviceNotAvailableException

ejecutarLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

Es un método de ayuda que ejecuta un comando fastboot de larga duración como un comando del sistema.

Idéntico a executeFastbootCommand(String), excepto que usa un tiempo de espera más largo.

Parámetros
cmdArgs String: Es el comando fastboot y los argumentos para ejecutar.

Devuelve
CommandResult el CommandResult, que contiene la salida del comando

Arroja
DeviceNotAvailableException

ejecutarLongFastbootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

Método auxiliar que ejecuta un comando fastboot de larga duración como un comando del sistema con variables de entorno del sistema.

Idéntico a executeFastbootCommand(String), excepto que usa un tiempo de espera más largo.

Parámetros
envVarMap : Son las variables de entorno del sistema con las que se ejecuta el comando fastboot.

cmdArgs String: Es el comando fastboot y los argumentos para ejecutar.

Devuelve
CommandResult el CommandResult, que contiene la salida del comando

Arroja
DeviceNotAvailableException

Comando runShell

public String executeShellCommand (String command)

Es un método de ayuda que ejecuta un comando shell de adb y muestra el resultado como String.

Parámetros
command String: Es el comando shell de adb que se ejecutará.

Devuelve
String el resultado del shell

Arroja
DeviceNotAvailableException

Comando runShell

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.

Parámetros
command String: Es el comando shell de adb que se ejecutará.

receiver IShellOutputReceiver: Es el IShellOutputReceiver al que se dirigirá el resultado de la shell.

maxTimeToOutputShellResponse long: Es la cantidad máxima de tiempo durante la cual el comando no puede generar ninguna respuesta; unidad como se especifica en timeUnit.

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se puede reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponseException si retryAttempts se ejecuta sin éxito.

Arroja
DeviceNotAvailableException

Comando runShell

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.

Parámetros
command String: Es el comando shell de adb que se ejecutará.

receiver IShellOutputReceiver: Es el IShellOutputReceiver al que se dirigirá el resultado de la shell.

maxTimeoutForCommand long: Es el tiempo de espera máximo para que se complete el comando; unidad como se especifica en timeUnit.

maxTimeToOutputShellResponse long: Es la cantidad máxima de tiempo durante la cual el comando no puede generar ninguna respuesta; unidad como se especifica en timeUnit.

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se puede reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponseException si retryAttempts se ejecuta sin éxito.

Arroja
DeviceNotAvailableException

Comando runShell

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Ejecuta el comando shell de adb determinado y vuelve a intentarlo varias veces si el comando falla.

Una forma más simple de executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) con valores predeterminados.

Parámetros
command String: Es el comando shell de adb que se ejecutará.

receiver IShellOutputReceiver: Es el IShellOutputReceiver al que se dirigirá el resultado de la shell.

Arroja
DeviceNotAvailableException

Comando runShellV2

public CommandResult executeShellV2Command (String cmd)

Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como una CommandResult propagada correctamente con el resultado del estado del comando, stdout y stderr.

Parámetros
cmd String: Es el comando que se debe ejecutar.

Devuelve
CommandResult El resultado en CommandResult.

Arroja
DeviceNotAvailableException

Comando runShellV2

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Es un método auxiliar que ejecuta un comando shell de adb y muestra los resultados como un CommandResult propagado correctamente con el resultado del estado del comando y stderr. stdout se dirige a la transmisión especificada.

Parámetros
cmd String: Es el comando que se debe ejecutar.

pipeToOutput OutputStream: ERROR(/OutputStream) donde se redireccionará el resultado estándar, o nulo

Devuelve
CommandResult El resultado en CommandResult.

Arroja
DeviceNotAvailableException

Comando runShellV2

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como un CommandResult propagado correctamente con el resultado del estado del comando, stdout y stderr.

Parámetros
cmd String: Es el comando que se debe ejecutar.

pipeAsInput File: Es una ERROR(/File) que se canalizará como entrada para el comando o un valor nulo.

Devuelve
CommandResult El resultado en CommandResult.

Arroja
DeviceNotAvailableException

Comando runShellV2

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.

Parámetros
cmd String: Es el comando shell de adb que se ejecutará.

maxTimeoutForCommand long: Es el tiempo de espera máximo para que se complete el comando; unidad como se especifica en timeUnit.

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se puede reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponseException si retryAttempts se ejecuta sin éxito.

Devuelve
CommandResult

Arroja
DeviceNotAvailableException

Comando runShellV2

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.

Parámetros
cmd String: Es el comando shell de adb que se ejecutará.

maxTimeoutForCommand long: Es el tiempo de espera máximo para que se complete el comando; unidad como se especifica en timeUnit.

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

Devuelve
CommandResult

Arroja
DeviceNotAvailableException

Comando runShellV2

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.

Parámetros
cmd String: Es el comando shell de adb que se ejecutará.

pipeAsInput File: Es una ERROR(/File) que se canalizará como entrada para el comando o un valor nulo.

pipeToOutput OutputStream: ERROR(/OutputStream) donde se redireccionará el resultado estándar, o nulo

maxTimeoutForCommand long: Es el tiempo de espera máximo para que se complete el comando; unidad como se especifica en timeUnit.

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se puede reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponseException si retryAttempts se ejecuta sin éxito.

Devuelve
CommandResult

Arroja
DeviceNotAvailableException

Comando runShellV2

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.

Parámetros
cmd String: Es el comando shell de adb que se ejecutará.

pipeAsInput File: Es una ERROR(/File) que se canalizará como entrada para el comando o un valor nulo.

pipeToOutput OutputStream: ERROR(/OutputStream) donde se redireccionará el resultado estándar, o nulo

pipeToError OutputStream: ERROR(/OutputStream) donde se redireccionará el error estándar, o nulo.

maxTimeoutForCommand long: Es el tiempo de espera máximo para que se complete el comando; unidad como se especifica en timeUnit.

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se puede reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponseException si retryAttempts se ejecuta sin éxito.

Devuelve
CommandResult

Arroja
DeviceNotAvailableException

fastbootWipePartition.

public CommandResult fastbootWipePartition (String partition)

Es un método de ayuda que borra una partición del dispositivo.

Si getUseFastbootErase() es true, se usará el borrado de fastboot para limpiar la partición. El dispositivo debe crear un sistema de archivos la próxima vez que se inicie. De lo contrario, se usa el formato fastboot, que creará un nuevo sistema de archivos en el dispositivo.

Se debe usar cuando el dispositivo ya está en Modo fastboot [Fastboot mode].

Parámetros
partition String: Es la partición que se borrará.

Devuelve
CommandResult el CommandResult, que contiene la salida del comando

Arroja
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

Devuelve
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"}

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

Arroja
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

Devuelve el estado de asignación actual del dispositivo

Devuelve
DeviceAllocationState

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

Devuelve
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 ID de usuario encuentre un ID de Android asociado en esta función, por lo que algunos ID de usuario pueden coincidir con el valor nulo.

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

Arroja
DeviceNotAvailableException

getApiLevel.

public int getApiLevel ()

Obtén el nivel de API del dispositivo. La configuración predeterminada es UNKNOWN_API_LEVEL.

Devuelve
int un número entero que indica el nivel de API del dispositivo

Arroja
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

Parámetros
packageName String

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

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

Arroja
DeviceNotAvailableException

getBasebandVersion

public String getBasebandVersion ()

Método de conveniencia para obtener la versión de banda base (radio) de este dispositivo. La obtención de la versión de radio es específica del dispositivo, por lo que es posible que no muestre la información correcta de todos los dispositivos. Este método se basa en la propiedad gsm.version.baseband para mostrar la información de la versión correcta. Esto no es correcto para algunos dispositivos CDMA, y es posible que la versión que se muestra aquí no coincida con la versión informada desde fastboot y que no muestre la versión de la radio CDMA. TL;DR este método solo informa la versión precisa si la propiedad gsm.version.baseband es la misma que la versión que muestra fastboot getvar version-baseband.

Devuelve
String la versión de banda base String o null si no se puede determinar (el dispositivo no tiene radio o no se puede leer una cadena de versión)

Arroja
DeviceNotAvailableException

getBatería

public Integer getBattery ()

Muestra el nivel de batería actual de un dispositivo o Valor Nulo si el nivel de batería no está disponible.

Devuelve
Integer

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Muestra el valor booleano de la propiedad especificada.

Parámetros
name String: Es el nombre de la propiedad.

defaultValue boolean: Es el valor predeterminado que se muestra si la propiedad está vacía o no existe.

Devuelve
boolean true si la propiedad tiene el valor "1", "y", "yes", "on" o "true", false si la propiedad tiene el valor "0", "n", "no", "off", "false" o, de lo contrario, defaultValue.

Arroja
DeviceNotAvailableException

getBootHistory

public  getBootHistory ()

El método auxiliar recopila el mapa del historial de inicio con el tiempo y el motivo de inicio.

Devuelve
Mapa de la hora de inicio (hora UTC en segundos desde la época) y el motivo del inicio

Arroja
DeviceNotAvailableException

getBootHistoryDesde

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

El método auxiliar recopila el mapa del historial de inicio con el tiempo de inicio y el motivo de inicio desde el tiempo determinado desde el ciclo de entrenamiento del dispositivo y la unidad de tiempo especificada. El utcEpochTime del dispositivo actual en milisegundos se puede obtener mediante el método getDeviceDate().

Parámetros
utcEpochTime long: Es el tiempo del dispositivo desde el ciclo de entrenamiento.

timeUnit TimeUnit: Es la unidad de tiempo TimeUnit.

Devuelve
Mapa de la hora de inicio (hora UTC en segundos desde la época) y el motivo del inicio

Arroja
DeviceNotAvailableException

getBootloaderVersion

public String getBootloaderVersion ()

Método de conveniencia para obtener la versión del bootloader de este dispositivo.

Se intentará recuperar la versión del bootloader del estado actual del dispositivo. (es decir, si el dispositivo está en Modo fastboot [Fastboot mode], intentará recuperar la versión de fastboot).

Devuelve
String la versión del bootloader String o null si no se encuentra

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 una sdcard (o en el que la sdcard aún no esté montada).

Devuelve
InputStreamSource Un InputStreamSource que producirá el contenido del informe de errores a pedido. En caso de que se produzca una 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.

Devuelve
InputStreamSource un InputStreamSource del archivo ZIP que contiene bugreportz; se muestra un valor nulo en caso de falla.

getBuildAlias

public String getBuildAlias ()

Recupera el alias de la compilación que el dispositivo está ejecutando actualmente.

El alias de compilación suele ser una string más legible que el ID de compilación (generalmente, un número para las compilaciones de Nexus). Por ejemplo, la versión final de Android 4.2 tiene el alias de compilación JDQ39 y el ID de compilación 573038.

Devuelve
String el alias de compilación o recurrir al ID de compilación si no se pudo recuperar

Arroja
DeviceNotAvailableException

getBuildFlavor.

public String getBuildFlavor ()

Recupera la variante de compilación para el dispositivo.

Devuelve
String la variante de compilación o un valor nulo si no se pudo recuperar

Arroja
DeviceNotAvailableException

getBuildId

public String getBuildId ()

Recupera la compilación que el dispositivo está ejecutando actualmente.

Devuelve
String el ID de compilación o IBuildInfo#UNKNOWN_BUILD_ID si no se pudo recuperar

Arroja
DeviceNotAvailableException

getBuildSigningKeys.

public String getBuildSigningKeys ()

Devuelve el tipo de clave usado para firmar la imagen del dispositivo

Por lo general, los dispositivos Android pueden firmarse con claves de prueba (como en AOSP) o claves de lanzamiento (controladas por fabricantes de dispositivos individuales).

Devuelve
String La clave de firma si se encuentra; de lo contrario, es nulo.

Arroja
DeviceNotAvailableException

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

Muestra un DeviceDescriptor almacenado en caché si el dispositivo está asignado; de lo contrario, muestra el DeviceDescriptor actual.

Devuelve
DeviceDescriptor

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Muestra un DeviceDescriptor almacenado en caché si el dispositivo está asignado; de lo contrario, muestra el DeviceDescriptor actual.

Parámetros
shortDescriptor boolean: Indica si se debe limitar o no el descriptor a la información mínima.

Devuelve
DeviceDescriptor

getChildren

public String[] getChildren (String path)

Es una alternativa al uso de IFileEntry, que a veces no funciona debido a los permisos.

Parámetros
path String: Es la ruta de acceso en el dispositivo en la que se realizará la búsqueda.

Devuelve
String[] Array de cadena que contiene todo el archivo de una ruta de acceso en el dispositivo.

Arroja
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

La conexión actual asociada con el dispositivo.

Devuelve
AbstractConnection

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

Muestra ContentProviderHandler o un valor nulo si no está disponible.

Se puede volver a usar el proveedor de contenido si se creó antes con el mismo userId.

Parámetros
userId int: Es el ID de usuario con el que se inicializará el proveedor de contenido.

Devuelve
ContentProviderHandler

Arroja
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

Devuelve
DeviceFoldableState

Arroja
DeviceNotAvailableException

getCurrentUser.

public int getCurrentUser ()

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

Devuelve
int

Arroja
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

Obtén la clase de dispositivo.

Devuelve
String la clase de dispositivo String

getDeviceDate

public long getDeviceDate ()

Muestra la fecha del dispositivo en milisegundos desde el ciclo de entrenamiento.

Devuelve
long la fecha del dispositivo en formato epoch.

Arroja
DeviceNotAvailableException

getDeviceDescriptor.

public DeviceDescriptor getDeviceDescriptor ()

Muestra un DeviceDescriptor a partir de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo en sí.

Devuelve
DeviceDescriptor

getDeviceDescriptor.

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Muestra un DeviceDescriptor a partir de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo en sí.

Parámetros
shortDescriptor boolean: Indica si se debe limitar o no el descriptor a la información mínima.

Devuelve
DeviceDescriptor

getDeviceState

public TestDeviceState getDeviceState ()

Obtén el estado del dispositivo.

Devuelve
TestDeviceState

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Es una herramienta de ayuda para obtener la diferencia de hora entre el dispositivo y un ERROR(/Date) determinado. Usa el tiempo de época a nivel interno.

Parámetros
date Date

Devuelve
long la diferencia en milisegundos

Arroja
DeviceNotAvailableException

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Cómo obtener la transmisión de stdout y stderr del emulador

Devuelve
InputStreamSource salida del emulador

getEmulatorProcess

public Process getEmulatorProcess ()

Muestra el Process correspondiente a este emulador.

Devuelve
Process la Process o null

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

El registro que contiene todos los registros de executeShellCommand(String).

Devuelve
File

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

Es un método de ayuda para determinar la cantidad de espacio libre en el almacenamiento externo del dispositivo.

Devuelve
long la cantidad de espacio libre en KB

Arroja
DeviceNotAvailableException

getFastbootPath

public String getFastbootPath ()

Muestra la ruta de acceso del objeto binario de fastboot que se usa. Aún se requiere que isFastbootEnabled() sea verdadero para tener habilitadas las funciones de fastboot.

Devuelve
String

getFastbootProductType

public String getFastbootProductType ()

Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.

Este método solo debe usarse si el dispositivo debe estar en fastboot. En este caso, es un poco más segura que el método genérico getProductType(), ya que ITestDevice sabrá que debe recuperar el dispositivo en fastboot si este se encuentra en un estado incorrecto o no responde.

Devuelve
String el nombre del tipo de producto String o null si no se puede determinar

Arroja
DeviceNotAvailableException

getFastbootProductVariant

public String getFastbootProductVariant ()

Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.

Este método solo debe usarse si el dispositivo debe estar en fastboot. En este caso, es un poco más segura que el método genérico getProductType(), ya que ITestDevice sabrá que debe recuperar el dispositivo en fastboot si este se encuentra en un estado incorrecto o no responde.

Devuelve
String el nombre del tipo de producto String o null si no se puede determinar

Arroja
DeviceNotAvailableException

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Devuelve el número de serie del modo fastboot.

Devuelve
String

getFastbootVariable

public String getFastbootVariable (String variableName)

Recupera el valor de la variable de fastboot específico del dispositivo.

Parámetros
variableName String: Es el nombre de la variable.

Devuelve
String el valor de la propiedad o null si no existe

Arroja
DeviceNotAvailableException

getFastbootVersion

public String getFastbootVersion ()

Muestra la cadena de versión del objeto binario de fastboot que se usa. O nulo si algo sale mal.

Devuelve
String

getFileEntry

public IFileEntry getFileEntry (String path)

Recupera una referencia a un archivo remoto en el dispositivo.

Parámetros
path String: Es la ruta del archivo que se recuperará. Puede ser una ruta de acceso absoluta o una ruta de acceso relativa a "/" (es decir, se admite tanto la sintaxis "/system" como "system")

Devuelve
IFileEntry IFileEntry o null si no se puede encontrar el archivo en el path especificado.

Arroja
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Es un asistente no oficial para obtener un FileEntry de una ruta no raíz. FIXME: Refactoriza el sistema FileEntry para que esté disponible desde cualquier ruta. (incluso los que no son raíz).

Parámetros
entry FileListingService.FileEntry: Es un FileEntry que no necesariamente tiene permisos de administrador como lo requiere Ddmlib.

Devuelve
IFileEntry Un FileEntryWrapper que representa a FileEntry

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

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

Devuelve

Arroja
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

Muestra una referencia al IDevice de ddmlib asociado.

DDMS puede asignar un nuevo IDevice cada vez que el dispositivo se desconecta y se vuelve a conectar de adb. Por lo tanto, los llamadores no deben mantener una referencia a IDevice, ya que esa referencia puede quedar inactiva.

Devuelve
IDevice IDevice

getInstallPackageNames

public  getInstalledPackageNames ()

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

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

Arroja
DeviceNotAvailableException

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

Muestra el valor entero de la propiedad determinada del dispositivo.

Parámetros
name String: Es el nombre de la propiedad.

defaultValue long: Es el valor predeterminado que se muestra si la propiedad está vacía o no existe.

Devuelve
long el valor de la propiedad o defaultValue si la propiedad está vacía, no existe o no tiene un valor de número entero

Arroja
DeviceNotAvailableException

getIpAddress

public String getIpAddress ()

Obtiene la dirección IP del dispositivo.

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

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.

Devuelve
KeyguardControllerState un objeto KeyguardControllerState que contiene una instantánea del estado del bloqueo de teclado y muestra el valor Null si no se admite la consulta de protección de teclado.

Arroja
DeviceNotAvailableException

getLastExpectedRestartTimeMillis

public long getLastExpectedRebootTimeMillis ()

Muestra la última vez que las APIs de Tradefed activaron un reinicio en milisegundos desde EPOCH, como lo muestra System.currentTimeMillis().

Devuelve
long

getLaunchApiLevel

public int getLaunchApiLevel ()

Obtener el primer nivel de API iniciado en el dispositivo La configuración predeterminada es UNKNOWN_API_LEVEL.

Devuelve
int un número entero que indica el primer nivel de API del dispositivo que se inició

Arroja
DeviceNotAvailableException

getLogcat.

public InputStreamSource getLogcat ()

Captura una transmisión de instantáneas de los datos de Logcat.

Funciona en dos modos:

  • Si el logcat se está capturando en segundo plano, mostrará hasta TestDeviceOptions.getMaxLogcatDataSize() bytes del contenido actual de la captura de logcat en segundo plano.
  • De lo contrario, se mostrará un volcado estático de los datos de logcat si el dispositivo está respondiendo.

    Devuelve
    InputStreamSource

  • getLogcat.

    public InputStreamSource getLogcat (int maxBytes)

    Captura una transmisión de instantáneas del último maxBytes de los datos de logcat capturados.

    Es útil para los casos en los que deseas capturar instantáneas frecuentes de los datos de logcat capturados sin incurrir en la penalidad de espacio en el disco potencialmente grande de obtener la instantánea getLogcat() completa.

    Parámetros
    maxBytes int: Es la cantidad máxima de datos que se mostrarán. Debe ser una cantidad que pueda caber cómodamente en la memoria

    Devuelve
    InputStreamSource

    getLogcatDump.

    public InputStreamSource getLogcatDump ()

    Obtén un volcado del logcat actual del dispositivo. A diferencia de getLogcat(), este método siempre mostrará un volcado estático del logcat.

    Tiene la desventaja de que no se devolverá nada si no se puede acceder al dispositivo.

    Devuelve
    InputStreamSource un InputStreamSource de los datos de logcat Se muestra una transmisión vacía si no se capturan los datos de logcat.

    getLogcatdesde.

    public InputStreamSource getLogcatSince (long date)

    Captura una transmisión de instantáneas de los datos capturados de logcat a partir de la fecha proporcionada. La hora en el dispositivo debe usarse como getDeviceDate().

    Parámetros
    date long: Indica en milisegundos desde el formato epoch en el que se inicia la instantánea hasta el presente. (puede obtenerse usando 'fecha +%s')

    Devuelve
    InputStreamSource

    getMacAddress

    public String getMacAddress ()

    Muestra la dirección MAC del dispositivo, que será nula si no se puede consultar desde el dispositivo.

    Devuelve
    String

    getMainUserId

    public Integer getMainUserId ()

    Muestra el ID de usuario principal.

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

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

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

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

    Arroja
    DeviceNotAvailableException

    getMicrodroidProcess.

    public Process getMicrodroidProcess ()

    Devuelve
    Process Muestra el proceso de la VM de Microdroid. Si TestDevice no es un Microdroid, muestra un valor nulo.

    getMonitor.

    public IDeviceStateMonitor getMonitor ()

    Devuelve el IDeviceStateMonitor asociado con el dispositivo.

    Devuelve
    IDeviceStateMonitor

    getMountPoint

    public String getMountPoint (String mountName)

    Muestra un punto de activación.

    Consulta al dispositivo directamente si la información almacenada en caché en IDevice no está disponible.

    PENDIENTE: Trasladar este comportamiento a IDevice#getMountPoint(String)

    Parámetros
    mountName String: Es el nombre del punto de activación.

    Devuelve
    String el punto de activación o null

    getMountPointInfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Muestra un MountPointInfo que corresponde a la ruta de acceso del punto de activación especificado, o null si esa ruta no tiene nada activado o no aparece en /proc/mounts como punto de activación.

    Parámetros
    mountpoint String

    Devuelve
    ITestDevice.MountPointInfo Un ERROR(/List) de MountPointInfo que contenga la información en "/proc/mounts"

    Arroja
    DeviceNotAvailableException

    getMountPointInfo

    public  getMountPointInfo ()

    Devuelve una versión analizada de la información en /proc/mounts en el dispositivo.

    Devuelve
    Un ERROR(/List) de MountPointInfo que contenga la información en "/proc/mounts"

    Arroja
    DeviceNotAvailableException

    getOptions

    public TestDeviceOptions getOptions ()

    Recupera las opciones de prueba para el dispositivo.

    Devuelve
    TestDeviceOptions TestDeviceOptions relacionado con el dispositivo de prueba.

    getPartitionFreeSpace

    public long getPartitionFreeSpace (String partition)

    Método de ayuda para determinar la cantidad de espacio libre en la partición del dispositivo.

    Parámetros
    partition String

    Devuelve
    long la cantidad de espacio libre en KB

    Arroja
    DeviceNotAvailableException

    ID de usuario principal de getPrimary

    public Integer getPrimaryUserId ()

    Muestra el ID de usuario principal.

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

    Arroja
    DeviceNotAvailableException

    getProcessByName

    public ProcessInfo getProcessByName (String processName)

    El método de ayuda ejecuta los comandos "pidof" y "stat", y muestra el objeto ProcessInfo con PID y la hora de inicio del proceso determinado.

    Parámetros
    processName String: Es la cadena del nombre del proceso.

    Devuelve
    ProcessInfo ProcessInfo de processName determinado

    Arroja
    DeviceNotAvailableException

    getProcessPid

    public String getProcessPid (String process)

    Muestra el pid del servicio o un valor nulo si se produjo un error.

    Parámetros
    process String: Es la cadena del nombre del proceso.

    Devuelve
    String

    Arroja
    DeviceNotAvailableException

    getProductType

    public String getProductType ()

    Método de conveniencia para obtener el tipo de producto de este dispositivo.

    Este método funcionará si el dispositivo está en modo adb o fastboot.

    Devuelve
    String el nombre del tipo de producto String No será nulo

    Arroja
    DeviceNotAvailableException

    getProductVariant

    public String getProductVariant ()

    Método de conveniencia para obtener la variante de producto de este dispositivo.

    Este método funcionará si el dispositivo está en modo adb o fastboot.

    Devuelve
    String el nombre de la variante del producto String o null si no se puede determinar

    Arroja
    DeviceNotAvailableException

    getProperty

    public String getProperty (String name)

    Recupera el valor de propiedad determinado del dispositivo.

    Parámetros
    name String: Es el nombre de la propiedad.

    Devuelve
    String el valor de la propiedad o null si no existe

    Arroja
    DeviceNotAvailableException

    getRecoveryMode.

    public ITestDevice.RecoveryMode getRecoveryMode ()

    Obtén el modo de recuperación que se usa actualmente para el dispositivo.

    Devuelve
    ITestDevice.RecoveryMode y el modo de recuperación que se usa actualmente para ese dispositivo.

    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

    Devuelve
    InputStreamSource una InputStreamSource de la captura de pantalla en formato, o null si 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 "reescalar"

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

    Devuelve
    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 (String format, 
                    boolean rescale)

    Toma una captura de pantalla del dispositivo. Se recomienda usar getScreenshot(String) 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.

    Devuelve
    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 ()

    Toma una captura de pantalla del dispositivo.

    Devuelve
    InputStreamSource un objeto InputStreamSource de la captura de pantalla en formato PNG, o bien un objeto null si no se realizó correctamente.

    Arroja
    DeviceNotAvailableException

    getSerialNumber

    public String getSerialNumber ()

    Método de conveniencia para obtener el número de serie de este dispositivo.

    Devuelve
    String el número de serie de String

    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

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

    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

    Devuelve
    String

    Arroja
    DeviceNotAvailableException

    getSimOperator

    public String getSimOperator ()

    Muestra el operador de la tarjeta SIM o un valor nulo si no está disponible o si el dispositivo no está disponible.

    Devuelve
    String

    getSimState

    public String getSimState ()

    Devuelve el estado de la tarjeta SIM o muestra un valor nulo si no está disponible o el dispositivo no está disponible.

    Devuelve
    String

    getTombstones

    public  getTombstones ()

    Recupera y muestra la lista de tombstones de los dispositivos. Requiere permisos de administrador.

    es el mejor esfuerzo, de modo que, si una tombstone no se puede extraer por algún motivo, no estará en la lista. Solo un DeviceNotAvailableException finalizará el método antes de tiempo.

    Devuelve
    Una lista de archivos de tombstone, vacío si no hay tombstone.

    Arroja
    DeviceNotAvailableException

    getTotalMemory

    public long getTotalMemory ()

    Devuelve el tamaño total de la memoria física en bytes o -1 en caso de error interno.

    Devuelve
    long

    getUninstallablePackageNames

    public  getUninstallablePackageNames ()

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

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

    Arroja
    DeviceNotAvailableException

    getUseFastbootBorra

    public boolean getUseFastbootErase ()

    Determina si se debe usar el formato de fastboot o borrado de fastboot para limpiar una partición del dispositivo.

    Devuelve
    boolean true si se usará el borrado de fastboot o false si se usará el formato de fastboot.

    getUserFlags.

    public int getUserFlags (int userId)

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

    Parámetros
    userId int

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

    Devuelve
    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

    Devuelve
    int

    Arroja
    DeviceNotAvailableException

    handleAllocationEvent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    Procesa un DeviceEvent determinado. Puede hacer la transición del dispositivo al estado nuevo. Informará a IDeviceMonitor sobre cualquier transición de estado.

    Procesar el DeviceEvent, lo que puede o no hacer la transición de este dispositivo a un nuevo estado de asignación

    Parámetros
    event DeviceEvent

    Devuelve
    IManagedTestDevice.DeviceEventResponse

    hasFeature

    public boolean hasFeature (String feature)

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

    Parámetros
    feature String: Corresponde al formato que debe ser directamente "feature:" o "".

    Devuelve
    boolean Es verdadero si se encuentra un 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" para conocer las opciones disponibles.

    Devuelve
    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 en los que se requiere un control explícito para otorgar permisos de tiempo de ejecución durante la instalación deben llamar a esta función.

    Parámetros
    packageFile File: Es el archivo APK que se instalará.

    reinstall boolean: 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" para conocer las opciones disponibles.

    Devuelve
    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" para conocer las opciones disponibles.

    Devuelve
    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 en los que se requiere un control explícito para otorgar permisos de tiempo de ejecución durante la instalación deben llamar a esta función.

    Parámetros
    packageFile File: Es el archivo APK que se instalará.

    reinstall boolean: 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" para conocer las opciones disponibles.

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

    Arroja
    DeviceNotAvailableException

    invalidatePropertyCache

    public void invalidatePropertyCache ()

    RaízAdB

    public boolean isAdbRoot ()

    Devuelve
    boolean

    Arroja
    DeviceNotAvailableException

    isAdbTcp

    public boolean isAdbTcp ()

    Devuelve
    boolean

    isAppEnumerationSupported

    public boolean isAppEnumerationSupported ()

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

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

    Arroja
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public boolean isBypassLowTargetSdkBlockSupported ()

    Verifica si la plataforma en el dispositivo admite la omisión del bloqueo del SDK de destino bajo en las instalaciones de apps

    Devuelve
    boolean Es verdadero si se admite la omisión del bloque de SDK de destino bajo; de lo contrario, es falso.

    Arroja
    DeviceNotAvailableException

    isDebugfsMounted

    public boolean isDebugfsMounted ()

    Verifica si el elemento debugfs está activado.

    Devuelve
    boolean true si se activa " debugfs"

    Arroja
    DeviceNotAvailableException

    isDeviceEncrypted

    public boolean isDeviceEncrypted ()

    Muestra si el dispositivo está encriptado.

    Devuelve
    boolean Es true si el dispositivo está encriptado.

    Arroja
    DeviceNotAvailableException

    isDirectory

    public boolean isDirectory (String path)

    Muestra el valor True si la ruta de acceso en el dispositivo es un directorio. De lo contrario, muestra false.

    Parámetros
    path String

    Devuelve
    boolean

    Arroja
    DeviceNotAvailableException

    RaízdeAdBAdm.

    public boolean isEnableAdbRoot ()

    Devuelve
    boolean true si la raíz de adb debe estar habilitada en el dispositivo.

    Compatible con la encriptación

    public boolean isEncryptionSupported ()

    Se devuelve si el dispositivo admite la encriptación.

    Devuelve
    boolean Es true si el dispositivo es compatible con la encriptación.

    Arroja
    DeviceNotAvailableException

    Se puede ejecutar

    public boolean isExecutable (String fullPath)

    Muestra el valor True si la ruta de acceso al archivo en el dispositivo es ejecutable. De lo contrario, muestra false.

    Parámetros
    fullPath String

    Devuelve
    boolean

    Arroja
    DeviceNotAvailableException

    estáFastbootEnabled

    public boolean isFastbootEnabled ()

    Muestra si fastboot está disponible para el dispositivo.

    Devuelve
    boolean

    Sin interfaz gráfica

    public boolean isHeadless ()

    Muestra true si el dispositivo no tiene interfaz gráfica (sin pantalla). De lo contrario, muestra false.

    Devuelve
    boolean

    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.

    Devuelve
    boolean

    Arroja
    DeviceNotAvailableException

    EsMainUserPermanentAdmin

    public boolean isMainUserPermanentAdmin ()

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

    Devuelve
    boolean

    Arroja
    DeviceNotAvailableException

    Compatibilidad con múltiples usuarios

    public boolean isMultiUserSupported ()

    Determina si se admite multiusuario.

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

    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 y comprobar si está instalado o no para ese usuario.

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

    userId String: Es el ID de usuario para el que verificaremos que el paquete esté instalado. Si es nulo, se usará el cero principal.

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

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

    Parámetros
    packageName String

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

    Arroja
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public boolean isRuntimePermissionSupported ()

    Verifica si la plataforma integrada en el dispositivo admite el otorgamiento de permisos de tiempo de ejecución

    Devuelve
    boolean Es verdadero si se admite el permiso de tiempo de ejecución. De lo contrario, es falso.

    Arroja
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public boolean isStateBootloaderOrFastbootd ()

    Muestra true si el dispositivo está en TestDeviceState#FASTBOOT o TestDeviceState.FASTBOOTD.

    Devuelve
    boolean

    EstáUserRunning

    public boolean isUserRunning (int userId)

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

    Parámetros
    userId int

    Devuelve
    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

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

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

    Parámetros
    userId int

    Devuelve
    boolean

    Arroja
    DeviceNotAvailableException

    esUserVisibleOnDisplay

    public boolean isUserVisibleOnDisplay (int userId, 
                    int displayId)

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

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

    Parámetros
    userId int

    displayId int

    Devuelve
    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) pasando una pantalla que muestra listDisplayIdsForStartingVisibleBackgroundUsers() (que debe incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

    Devuelve
    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) pasando una pantalla que muestra listDisplayIdsForStartingVisibleBackgroundUsers().

    Devuelve
    boolean

    Arroja
    DeviceNotAvailableException

    Wi-Fi habilitado

    public boolean isWifiEnabled ()

    Prueba si el Wi-Fi está habilitado.

    Comprueba si el Wi-Fi está habilitado en el dispositivo. Es útil para confirmar el estado de la conexión Wi-Fi antes de realizar pruebas que no se deberían ejecutar con Wi-Fi (p.ej., pruebas de datos móviles).

    Devuelve
    boolean true si el Wi-Fi está habilitado. false si está inhabilitada

    Arroja
    DeviceNotAvailableException

    IDDisplayDisplay

    public  listDisplayIds ()

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

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

    Devuelve

    Arroja
    DeviceNotAvailableException

    usuarios de la lista

    public  listUsers ()

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

    Devuelve
    la lista de IDs de usuario.

    Arroja
    DeviceNotAvailableException

    LogAnrs.

    public boolean logAnrs (ITestLogger logger)

    Recopila y registra ANR del dispositivo.

    Parámetros
    logger ITestLogger: Es un ITestLogger para registrar los errores de ANR.

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

    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.

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

    Dispositivo de acceso

    public void logOnDevice (String tag, 
                    Log.LogLevel level, 
                    String format, 
                    Object... args)

    Registra un mensaje en el logcat del dispositivo. Esta es una llamada segura que no arrojará, incluso, si falla el registro.

    Parámetros
    tag String: Es la etiqueta en la que registramos nuestro mensaje en logcat.

    level Log.LogLevel: Es el nivel de depuración del mensaje en el logcat.

    format String: Es el formato del mensaje.

    args Object: Son los argumentos que se reemplazarán mediante String.format().

    monteDebugfs

    public void mountDebugfs ()

    Activa Debugfs.

    Arroja
    DeviceNotAvailableException

    reinicio no bloqueado

    public void nonBlockingReboot ()

    Emite un comando para reiniciar el dispositivo y muestra cuando se completa el comando y cuando el dispositivo ya no es visible para adb.

    Arroja
    DeviceNotAvailableException

    postAdbRootAction

    public void postAdbRootAction ()

    Anula si el dispositivo necesita que se realicen algunas acciones específicas después de la raíz de adb y antes de que el dispositivo vuelva a estar en línea. La implementación predeterminada no incluye ninguna acción de adición. No se garantiza que la raíz de adb esté habilitada en esta etapa.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postAdbUnrootAction

    public void postAdbUnrootAction ()

    Anula si el dispositivo necesita que se realicen algunas acciones específicas después de quitar adb y antes de que el dispositivo vuelva a estar en línea. La implementación predeterminada no incluye ninguna acción adicional. No se garantiza que la raíz de adb esté inhabilitada en esta etapa.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Configuración posterior al arranque

    public void postBootSetup ()

    Sigue las instrucciones para configurar el dispositivo y probarlo después de cada inicio.

    Se debe llamar una vez que el dispositivo se haya iniciado por completo o esté disponible

    En circunstancias normales, no es necesario llamar a este método de manera explícita, ya que las implementaciones deberían realizar estos pasos automáticamente cuando se realiza un reinicio.

    Es posible que deba llamarse cuando se reinicia el dispositivo debido a otros eventos (p. ej., cuando se completó un comando de actualización de fastboot).

    Arroja
    DeviceNotAvailableException

    TearDown después de la invocación

    public void postInvocationTearDown (Throwable exception)

    Hay pasos adicionales para la limpieza específica del dispositivo que se requiere, que se ejecutará una vez que se complete la invocación.

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

    Configuración previa a la invocación

    public void preInvocationSetup (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    Pasos adicionales para la configuración requerida específica del dispositivo que se ejecutará en este antes del flujo de invocación.

    Parámetros
    info IBuildInfo: El IBuildInfo del dispositivo.

    attributes MultiMap: Los atributos almacenados en el contexto de invocación

    Arroja
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir, 
                    int userId)

    Extrae contenido del directorio del dispositivo de manera recurrente.

    Parámetros
    deviceFilePath String: La ruta de acceso absoluta al archivo de la fuente remota

    localDir File: El directorio local al que se extraerán archivos

    userId int: Es el ID de usuario desde el que se realizará la extracción.

    Devuelve
    boolean true si el archivo se extrajo correctamente. De lo contrario, false.

    Arroja
    DeviceNotAvailableException

    pullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Extrae contenido del directorio del dispositivo de manera recurrente.

    Parámetros
    deviceFilePath String: La ruta de acceso absoluta al archivo de la fuente remota

    localDir File: El directorio local al que se extraerán archivos

    Devuelve
    boolean true si el archivo se extrajo correctamente. De lo contrario, false.

    Arroja
    DeviceNotAvailableException

    Archivo pull

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Recupera un archivo fuera del dispositivo.

    Parámetros
    remoteFilePath String: Es la ruta de acceso absoluta al archivo en el dispositivo.

    localFile File: Es el archivo local en el que se almacenará el contenido. Si no está vacío, se reemplazará el contenido.

    Devuelve
    boolean Es true si el archivo se recuperó correctamente. De lo contrario, false.

    Arroja
    DeviceNotAvailableException

    Archivo pull

    public File pullFile (String remoteFilePath, 
                    int userId)

    Recupera un archivo fuera del dispositivo, lo almacena en un ERROR(/File) temporal local y muestra ese File.

    Parámetros
    remoteFilePath String: Es la ruta de acceso absoluta al archivo en el dispositivo.

    userId int: Es el ID de usuario desde el que se realizará la extracción.

    Devuelve
    File Un ERROR(/File) con el contenido del archivo del dispositivo, o null si la copia falló por algún motivo (incluidos los problemas con el sistema de archivos del host).

    Arroja
    DeviceNotAvailableException

    Archivo pull

    public File pullFile (String remoteFilePath)

    Recupera un archivo fuera del dispositivo, lo almacena en un ERROR(/File) temporal local y muestra ese File.

    Parámetros
    remoteFilePath String: Es la ruta de acceso absoluta al archivo en el dispositivo.

    Devuelve
    File Un ERROR(/File) con el contenido del archivo del dispositivo, o null si la copia falló por algún motivo (incluidos los problemas con el sistema de archivos del host).

    Arroja
    DeviceNotAvailableException

    Archivo pull

    public boolean pullFile (String remoteFilePath, 
                    File localFile, 
                    int userId)

    Recupera un archivo fuera del dispositivo.

    Parámetros
    remoteFilePath String: Es la ruta de acceso absoluta al archivo en el dispositivo.

    localFile File: Es el archivo local en el que se almacenará el contenido. Si no está vacío, se reemplazará el contenido.

    userId int: Es el ID de usuario desde el que se realizará la extracción.

    Devuelve
    boolean Es true si el archivo se recuperó correctamente. De lo contrario, false.

    Arroja
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

    Recupera un archivo fuera del dispositivo y muestra el contenido.

    Parámetros
    remoteFilePath String: Es la ruta de acceso absoluta al archivo en el dispositivo.

    Devuelve
    String Un String con el contenido del archivo del dispositivo, o null si la copia falló por algún motivo (incluidos los problemas con el sistema de archivos del host).

    Arroja
    DeviceNotAvailableException

    extraerArchivoDeexterno

    public File pullFileFromExternal (String remoteFilePath)

    Un método útil para recuperar un archivo del almacenamiento externo del dispositivo, almacenarlo en un ERROR(/File) local temporal y mostrar una referencia a ese File.

    Parámetros
    remoteFilePath String: Es la ruta de acceso al archivo en el dispositivo, en relación con el punto de activación del almacenamiento externo del dispositivo.

    Devuelve
    File Un ERROR(/File) con el contenido del archivo del dispositivo, o null si la copia falló por algún motivo (incluidos los problemas con el sistema de archivos del host).

    Arroja
    DeviceNotAvailableException

    PushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath, 
                     excludedDirectories)

    Envía de manera recurrente el contenido del directorio al dispositivo y, al mismo tiempo, excluye algunos directorios filtrados.

    Parámetros
    localFileDir File: Es el directorio local que se enviará.

    deviceFilePath String: Es la ruta de acceso absoluta al archivo del destino remoto.

    excludedDirectories : Es el conjunto de nombres de directorios excluidos que no se deben enviar.

    Devuelve
    boolean true si el archivo se envió correctamente. De lo contrario, false.

    Arroja
    DeviceNotAvailableException

    PushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

    Envía de manera recurrente el contenido del directorio al dispositivo.

    Parámetros
    localFileDir File: Es el directorio local que se enviará.

    deviceFilePath String: Es la ruta de acceso absoluta al archivo del destino remoto.

    Devuelve
    boolean true si el archivo se envió correctamente. De lo contrario, false.

    Arroja
    DeviceNotAvailableException

    PushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath, 
                    int userId)

    Envía de manera recurrente el contenido del directorio al dispositivo.

    Parámetros
    localFileDir File: Es el directorio local que se enviará.

    deviceFilePath String: Es la ruta de acceso absoluta al archivo del destino remoto.

    userId int: Es el ID de usuario al que se enviará el mensaje.

    Devuelve
    boolean true si el archivo se envió correctamente. De lo contrario, false.

    Arroja
    DeviceNotAvailableException

    Archivo push

    public boolean pushFile (File localFile, 
                    String remoteFilePath, 
                    boolean evaluateContentProviderNeeded)

    Es una variante de pushFile(File, String) que puede considerar de manera opcional evaluar la necesidad del proveedor de contenido.

    Parámetros
    localFile File: Es el archivo local que se enviará.

    remoteFilePath String: Es la ruta de acceso absoluta del archivo de destino remoto.

    evaluateContentProviderNeeded boolean: Indica si se debe verificar si necesitamos el proveedor de contenido.

    Devuelve
    boolean true si el archivo se envió correctamente. De lo contrario, false.

    Arroja
    DeviceNotAvailableException

    Archivo push

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    Envía un archivo al dispositivo. De forma predeterminada, con un proveedor de contenido.

    Parámetros
    localFile File: Es el archivo local que se enviará.

    remoteFilePath String: Es la ruta de acceso absoluta del archivo de destino remoto.

    Devuelve
    boolean true si el archivo se envió correctamente. De lo contrario, false.

    Arroja
    DeviceNotAvailableException

    Archivo push

    public boolean pushFile (File localFile, 
                    String remoteFilePath, 
                    int userId)

    Envía un archivo al dispositivo. De forma predeterminada, con un proveedor de contenido.

    Parámetros
    localFile File: Es el archivo local que se enviará.

    remoteFilePath String: Es la ruta de acceso absoluta del archivo de destino remoto.

    userId int: El userId al que se enviará el mensaje

    Devuelve
    boolean true si el archivo se envió correctamente. De lo contrario, false.

    Arroja
    DeviceNotAvailableException

    PushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

    Envío de archivo creado a partir de una cadena al dispositivo

    Parámetros
    contents String: Es el contenido del archivo que se enviará.

    remoteFilePath String: Es la ruta de acceso absoluta del archivo de destino remoto.

    Devuelve
    boolean true si la cadena se envió correctamente. De lo contrario, false.

    Arroja
    DeviceNotAvailableException

    reiniciar

    public void reboot (String reason)

    Reinicia el dispositivo en modo adb con el reason determinado para que persista durante el reinicio.

    Se bloquea hasta que el dispositivo esté disponible.

    El motivo del último reinicio se puede obtener consultando la propiedad sys.boot.reason.

    Parámetros
    reason String: Es un motivo para el reinicio o null si no se especifica un motivo.

    Arroja
    DeviceNotAvailableException

    reiniciar

    public void reboot ()

    Reinicia el dispositivo en modo adb.

    Se bloquea hasta que el dispositivo esté disponible.

    Arroja
    DeviceNotAvailableException

    reiniciarIntoBootloader

    public void rebootIntoBootloader ()

    Reinicia el dispositivo en el modo de bootloader.

    Se bloquea hasta que el dispositivo esté en el modo de bootloader.

    Arroja
    DeviceNotAvailableException

    reiniciarIntoFastbootd

    public void rebootIntoFastbootd ()

    Reinicia el dispositivo en el modo fastbootd.

    Se bloquea hasta que el dispositivo esté en modo de inicio rápido.

    Arroja
    DeviceNotAvailableException

    reinicio en la recuperación

    public void rebootIntoRecovery ()

    Reinicia el dispositivo en el modo de recuperación de adb.

    Se bloquea hasta que el dispositivo entre en recuperación

    Arroja
    DeviceNotAvailableException

    reiniciarIntoSideload

    public void rebootIntoSideload ()

    Reinicia el dispositivo en el modo de transferencia de adb (ten en cuenta que se trata de un modo especial en recuperación).

    Se bloquea hasta que el dispositivo entre en modo de transferencia

    Arroja
    DeviceNotAvailableException

    reiniciarIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

    Reinicia el dispositivo en el modo de transferencia de adb (ten en cuenta que se trata de un modo especial en recuperación).

    Se bloquea hasta que el dispositivo entre en modo de transferencia

    Parámetros
    autoReboot boolean: Indica si se debe reiniciar automáticamente el dispositivo después de una transferencia.

    Arroja
    DeviceNotAvailableException

    reiniciarHastaEn línea

    public void rebootUntilOnline ()

    Una alternativa a reboot() que solo se bloquea hasta que el dispositivo esté en línea, es decir, visible para adb

    Arroja
    DeviceNotAvailableException

    reiniciarHastaEn línea

    public void rebootUntilOnline (String reason)

    Una alternativa a reboot() que solo se bloquea hasta que el dispositivo esté en línea, es decir, visible para adb

    Parámetros
    reason String: Es un motivo para el reinicio o null si no se especifica un motivo.

    Arroja
    DeviceNotAvailableException

    espacio de usuario de reinicio

    public void rebootUserspace ()

    Reinicia solo una parte del espacio del usuario del dispositivo.

    Se bloquea hasta que el dispositivo esté disponible.

    ADVERTENCIA. En este momento, el reinicio del espacio del usuario está en desarrollo activo. Úsalo bajo tu responsabilidad.

    Arroja
    DeviceNotAvailableException

    reiniciarelespaciodeusuarioHastaEn línea

    public void rebootUserspaceUntilOnline ()

    Es una alternativa a rebootUserspace() ()} que solo se bloquea hasta que el dispositivo esté en línea, es decir, visible para adb.

    Arroja
    DeviceNotAvailableException

    recuperarDispositivo

    public boolean recoverDevice ()

    Intenta recuperar la comunicación con el dispositivo.

    Devuelve
    boolean Es verdadero si se intentó la recuperación correctamente. El resultado es falso si se omitió la recuperación.

    Arroja
    DeviceNotAvailableException si el dispositivo ya no está disponible

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Registra un IDeviceActionReceiver para este dispositivo.

    Se notificará a todos los IDeviceActionReceiver registrados antes de que se inicie una acción del dispositivo y después de que esta finalice.

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

    remountSystemReadOnly

    public void remountSystemReadOnly ()

    Haz que la partición del sistema en el dispositivo sea de solo lectura. Es posible que se reinicie el dispositivo.

    Arroja
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

    Permite que se pueda escribir en la partición del sistema del dispositivo. Es posible que se reinicie el dispositivo.

    Arroja
    DeviceNotAvailableException

    remountVendor (solo lectura)

    public void remountVendorReadOnly ()

    Haz que la partición del proveedor en el dispositivo sea de solo lectura. Es posible que se reinicie el dispositivo.

    Arroja
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

    Permitir que se pueda escribir en la partición del proveedor en el dispositivo. Es posible que se reinicie el dispositivo.

    Arroja
    DeviceNotAvailableException

    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.

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

    Arroja
    DeviceNotAvailableException

    quitarPropietarios

    public void removeOwners ()

    Quita a todos los propietarios existentes de perfiles de dispositivo 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á

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

    Arroja
    DeviceNotAvailableException

    restablecerContentProviderConfiguración

    public void resetContentProviderSetup ()

    Restablece la marca de la configuración del proveedor de contenido para volver a activarla.

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                    ITestLifeCycleReceiver... listeners)

    Método de conveniencia para realizar ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) con uno o más objetos de escucha pasados como parámetros.

    Parámetros
    runner IRemoteAndroidTestRunner: El IRemoteAndroidTestRunner que ejecuta las pruebas

    listeners ITestLifeCycleReceiver: Son los objetos de escucha de los resultados de la prueba.

    Devuelve
    boolean Es true si se completó el comando de prueba. false si no se pudo completar, pero la recuperación se realizó correctamente

    Arroja
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Ejecuta pruebas de instrumentación y proporciona recuperación de dispositivos.

    Si se pierde la conexión con el dispositivo antes de que se complete la ejecución de prueba y la recuperación se realiza correctamente, se informará a todos los objetos de escucha sobre testRunFailed y se mostrará el valor "false". No se volverá a ejecutar el comando de prueba. Los emisores deben volver a intentarlo si es necesario.

    Si se pierde la conexión con el dispositivo antes de que se complete la ejecución de prueba y falla la recuperación, se informará a todos los objetos de escucha sobre testRunFailed y se arrojará DeviceNotAvailableException.

    Parámetros
    runner IRemoteAndroidTestRunner: El IRemoteAndroidTestRunner que ejecuta las pruebas

    listeners : Son los objetos de escucha del resultado de la prueba.

    Devuelve
    boolean Es true si se completó el comando de prueba. false si no se pudo completar debido a una excepción de comunicación del dispositivo, pero la recuperación se realizó correctamente

    Arroja
    DeviceNotAvailableException

    runInstrumentationTestsComoUsuario

    public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                     listeners)

    Es igual que ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), pero ejecuta la prueba para el usuario determinado.

    Parámetros
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Devuelve
    boolean

    Arroja
    DeviceNotAvailableException

    runInstrumentationTestsComoUsuario

    public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                    ITestLifeCycleReceiver... listeners)

    Es igual que ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), pero ejecuta la prueba para un usuario determinado.

    Parámetros
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Devuelve
    boolean

    Arroja
    DeviceNotAvailableException

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    Inserta el IConfiguration en uso.

    Parámetros
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    Parámetros
    avdInfo GceAvdInfo

    Configurar Fecha

    public void setDate (Date date)

    Establece la fecha en el dispositivo

    Nota: La configuración de la fecha en el dispositivo requiere permisos de administrador

    Parámetros
    date Date: Especifica una fecha específica; se usará la fecha de host si null

    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.

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

    Arroja
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    Actualiza el estado del dispositivo.

    Parámetros
    deviceState TestDeviceState: el TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    Para el emulador, configura SizeLimitedOutputStream para registrar resultados

    Parámetros
    output SizeLimitedOutputStream: Para registrar el resultado

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

    Establece Process, cuando este dispositivo es un emulador.

    Parámetros
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

    Configura la opción fastboot para el dispositivo. Se debe configurar cuando se asigna el dispositivo por primera vez.

    Parámetros
    fastbootEnabled boolean: Indica si fastboot está disponible para el dispositivo o no.

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    Establece la ruta de acceso al objeto binario de fastboot que se debe usar. Aún se requiere que isFastbootEnabled() sea verdadero para tener habilitadas las funciones de fastboot.

    Parámetros
    fastbootPath String

    SetIDevice

    public void setIDevice (IDevice newDevice)

    Actualiza el IDevice asociado con este ITestDevice.

    El nuevo IDevice debe hacer referencia al mismo dispositivo físico que la referencia actual. Se llamará a este método si DDMS asignó un nuevo IDevice.

    Parámetros
    newDevice IDevice: el IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

    Establece el tiempo en ms que se debe esperar antes de iniciar la captura de logcat para un dispositivo en línea.

    Parámetros
    delay int: la demora en ms

    setOptions

    public void setOptions (TestDeviceOptions options)

    Establece el TestDeviceOptions para el dispositivo.

    Parámetros
    options TestDeviceOptions

    setProperty

    public boolean setProperty (String propKey, 
                    String propValue)

    Establece el valor de la propiedad determinada en el dispositivo. Se requiere que la raíz de adb sea verdadera.

    Parámetros
    propKey String: Es la clave que se establecerá.

    propValue String: Es el valor de la propiedad que se establecerá.

    Devuelve
    boolean Devuelve True si el comando setprop tuvo éxito; de lo contrario, muestra False.

    Arroja
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

    Configura el parámetro IDeviceRecovery que se usará en este dispositivo. Se debe configurar cuando se asigna el dispositivo por primera vez.

    Parámetros
    recovery IDeviceRecovery: el IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Configura el modo de recuperación que se usará en el dispositivo.

    Se usa para controlar qué método de recuperación usar cuando se produce un problema de comunicación del dispositivo. Se recomienda usar este método con moderación solo cuando sea necesario (por ejemplo, cuando el framework está inactivo, etcétera.

    Parámetros
    mode ITestDevice.RecoveryMode: Indica si el modo "recuperar hasta solo en línea" debe estar activado o no.

    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 reiniciar el dispositivo. 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

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    Inserta la instancia ITestLogger.

    Parámetros
    testLogger ITestLogger

    setUsarInicioRápidoBorrar

    public void setUseFastbootErase (boolean useFastbootErase)

    Configura si quieres usar el formato de fastboot o borrado de fastboot para limpiar una partición del dispositivo.

    Parámetros
    useFastbootErase boolean: Es true si se debe usar el borrado de fastboot o false si se debe usar el formato de fastboot.

    startLogcat

    public void startLogcat ()

    Comienza a capturar resultados de logcat del dispositivo en segundo plano.

    No tendrá efecto si ya se está capturando el resultado de logcat. Los datos se pueden recuperar más adelante a través de getLogcat.

    Cuando el dispositivo ya no esté en uso, se debe llamar a stopLogcat().

    Por lo general, no es necesario llamar a startLogcat() y stopLogcat() cuando están en un contexto de invocación de TF, ya que el framework de TF iniciará y detendrá Logcat.

    Usuario de inicio

    public boolean startUser (int userId)

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

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

    Devuelve
    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 se está ejecutando en segundo plano, este método es un NOOP. Es posible proporcionar marcas adicionales para esperar a que la operación tenga efecto.

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

    waitFlag boolean: Hace que el comando espere hasta que el usuario se inicie y se desbloquee.

    Devuelve
    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, le permite al usuario iniciar actividades en esa pantalla).

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

    Parámetros
    userId int: Del usuario 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.

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

    Arroja
    DeviceNotAvailableException

    stopEmulatorOutput

    public void stopEmulatorOutput ()

    Cierra y borra el resultado del emulador.

    detenerLogcat

    public void stopLogcat ()

    Detén la captura de resultados de logcat del dispositivo y descarta los datos de logcat guardados actualmente.

    No tendrá efecto si no se captura el resultado de logcat.

    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

    Devuelve
    boolean true si el usuario se detuvo correctamente.

    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 finalizació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.

    Devuelve
    boolean true si el usuario se detuvo correctamente.

    Arroja
    DeviceNotAvailableException

    switchToAdbTcp

    public String switchToAdbTcp ()

    Cambia el dispositivo al modo adb-over-tcp.

    Devuelve
    String el número de serie de TCP o null si no se pudo cambiar el dispositivo

    Arroja
    DeviceNotAvailableException

    cambiarAAdbusb

    public boolean switchToAdbUsb ()

    Cambia el dispositivo al modo adb mediante USB.

    Devuelve
    boolean true si el cambio se realizó correctamente; de lo contrario, false.

    Arroja
    DeviceNotAvailableException

    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

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

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

    Arroja
    DeviceNotAvailableException

    Archivos sincronizados

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Sincroniza de forma incremental el contenido de un directorio de archivos local con el dispositivo.

    Decide qué archivos enviar comparando las marcas de tiempo de los archivos locales con sus equivalentes remotos. Solo se enviarán al dispositivo los archivos "más nuevos" o que no existan. Por lo tanto, la sobrecarga debería ser relativamente pequeña si el archivo configurado en el dispositivo ya está actualizado.

    Se ignorarán los archivos ocultos (con nombres que comiencen con ".").

    Ejemplo de uso: syncFiles("/tmp/files", "/sdcard") creará un directorio /sdcard/files si aún no existe y enviará de manera recurrente el contenido de /tmp/files a /sdcard/files.

    Parámetros
    localFileDir File: Es el directorio de archivos local que contiene los archivos que se enviarán de forma recursiva.

    deviceFilePath String: Es la raíz de la ruta de acceso absoluta del archivo de destino remoto. Todos los directorios de esta ruta de acceso del archivo deben ser legibles. Es decir, no se podrá enviar a /data/local/tmp cuando adb no sea raíz.

    Devuelve
    boolean true si los archivos se sincronizaron correctamente. De lo contrario, false.

    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. Muestra un valor nulo en caso de problema. El archivo al que se hace referencia en el objeto del informe de errores se debe limpiar a través de Bugreport.close().

    Devuelve
    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á.

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

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

    Arroja
    DeviceNotAvailableException

    desbloquearDispositivo

    public boolean unlockDevice ()

    Desbloquea el dispositivo si está encriptado.

    Este método puede reiniciar el framework, pero no llamará a postBootSetup(). Por lo tanto, es posible que el dispositivo no esté completamente listo para las pruebas cuando se muestre este método.

    Devuelve
    boolean Es true si se ejecuta correctamente o si el dispositivo no está encriptado.

    Arroja
    DeviceNotAvailableException

    unmountDebugfs

    public void unmountDebugfs ()

    Desactiva Debugfs.

    Arroja
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

    Se bloquea hasta que se establezca la marca de inicio completado del dispositivo.

    Parámetros
    timeOut long: Tiempo en ms para esperar a que se establezca la marca

    Devuelve
    boolean true si la marca de inicio completado del dispositivo se establece dentro del tiempo de espera

    Arroja
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

    Espera a que el dispositivo responda y esté disponible para las pruebas. Usa el tiempo de espera predeterminado.

    Devuelve
    boolean Verdadero si el dispositivo está disponible. Falso si la recuperación está inhabilitada y no está disponible.

    Arroja
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

    Espera a que el dispositivo responda y esté disponible para las pruebas.

    Parámetros
    waitTime long: Es el tiempo en ms que se debe esperar.

    Devuelve
    boolean Verdadero si el dispositivo está disponible. Falso si la recuperación está inhabilitada y no está disponible.

    Arroja
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Espera a que el dispositivo responda y esté disponible sin considerar la ruta de recuperación.

    Parámetros
    waitTime long

    Devuelve
    boolean Verdadero si el dispositivo está disponible. Falso si no lo está.

    Arroja
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

    Se bloquea hasta que el dispositivo sea visible mediante fastboot. Usar el tiempo de espera predeterminado

    Arroja
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

    Bloquea el dispositivo en el estado de "recuperación de adb" (ten en cuenta que es distinto de IDeviceRecovery).

    Parámetros
    waitTime long: Es el tiempo en ms que se debe esperar.

    Devuelve
    boolean Es true si el dispositivo se inicia en recuperación antes de que finalice el tiempo. false por lo demás

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

    Bloqueos para que el dispositivo tenga el estado "transferencia de adb"

    Parámetros
    waitTime long: Es el tiempo en ms que se debe esperar.

    Devuelve
    boolean Es true si el dispositivo se inicia en una transferencia antes de que finalice el tiempo. false por lo demás

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

    Bloqueos para que el dispositivo no esté disponible, es decir, falta en adb

    Parámetros
    waitTime long: Es el tiempo en ms que se debe esperar.

    Devuelve
    boolean true si el dispositivo no está disponible antes de que se acabe el tiempo. false por lo demás

    waitForDeviceEn línea

    public void waitForDeviceOnline ()

    Se bloquea hasta que el dispositivo sea visible mediante adb. Usa el tiempo de espera predeterminado

    Ten en cuenta que es posible que el dispositivo no responda a los comandos una vez completado. En su lugar, usa waitForDeviceAvailable().

    Arroja
    DeviceNotAvailableException

    waitForDeviceEn línea

    public void waitForDeviceOnline (long waitTime)

    Se bloquea hasta que el dispositivo sea visible mediante adb.

    Ten en cuenta que es posible que el dispositivo no responda a los comandos una vez completado. En su lugar, usa waitForDeviceAvailable().

    Parámetros
    waitTime long: Es el tiempo en ms que se debe esperar.

    Arroja
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

    Espera a que el dispositivo responda a un comando shell adb básico.

    Parámetros
    waitTime long: Es el tiempo en ms que se debe esperar.

    Devuelve
    boolean Es true si el dispositivo responde antes de que transcurra la waitTime.

    Métodos protegidos

    addExtraConnectionBuilderArgs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    Parámetros
    builder DefaultConnection.ConnectionBuilder

    Comando buildAdbShell

    protected String[] buildAdbShellCommand (String command, 
                    boolean forceExitStatusDetection)

    Compila el comando de SO para la sesión y los argumentos del comando de shell adb determinados.

    Parámetros
    command String

    forceExitStatusDetection boolean

    Devuelve
    String[]

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    Parámetros
    feature String

    strictMinLevel int

    createRestartDeviceAction

    protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Crea un RebootDeviceAction para usar cuando se realice una acción de reinicio.

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

    reason String: Para este reinicio.

    Devuelve
    NativeDevice.RebootDeviceAction el RebootDeviceAction creado.

    createRunUtil

    protected IRunUtil createRunUtil ()

    Devuelve
    IRunUtil

    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

    AssuredRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

    un método auxiliar para arrojar una excepción si no se admite el permiso de tiempo de ejecución

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getApiLevelSafe

    protected int getApiLevelSafe ()

    Devuelve
    int

    getLogger

    protected ITestLogger getLogger ()

    Devuelve
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

    Obtén la instancia de RunUtil que se usará.

    Devuelve
    IRunUtil

    inicializarConnection

    protected void initializeConnection (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    Parámetros
    info IBuildInfo

    attributes MultiMap

    Arroja
    DeviceNotAvailableException
    TargetSetupError

    internalGetProperty

    protected String internalGetProperty (String propName, 
                    String fastbootVar, 
                    String description)

    Obtén una propiedad de dispositivo, de la caché de ddmlib de forma predeterminada, y recurre a `adb shell getprop` o `fastboot getvar` según si el dispositivo está en Fastboot o no.

    Parámetros
    propName String: Es el nombre de la propiedad del dispositivo como lo muestra "adb shell getprop".

    fastbootVar String: Es el nombre de la variable de fastboot equivalente a consultar; si es null, no se intentará realizar la consulta de fastboot.

    description String: Es una descripción simple de la variable. La primera letra debe estar en mayúscula.

    Devuelve
    String Es una cadena, posiblemente null o vacía, que contiene el valor de la propiedad determinada.

    Arroja
    DeviceNotAvailableException

    isInRestartCallback

    protected boolean isInRebootCallback ()

    Muestra si las devoluciones de llamada de reinicio se están ejecutando actualmente o no. Todas las APIs públicas para reinicio se deben inhabilitar si son verdaderas.

    Devuelve
    boolean

    Más reciente

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    Muestra true si el archivo local es más reciente que el archivo remoto. IFileEntry con una precisión de minuto y, en caso de que sean iguales, el archivo se considerará más reciente.

    Parámetros
    localFile File

    entry IFileEntry

    Devuelve
    boolean

    notificar RestartEnded

    protected void notifyRebootEnded ()

    Notifica a todos los IDeviceActionReceiver sobre el evento de finalización de reinicio.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Notificar ReiniciarInicio

    protected void notifyRebootStarted ()

    Notifica a todos los IDeviceActionReceiver sobre el evento de inicio de reinicio.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    realice una acción en el dispositivo

    protected boolean performDeviceAction (String actionDescription, 
                    NativeDevice.DeviceAction action, 
                    int retryAttempts)

    Realiza una acción en este dispositivo. Intenta recuperar el dispositivo y, opcionalmente, vuelve a intentar el comando si la acción falla.

    Parámetros
    actionDescription String: Es una descripción breve de la acción que se realizará. Solo se usa para fines de registro.

    action NativeDevice.DeviceAction: Es la acción que se realizará.

    retryAttempts int: El reintento intenta realizar la acción si falla, pero la recuperación se realiza correctamente.

    Devuelve
    boolean true si la acción se realizó correctamente

    Arroja
    DeviceNotAvailableException si el intento de recuperación falla o la cantidad máxima de intentos realizados sin éxito

    Reinicio de post Adb

    protected void postAdbReboot ()

    Posibles acciones adicionales que se pueden realizar después de reiniciar el dispositivo.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    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 posterior al inicio específica.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    pullFileInterno

    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    Parámetros
    remoteFilePath String

    localFile File

    Devuelve
    boolean

    Arroja
    DeviceNotAvailableException

    Configurar reloj

    protected void setClock (Clock clock)

    Configura la instancia de reloj que se usará.

    Parámetros
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Marca el TestDevice como microdroid y establece su CID.

    Parámetros
    process Process: Proceso de la VM de Microdroid.

    setTestDeviceOptions

    protected void setTestDeviceOptions ( deviceOptions)

    Parámetros
    deviceOptions

    Comando simpleFastboot

    protected CommandResult simpleFastbootCommand (long timeout, 
                     envVarMap, 
                    String[] fullCmd)

    Ejecuta un comando fastboot simple con variables de entorno y, además, informa el estado del comando.

    Parámetros
    timeout long

    envVarMap

    fullCmd String

    Devuelve
    CommandResult

    Comando simpleFastboot

    protected CommandResult simpleFastbootCommand (long timeout, 
                    String[] fullCmd)

    Ejecuta un comando fastboot simple y, luego, informa el estado del comando.

    Parámetros
    timeout long

    fullCmd String

    Devuelve
    CommandResult

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

    Espera a que el dispositivo deje de estar disponible (deja de informar a adb).

    Parámetros
    operationDesc String: Es el nombre de la operación que espera que no esté disponible.

    time long: Es el tiempo que se debe esperar hasta que ocurra un evento no disponible.

    Devuelve
    boolean Es verdadero si el dispositivo no está disponible.