Dispositivo nativo

public class NativeDevice
extends Object implements IManagedTestDevice , IConfigurationReceiver , ITestLoggerReceiver

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


Implementación predeterminada de un ITestDevice Dispositivos Android que no son de pila completa.

Resumen

clases anidadas

class NativeDevice.AdbAction

Un ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) al ejecutar un comando 'adb ....' del sistema operativo.

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 devuelto para cualquier identificación de usuario no válida o no encontrada: UserHandle definió el valor -10000

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

el número predeterminado de intentos de reintento 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) al obtener previamente todos los accesorios que necesitamos en lugar de llamar 'adb getprop' para cada uno.

boolean canSwitchToHeadlessSystemUser ()

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

boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Compruebe si una característica es actualmente compatible con un nivel mínimo de compatibilidad.

boolean checkConnectivity ()

Verifique que el dispositivo tenga conectividad de red.

boolean clearErrorDialogs ()

Intente descartar cualquier cuadro de diálogo de error que se muestre actualmente en la interfaz de usuario del dispositivo.

void clearLastConnectedWifiNetwork ()

Borra la última red wifi conectada.

void clearLogcat ()

Elimina cualquier dato de logcat acumulado.

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

Se conecta a una red wifi.

boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Se conecta a una red wifi.

boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

Se conecta a una red wifi.f

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

Se conecta a una red wifi.

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

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

boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

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

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

Cree un usuario con un nombre de pila y las banderas proporcionadas

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

Cree un usuario con un nombre de pila y las banderas proporcionadas

int createUser (String name)

Cree un usuario con un nombre de pila y banderas predeterminadas 0.

int createUserNoThrow (String name)

Cree un usuario con un nombre de pila y banderas predeterminadas 0.

void deleteFile (String deviceFilePath)

Método auxiliar para eliminar un archivo o directorio en el dispositivo.

void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Elimina el IDeviceActionReceiver registrado.

boolean deviceSoftRestarted ( ProcessInfo prevSystemServerProcess)

Método auxiliar para verificar si el dispositivo se reinició suavemente comparando el system_server actual con el system_server ProcessInfo anterior.

boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

Método auxiliar para verificar si el dispositivo se reinició suavemente desde la hora UTC desde la época del dispositivo y su ERROR(/TimeUnit) .

boolean disableAdbRoot ()

Desactiva la raíz de adb.

void disableKeyguard ()

Intenta desactivar el bloqueo de teclas.

boolean disableNetworkMonitor ()

Desactiva el monitoreo de red en el dispositivo.

boolean disconnectFromWifi ()

Se desconecta de una red wifi.

boolean doesFileExist (String deviceFilePath, int userId)

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

boolean doesFileExist (String deviceFilePath)

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

File dumpHeap (String process, String devicePath)

Intente volcar el montón del system_server.

boolean enableAdbRoot ()

Activa la raíz de adb.

boolean enableNetworkMonitor ()

Habilita el monitoreo de red en el dispositivo.

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

Método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera específico.

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

Método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera específico.

String executeAdbCommand (String... cmdArgs)

Método auxiliar que ejecuta un comando adb como comando del sistema.

CommandResult executeFastbootCommand (String... cmdArgs)

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

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

Método auxiliar que ejecuta un comando fastboot como comando del sistema.

CommandResult executeLongFastbootCommand (String... cmdArgs)

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

CommandResult executeLongFastbootCommand ( envVarMap, String... cmdArgs) 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)

Método auxiliar que ejecuta un comando de adb Shell y devuelve la salida como una String .

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

Ejecuta un comando de adb shell, 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 de adb shell, con más parámetros para controlar el comportamiento del comando.

void executeShellCommand (String command, IShellOutputReceiver receiver)

Ejecuta el comando adb shell dado y lo vuelve a intentar varias veces si el comando falla.

CommandResult executeShellV2Command (String cmd)

Método auxiliar que ejecuta un comando de adb shell y devuelve los resultados como un CommandResult correctamente completado con la salida del estado del comando, stdout y stderr.

CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)

Método auxiliar que ejecuta un comando de adb shell y devuelve los resultados como un CommandResult correctamente completado con la salida del estado del comando y stderr.

CommandResult executeShellV2Command (String cmd, File pipeAsInput)

Método auxiliar que ejecuta un comando de adb shell y devuelve los resultados como un CommandResult correctamente completado con la salida del estado del comando, stdout y stderr.

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

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

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

Ejecuta un comando de adb shell, 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 de adb shell, 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 de adb shell, con más parámetros para controlar el comportamiento del comando.

CommandResult fastbootWipePartition (String partition)

Método auxiliar que borra una partición del dispositivo.

getActiveApexes ()

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

getAllSettings (String namespace)

Devuelve pares clave-valor del espacio de nombres solicitado.

DeviceAllocationState getAllocationState ()

Devolver el estado de asignación actual del dispositivo

String getAndroidId (int userId)

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

getAndroidIds ()

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

int getApiLevel ()

Obtenga el nivel API del dispositivo.

PackageInfo getAppPackageInfo (String packageName)

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

getAppPackageInfos ()

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

String getBasebandVersion ()

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

Integer getBattery ()

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

boolean getBooleanProperty (String name, boolean defaultValue)

Devuelve el valor booleano de la propiedad dada.

getBootHistory ()

El método auxiliar recopila el mapa del historial de arranque con la hora de arranque y el motivo de arranque.

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 momento dado desde la época del dispositivo y la unidad de tiempo especificada.

String getBootloaderVersion ()

Método conveniente para obtener la versión del gestor de arranque de este dispositivo.

InputStreamSource getBugreport ()

Recupera un informe de error del dispositivo.

InputStreamSource getBugreportz ()

Recupera un informe de error del dispositivo.

String getBuildAlias ()

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

String getBuildFlavor ()

Recupere el tipo de compilación para el dispositivo.

String getBuildId ()

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

String getBuildSigningKeys ()

Devuelve el tipo de clave utilizada para firmar la imagen del dispositivo.

Normalmente, los dispositivos Android pueden estar firmados con claves de prueba (como en AOSP) o claves de liberación (controladas por los fabricantes de dispositivos individuales).

DeviceDescriptor getCachedDeviceDescriptor ()

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

DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

String[] getChildren (String path)

Alternativa al uso IFileEntry que a veces no funciona debido a permisos.

AbstractConnection getConnection ()

La conexión actual asociada con el dispositivo.

DeviceFoldableState getCurrentFoldableState ()

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

int getCurrentUser ()

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

String getDeviceClass ()

Obtenga la clase de dispositivo.

long getDeviceDate ()

Devuelve la fecha del dispositivo en milisegundos desde la época.

DeviceDescriptor getDeviceDescriptor ()

Devuelve un DeviceDescriptor de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo real.

DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Devuelve un DeviceDescriptor de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo real.

TestDeviceState getDeviceState ()

Obtenga el estado del dispositivo.

long getDeviceTimeOffset (Date date)

Ayudante para obtener la diferencia horaria entre el dispositivo y un ERROR(/Date) determinado.

InputStreamSource getEmulatorOutput ()

Obtener el flujo de stdout y stderr del emulador

Process getEmulatorProcess ()

Devuelve el Process correspondiente a este emulador.

final File getExecuteShellCommandLog ()

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

long getExternalStoreFreeSpace ()

Método auxiliar para determinar la cantidad de espacio libre en el almacenamiento externo del dispositivo.

String getFastbootPath ()

Devuelve la ruta del binario fastboot que se está utilizando.

String getFastbootProductType ()

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

String getFastbootProductVariant ()

Método conveniente 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)

Recupere el valor de la variable fastboot proporcionado del dispositivo.

String getFastbootVersion ()

Devuelve la cadena de versión del binario fastboot que se está utilizando.

IFileEntry getFileEntry (String path)

Recupera una referencia a un archivo remoto en el dispositivo.

IFileEntry getFileEntry (FileListingService.FileEntry entry)

Ayudante no oficial para obtener un FileEntry desde una ruta no raíz.

getFoldableStates ()

Devuelve la lista de estados plegables en el dispositivo.

IDevice getIDevice ()

Devuelve una referencia al IDevice ddmlib asociado.

getInstalledPackageNames ()

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

long getIntProperty (String name, long defaultValue)

Devuelve el valor entero de la propiedad dada del dispositivo.

String getIpAddress ()

Obtiene la dirección IP del dispositivo.

KeyguardControllerState getKeyguardState ()

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

long getLastExpectedRebootTimeMillis ()

Devuelve la última vez que las API Tradefed activaron un reinicio en milisegundos desde EPOCH según lo devuelto por System.currentTimeMillis() .

int getLaunchApiLevel ()

Obtenga el primer nivel API lanzado del dispositivo.

InputStreamSource getLogcat ()

Toma un flujo de instantáneas de los datos de logcat.

InputStreamSource getLogcat (int maxBytes)

Toma una secuencia de instantáneas de los últimos maxBytes de datos de logcat capturados.

InputStreamSource getLogcatDump ()

Obtenga un volcado del logcat actual para el dispositivo.

InputStreamSource getLogcatSince (long date)

Toma un flujo de instantáneas de los datos de logcat capturados a partir de la fecha proporcionada.

String getMacAddress ()

Devuelve la dirección MAC del dispositivo, nula si no se puede realizar la consulta desde el dispositivo.

Integer getMainUserId ()

Devuelve la identificación del usuario principal.

getMainlineModuleInfo ()

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

int getMaxNumberOfRunningUsersSupported ()

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

int getMaxNumberOfUsersSupported ()

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

Process getMicrodroidProcess ()
IDeviceStateMonitor getMonitor ()

Devuelve el IDeviceStateMonitor asociado con el dispositivo.

String getMountPoint (String mountName)

Devuelve un punto de montaje.

ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Devuelve un MountPointInfo correspondiente a la ruta del punto de montaje especificado, o null si esa ruta no tiene nada montado o no aparece en /proc/mounts como punto de montaje.

getMountPointInfo ()

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

TestDeviceOptions getOptions ()

Obtenga las opciones de prueba para el dispositivo.

long getPartitionFreeSpace (String partition)

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

Integer getPrimaryUserId ()

Devuelve la identificación del usuario principal.

ProcessInfo getProcessByName (String processName)

El método auxiliar ejecuta los comandos "pidof" y "stat" y devuelve el objeto ProcessInfo con PID y la hora de inicio del proceso dado.

String getProcessPid (String process)

Devuelve el pid del servicio o nulo si algo salió mal.

String getProductType ()

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

String getProductVariant ()

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

String getProperty (String name)

Recupere el valor de propiedad dado del dispositivo.

ITestDevice.RecoveryMode getRecoveryMode ()

Obtenga el modo de recuperación actual utilizado para el dispositivo.

InputStreamSource getScreenshot (String format)

Toma una captura de pantalla del dispositivo.

InputStreamSource getScreenshot (long displayId)

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

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 conveniente para obtener el número de serie de este dispositivo.

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

Devuelve el valor de la configuración solicitada.

String getSetting (String namespace, String key)

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

String getSimOperator ()

Devuelve la tarjeta SIM del operador o nula si no está disponible o si el dispositivo no está disponible.

String getSimState ()

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

getTombstones ()

Obtenga y devuelva la lista de lápidas 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 ()

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

boolean getUseFastbootErase ()

Obtenga información sobre si desea utilizar el borrado fastboot o el formato fastboot para borrar una partición del dispositivo.

int getUserFlags (int userId)

Encuentra y devuelve las banderas de un usuario determinado.

getUserInfos ()

Obtiene el mapa de useId a UserInfo en el dispositivo.

int getUserSerialNumber (int userId)

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

IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Procese el DeviceEvent dado.

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

boolean hasFeature (String feature)

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

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

Instale un paquete de Android en el dispositivo.

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

Instale un paquete de Android en el dispositivo.

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

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

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

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

void invalidatePropertyCache ()
boolean isAdbRoot ()

boolean isAdbTcp ()
boolean isAppEnumerationSupported ()

Compruebe si la plataforma del dispositivo admite la enumeración de aplicaciones

boolean isBypassLowTargetSdkBlockSupported ()

Verifique si la plataforma en el dispositivo permite omitir el bloqueo de SDK de destino bajo en las instalaciones de aplicaciones

boolean isDebugfsMounted ()

Compruebe si debugfs está montado.

boolean isDeviceEncrypted ()

Devuelve si el dispositivo está cifrado.

boolean isDirectory (String path)

Devuelve True si la ruta del dispositivo es un directorio; false en caso contrario.

boolean isEnableAdbRoot ()
boolean isEncryptionSupported ()

Devuelve si el cifrado es compatible con el dispositivo.

boolean isExecutable (String fullPath)

Devuelve True si la ruta del archivo en el dispositivo es un archivo ejecutable; false en caso contrario.

boolean isFastbootEnabled ()

Devuelve si fastboot está disponible para el dispositivo.

boolean isHeadless ()

Devuelve verdadero si el dispositivo no tiene cabeza (sin pantalla), falso en caso contrario.

boolean isHeadlessSystemUserMode ()

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

boolean isMainUserPermanentAdmin ()

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

boolean isMultiUserSupported ()

Determina si se admite multiusuario.

boolean isPackageInstalled (String packageName, String userId)

Consulte el dispositivo para obtener un nombre de paquete determinado y una identificación de usuario determinada para verificar si está actualmente instalado o no para ese usuario.

boolean isPackageInstalled (String packageName)

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

boolean isRuntimePermissionSupported ()

Compruebe si la plataforma del dispositivo admite la concesión de permisos en tiempo de ejecución

boolean isStateBootloaderOrFastbootd ()

Devuelve verdadero si el dispositivo está en TestDeviceState#FASTBOOT o TestDeviceState.FASTBOOTD .

boolean isUserRunning (int userId)

Compruebe si un usuario determinado se está ejecutando.

boolean isUserSecondary (int userId)

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

boolean isUserVisible (int userId)

Comprueba si el usuario dado es visible.

boolean isUserVisibleOnDisplay (int userId, int displayId)

Comprueba si el usuario dado es visible en la pantalla dada.

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

boolean isVisibleBackgroundUsersSupported ()

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

boolean isWifiEnabled ()

Pruebe si el wifi está habilitado.

listDisplayIds ()

Recopile la lista de ID de pantallas disponibles en el dispositivo según lo informado por "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)

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

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

Registre un mensaje en el logcat del dispositivo.

void mountDebugfs ()

Montar debugfs.

void nonBlockingReboot ()

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

void postAdbRootAction ()

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

void postAdbUnrootAction ()

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

void postBootSetup ()

Siga las instrucciones para configurar el dispositivo y probarlo después de cada arranque.

void postInvocationTearDown (Throwable exception)

Se requieren pasos adicionales para la limpieza específica del dispositivo que se ejecutarán una vez finalizada 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án en el dispositivo antes del flujo de invocación.

boolean pullDir (String deviceFilePath, File localDir)

Extraiga recursivamente el contenido del directorio del dispositivo.

boolean pullFile (String remoteFilePath, File localFile)

Recupera un archivo fuera del dispositivo.

File pullFile (String remoteFilePath, int userId)

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

File pullFile (String remoteFilePath)

Recupera un archivo del dispositivo, lo almacena en un ERROR(/File) temporal local y devuelve 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 devuelve el contenido.

File pullFileFromExternal (String remoteFilePath)

Un método conveniente para recuperar un archivo del almacenamiento externo del dispositivo, lo almacena en un ERROR(/File) temporal local y devuelve una referencia a ese File .

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

Envíe de forma recursiva el contenido del directorio al dispositivo y excluya algunos directorios que están filtrados.

boolean pushDir (File localFileDir, String deviceFilePath)

Empuje recursivamente el contenido del directorio al dispositivo.

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

Variante de pushFile(File, String) que opcionalmente puede considerar evaluar la necesidad del proveedor de contenido.

boolean pushFile (File localFile, String remoteFilePath)

Envíe un archivo al dispositivo.

boolean pushString (String contents, String remoteFilePath)

Enviar archivo creado a partir de una cadena al dispositivo

void reboot (String reason)

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

void reboot ()

Reinicia el dispositivo en modo adb.

void rebootIntoBootloader ()

Reinicia el dispositivo en modo gestor de arranque.

void rebootIntoFastbootd ()

Reinicia el dispositivo en modo fastbootd.

void rebootIntoRecovery ()

Reinicia el dispositivo en modo de recuperación adb.

void rebootIntoSideload ()

Reinicia el dispositivo en modo de carga lateral de adb (tenga en cuenta que este es un modo especial en recuperación)

Se bloquea hasta que el dispositivo ingresa al modo de carga lateral

void rebootIntoSideload (boolean autoReboot)

Reinicia el dispositivo en modo de carga lateral de adb (tenga en cuenta que este es un modo especial en recuperación)

Se bloquea hasta que el dispositivo ingresa al modo de carga lateral

void rebootUntilOnline ()

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

void rebootUntilOnline (String reason)

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

void rebootUserspace ()

Reinicia solo la parte del espacio de usuario del dispositivo.

void rebootUserspaceUntilOnline ()

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

boolean recoverDevice ()

Intenta recuperar la comunicación del dispositivo.

void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver para este dispositivo.

void remountSystemReadOnly ()

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

void remountSystemWritable ()

Haga que la partición del sistema en el dispositivo sea escribible.

void remountVendorReadOnly ()

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

void remountVendorWritable ()

Haga que la partición del proveedor en el dispositivo sea escribible.

boolean removeAdmin (String componentName, int userId)

Elimine el administrador del dispositivo determinado en un usuario determinado y devuelva true si tiene éxito, false en caso contrario.

void removeOwners ()

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

boolean removeUser (int userId)

Eliminar un usuario determinado del dispositivo.

void resetContentProviderSetup ()

Restablezca el indicador para la configuración del proveedor de contenido para activarlo nuevamente.

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

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

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

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

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

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

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

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

void setConfiguration ( IConfiguration configuration)

Inyecta la IConfiguration en uso.

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

Establece la fecha en el dispositivo

Nota: configurar la fecha en el dispositivo requiere root

boolean setDeviceOwner (String componentName, int userId)

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

void setDeviceState ( TestDeviceState deviceState)

Actualiza el estado del dispositivo.

void setEmulatorOutputStream ( SizeLimitedOutputStream output)

Para el emulador, configure SizeLimitedOutputStream para registrar la salida

void setEmulatorProcess (Process p)

Establece el Process , cuando este dispositivo es un emulador.

void setFastbootEnabled (boolean fastbootEnabled)

Configure la opción fastboot para el dispositivo.

void setFastbootPath (String fastbootPath)

Establece la ruta al binario fastboot que se debe utilizar.

void setIDevice (IDevice newDevice)

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

Configure TestDeviceOptions para el dispositivo

boolean setProperty (String propKey, String propValue)

Establece el valor de propiedad dado en el dispositivo.

void setRecovery ( IDeviceRecovery recovery)

Configure el IDeviceRecovery para usar en este dispositivo.

void setRecoveryMode ( ITestDevice.RecoveryMode mode)

Configure el modo de recuperación actual que se utilizará en el dispositivo.

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

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

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

Agregue un valor de configuración al espacio de nombres de un usuario determinado.

void setTestLogger ( ITestLogger testLogger)

Inyecta la instancia ITestLogger

void setUseFastbootErase (boolean useFastbootErase)

Establezca si desea utilizar el borrado fastboot o el formato fastboot para borrar una partición en el dispositivo.

void startLogcat ()

Comience a capturar la salida de Logcat desde el dispositivo en segundo plano.

boolean startUser (int userId)

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

boolean startUser (int userId, boolean waitFlag)

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

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

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

void stopEmulatorOutput ()

Cierre y elimine la salida del emulador.

void stopLogcat ()

Deje de capturar la salida de Logcat desde el dispositivo y descarte los datos de Logcat guardados actualmente.

boolean stopUser (int userId)

Detiene a un usuario determinado.

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

Detener a un usuario determinado.

String switchToAdbTcp ()

Cambie el dispositivo al modo adb-over-tcp.

boolean switchToAdbUsb ()

Cambie el dispositivo al modo adb sobre usb.

boolean switchUser (int userId)

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

boolean switchUser (int userId, long timeout)

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

boolean syncFiles (File localFileDir, String deviceFilePath)

Sincroniza incrementalmente el contenido de un directorio de archivos local con el dispositivo.

Bugreport takeBugreport ()

Tome un informe de error y lo devuelva dentro de un objeto Bugreport para manejarlo.

String uninstallPackage (String packageName)

Desinstale un paquete de Android del dispositivo.

String uninstallPackageForUser (String packageName, int userId)

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

boolean unlockDevice ()

Desbloquea el dispositivo si el dispositivo está en un estado cifrado.

void unmountDebugfs ()

Desmontar debugfs.

boolean waitForBootComplete (long timeOut)

Se bloquea hasta que se establece el indicador de inicio completo del dispositivo.

boolean waitForDeviceAvailable ()

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

boolean waitForDeviceAvailable (long waitTime)

Espera a que el dispositivo responda y esté disponible para realizar 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 a través de fastboot.

boolean waitForDeviceInRecovery (long waitTime)

Bloquea para que el dispositivo esté en el estado 'adb recovery' (tenga en cuenta que esto es distinto de IDeviceRecovery ).

boolean waitForDeviceInSideload (long waitTime)

Bloques para que el dispositivo esté en el estado 'adb sideload'

boolean waitForDeviceNotAvailable (long waitTime)

Bloques para que el dispositivo no esté disponible, es decir, que falte en adb

void waitForDeviceOnline ()

Se bloquea hasta que el dispositivo sea visible a través de adb.

void waitForDeviceOnline (long waitTime)

Se bloquea hasta que el dispositivo sea visible a través de adb.

boolean waitForDeviceShell (long waitTime)

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

Métodos protegidos

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

Crea el comando del sistema operativo para la sesión de comando de adb shell y los argumentos dados.

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

Cree una RebootDeviceAction para usarla al realizar una acción de reinicio.

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

Realice un reinicio de adb.

void ensureRuntimePermissionSupported ()

método auxiliar para lanzar una excepción si el permiso de tiempo de ejecución no es compatible

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

Obtenga la instancia RunUtil para usar.

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

Obtenga una propiedad del dispositivo, desde la caché ddmlib de forma predeterminada, y recurra a `adb shell getprop` o `fastboot getvar` dependiendo de si el dispositivo está en Fastboot o no.

boolean isInRebootCallback ()

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

boolean isNewer (File localFile, IFileEntry entry)

Devuelve true si el archivo local es más nuevo que el archivo remoto.

void notifyRebootEnded ()

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

void notifyRebootStarted ()

Notifica a todos 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.

void prePostBootSetup ()

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

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

Configure la instancia de reloj que se utilizará.

void setMicrodroidProcess (Process process)

Marca el TestDevice como microdroid y establece su CID.

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

Ejecuta un comando fastboot simple con variables de entorno e informa el estado del comando.

CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)

Ejecuta un comando fastboot simple e informa el estado del comando.

boolean waitForDeviceNotAvailable (String operationDesc, long time)

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

Constantes

ID DE USUARIO INVALIDO

public static final int INVALID_USER_ID

Valor devuelto para cualquier identificación de usuario no válida o no encontrada: 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: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

el número predeterminado de intentos de reintento de comando para realizar

Valor constante: 2 (0x00000002)

Campos

DEBUGFS_PATH

public static final String DEBUGFS_PATH

TARJETA SD

protected static final String SD_CARD

ALMACENAMIENTO_EMULADO

protected static final String STORAGE_EMULATED

mOpciones

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 : el IDevice asociado

stateMonitor IDeviceStateMonitor : el mecanismo IDeviceStateMonitor a utilizar

allocationMonitor IDeviceMonitor : el IDeviceMonitor para informar de los cambios en el estado de asignación. Puede ser nulo

Métodos públicos

lotePrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Microoptimización (alrededor de 400 milisegundos) al obtener previamente todos los accesorios que necesitamos en lugar de llamar 'adb getprop' para cada uno. es decir, es tan rápido recuperar todas las propiedades como recuperar una. Cosas como device.getApiLevel(), checkApiLevelAgainstNextRelease y getBuildAlias ​​llaman a `adb getprop` bajo el capó. 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 futuras llamadas. Lo estamos haciendo un poco antes. Si el dispositivo está en recuperación o hay otros errores al buscar los accesorios, simplemente los ignoramos.

puede cambiar a usuario del sistema sin cabeza

public boolean canSwitchToHeadlessSystemUser ()

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

Devoluciones
boolean

Lanza
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Compruebe si una característica es actualmente compatible con un nivel mínimo de compatibilidad. Este método tiene en cuenta funciones inéditas aún, antes de que se eleve el nivel de API.

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

Devoluciones
boolean Verdadero si el nivel es compatible. Falso en caso contrario.

Lanza
DeviceNotAvailableException

checkConectividad

public boolean checkConnectivity ()

Verifique que el dispositivo tenga conectividad de red.

Devoluciones
boolean true si el dispositivo tiene una conexión de red que funciona; false en caso contrario.

Lanza
DeviceNotAvailableException

clearErrorDiálogos

public boolean clearErrorDialogs ()

Intente descartar cualquier cuadro de diálogo de error que se muestre actualmente en la interfaz de usuario del dispositivo.

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

Lanza
DeviceNotAvailableException

borrarÚltimoConectadoRedWifi

public void clearLastConnectedWifiNetwork ()

Borra la última red wifi conectada. Esto debe llamarse al iniciar una nueva invocación para evitar conectarse a la red wifi utilizada en la prueba anterior después de reiniciar el dispositivo.

borrarLogcat

public void clearLogcat ()

Elimina cualquier dato de logcat acumulado.

Esto es útil para los casos en los que desea asegurarse de que ITestDevice#getLogcat() solo devuelva datos de registro producidos después de un cierto punto (como después de actualizar la compilación de un nuevo dispositivo, etc.).

conectarse a la red wifi

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se conecta a una red wifi.

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

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

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

Devoluciones
boolean true si se conecta correctamente a la red wifi. false en caso contrario

Lanza
DeviceNotAvailableException

conectarse a la red wifi

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se conecta a una red wifi.

Enciende wifi y bloquea hasta que se realiza una conexión exitosa a la red wifi especificada. Una vez que se establece una conexión, la instancia intentará restaurar la conexión después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

Parámetros
wifiSsid String : el ssid wifi al que conectarse

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

Devoluciones
boolean true si se conecta correctamente a la red wifi. false en caso contrario

Lanza
DeviceNotAvailableException

conectarse a la red wifi

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Se conecta a una red wifi.

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

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

Devoluciones
boolean true si se conecta correctamente a la red wifi. false en caso contrario

Lanza
DeviceNotAvailableException

conectarse a la red wifi

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

Se conecta a una red wifi.

Enciende wifi y bloquea hasta que se realiza una conexión exitosa a la red wifi especificada. Una vez que se establece una conexión, la instancia intentará restaurar la conexión después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

Parámetros
wifiSsid String : el ssid wifi al que conectarse

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

scanSsid boolean : si se debe buscar SSID oculto para esta red.

Devoluciones
boolean true si se conecta correctamente a la red wifi. false en caso contrario

Lanza
DeviceNotAvailableException

conectarse a la red Wifi si es necesario

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

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

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

Devoluciones
boolean true si se conecta correctamente a la red wifi. false en caso contrario

Lanza
DeviceNotAvailableException

conectarse a la red Wifi si es necesario

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Devoluciones
boolean true si se conecta correctamente a la red wifi. false en caso contrario

Lanza
DeviceNotAvailableException

crear usuario

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

Cree un usuario con un nombre de pila y las banderas proporcionadas

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

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

ephemeral boolean : habilita la bandera de usuario --efímera durante la creación

Devoluciones
int ID del usuario creado.

Lanza
DeviceNotAvailableException

crear usuario

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

Cree un usuario con un nombre de pila y las banderas proporcionadas

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

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

ephemeral boolean : habilita la bandera de usuario --efímera durante la creación

forTesting boolean : habilita el indicador de prueba --for-testing durante la creación

Devoluciones
int ID del usuario creado.

Lanza
DeviceNotAvailableException

crear usuario

public int createUser (String name)

Cree un usuario con un nombre de pila y banderas predeterminadas 0.

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

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

Lanza
DeviceNotAvailableException

crearUsuarioNoThrow

public int createUserNoThrow (String name)

Cree un usuario con un nombre de pila y banderas predeterminadas 0.

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

Devoluciones
int el número entero para la identificación de usuario creada o -1 para el error.

Lanza
DeviceNotAvailableException

borrar archivo

public void deleteFile (String deviceFilePath)

Método auxiliar para eliminar un archivo o directorio en el dispositivo.

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

Lanza
DeviceNotAvailableException

cancelar el registroDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Elimina el IDeviceActionReceiver registrado.

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

dispositivoSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Método auxiliar para verificar si el dispositivo se reinició suavemente comparando el system_server actual con el system_server ProcessInfo anterior. Utilice getProcessByName(String) para obtener ProcessInfo .

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

Devoluciones
boolean true si el dispositivo se reinicia suavemente

Lanza
DeviceNotAvailableException

dispositivoSoftRestartedDesde

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Método auxiliar para verificar si el dispositivo se reinició suavemente desde la hora UTC desde la época del dispositivo y su ERROR(/TimeUnit) . El reinicio suave se refiere al servidor_sistema reiniciado fuera de un reinicio completo del dispositivo (por ejemplo: reinicio solicitado). El dispositivo actual utcEpochTime en Milliseccond se puede obtener mediante el método getDeviceDate() .

Parámetros
utcEpochTime long : el tiempo del dispositivo en segundos desde la época.

timeUnit TimeUnit : la unidad de tiempo TimeUnit para el utcEpochTime dado.

Devoluciones
boolean true si el dispositivo se reinicia suavemente

Lanza
DeviceNotAvailableException

desactivarAdbRoot

public boolean disableAdbRoot ()

Desactiva la raíz de adb.

Deshabilitar adb root puede hacer que el dispositivo se desconecte de adb. Este método se bloqueará hasta que el dispositivo esté disponible.

Devoluciones
boolean true si tiene éxito.

Lanza
DeviceNotAvailableException

desactivar Keyguard

public void disableKeyguard ()

Intenta desactivar el bloqueo de teclas.

Primero espere a que el envío de entrada esté listo; esto sucede aproximadamente al mismo tiempo que el dispositivo informa BOOT_COMPLETE, aparentemente de forma asincrónica, porque la implementación actual del marco tiene condiciones de carrera ocasionales. Luego se envía el comando para descartar el bloqueo de teclas (sólo funciona en los no seguros)

Lanza
DeviceNotAvailableException

desactivarNetworkMonitor

public boolean disableNetworkMonitor ()

Desactiva el monitoreo de red en el dispositivo.

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

Lanza
DeviceNotAvailableException

desconectarse de Wifi

public boolean disconnectFromWifi ()

Se desconecta de una red wifi.

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

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

Lanza
DeviceNotAvailableException

¿Existe el archivo?

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

userId int : la identificación de usuario con la que verificar la existencia del archivo.

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

Lanza
DeviceNotAvailableException

¿Existe el archivo?

public boolean doesFileExist (String deviceFilePath)

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

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

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

Lanza
DeviceNotAvailableException

montón de volcado

public File dumpHeap (String process, 
                String devicePath)

Intente volcar el montón del system_server. Es responsabilidad de la persona que llama limpiar el archivo volcado.

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

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

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

Lanza
DeviceNotAvailableException

habilitarAdbRoot

public boolean enableAdbRoot ()

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

Habilitar adb root puede hacer que el dispositivo se desconecte de adb. Este método se bloqueará hasta que el dispositivo esté disponible.

Devoluciones
boolean true si tiene éxito.

Lanza
DeviceNotAvailableException

habilitarNetworkMonitor

public boolean enableNetworkMonitor ()

Habilita el monitoreo de red en el dispositivo.

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

Lanza
DeviceNotAvailableException

ejecutarAdbCommand

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

Método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera específico.

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

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

cmdArgs String : el comando adb y los argumentos para ejecutar

Devoluciones
String la salida estándar del comando. null si el comando no se pudo ejecutar.

Lanza
DeviceNotAvailableException

ejecutarAdbCommand

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

Método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera específico.

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

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

envMap : entorno a configurar para el comando

cmdArgs String : el comando adb y los argumentos para ejecutar

Devoluciones
String la salida estándar del comando. null si el comando no se pudo ejecutar.

Lanza
DeviceNotAvailableException

ejecutarAdbCommand

public String executeAdbCommand (String... cmdArgs)

Método auxiliar que ejecuta un comando adb como comando del sistema.

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

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

Devoluciones
String la salida estándar del comando. null si el comando no se pudo ejecutar.

Lanza
DeviceNotAvailableException

ejecutar FastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

Se espera que se utilice cuando el dispositivo ya esté en modo fastboot.

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

Devoluciones
CommandResult el CommandResult que contiene la salida del comando

Lanza
DeviceNotAvailableException

ejecutar FastbootCommand

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

Método auxiliar que ejecuta un comando fastboot como comando del sistema.

Se espera que se utilice cuando el dispositivo ya esté en modo fastboot.

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

cmdArgs String : el comando fastboot y los argumentos para ejecutar

Devoluciones
CommandResult el CommandResult que contiene la salida del comando

Lanza
DeviceNotAvailableException

ejecutar LongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

Devoluciones
CommandResult el CommandResult que contiene la salida del comando

Lanza
DeviceNotAvailableException

ejecutar LongFastbootCommand

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 : Las variables de entorno del sistema con las que se ejecuta el comando FastBoot se ejecuta

cmdArgs String : el comando y argumentos fastboot para ejecutar

Devoluciones
CommandResult El comandante que contiene la salida del comando

Lanza
DeviceNotAvailableException

EXECHESHELLCOMMAND

public String executeShellCommand (String command)

Método auxiliar que ejecuta un comando ADB Shell y devuelve la salida como una String .

Parámetros
command String : el comando de shell adb para ejecutar

Devoluciones
String la salida de shell

Lanza
DeviceNotAvailableException

EXECHESHELLCOMMAND

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

Ejecuta un comando ADB Shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
command String : el comando de shell adb para ejecutar

receiver IShellOutputReceiver : el IShellOutputReceiver para dirigir la salida de shell a.

maxTimeToOutputShellResponse long : la cantidad máxima de tiempo durante el cual se permite que el comando no genere ninguna respuesta; Unidad como se especifica en timeUnit

timeUnit TimeUnit : Unidad para maxTimeToOutputShellResponse

retryAttempts int : El número máximo de veces para volver al comando si falla debido a una excepción. DevicenotresponsiveException se arrojará si retryAttempts se realizan sin éxito.

Lanza
DeviceNotAvailableException

EXECHESHELLCOMMAND

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

Ejecuta un comando ADB Shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
command String : el comando de shell adb para ejecutar

receiver IShellOutputReceiver : el IShellOutputReceiver para dirigir la salida de shell a.

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

maxTimeToOutputShellResponse long : la cantidad máxima de tiempo durante el cual se permite que el comando no genere ninguna respuesta; Unidad como se especifica en timeUnit

timeUnit TimeUnit : Unidad para maxTimeToOutputShellResponse

retryAttempts int : El número máximo de veces para volver al comando si falla debido a una excepción. DevicenotresponsiveException se arrojará si retryAttempts se realizan sin éxito.

Lanza
DeviceNotAvailableException

EXECHESHELLCOMMAND

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Ejecuta el comando dado adb shell, vuelve a intentar 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 : el comando de shell adb para ejecutar

receiver IShellOutputReceiver : el IShellOutputReceiver para dirigir la salida de shell a.

Lanza
DeviceNotAvailableException

EXECTHELLV2COMMAND

public CommandResult executeShellV2Command (String cmd)

Método auxiliar que ejecuta un comando ADB Shell y devuelve los resultados como un CommandResult se pobló correctamente con la salida de estado del comando, STDOUT y STDERR.

Parámetros
cmd String : el comando que debe ejecutarse.

Devoluciones
CommandResult El resultado en CommandResult .

Lanza
DeviceNotAvailableException

EXECTHELLV2COMMAND

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Método auxiliar que ejecuta un comando ADB Shell y devuelve los resultados como un CommandResult se pobló correctamente con la salida de estado del comando y Stderr. Stdout está dirigido a la corriente especificada.

Parámetros
cmd String : el comando que debe ejecutarse.

pipeToOutput OutputStream : ERROR(/OutputStream) donde se redirigirá la salida STD o nula.

Devoluciones
CommandResult El resultado en CommandResult .

Lanza
DeviceNotAvailableException

EXECTHELLV2COMMAND

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Método auxiliar que ejecuta un comando ADB Shell y devuelve los resultados como un CommandResult se pobló correctamente con la salida de estado del comando, STDOUT y STDERR.

Parámetros
cmd String : el comando que debe ejecutarse.

pipeAsInput File : un ERROR(/File) que se canalizará como entrada al comando o nulo.

Devoluciones
CommandResult El resultado en CommandResult .

Lanza
DeviceNotAvailableException

EXECTHELLV2COMMAND

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

Ejecuta un comando ADB Shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
cmd String : el comando de shell adb para ejecutar

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

timeUnit TimeUnit : Unidad para maxTimeToOutputShellResponse

retryAttempts int : El número máximo de veces para volver al comando si falla debido a una excepción. DevicenotresponsiveException se arrojará si retryAttempts se realizan sin éxito.

Devoluciones
CommandResult

Lanza
DeviceNotAvailableException

EXECTHELLV2COMMAND

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

Ejecuta un comando ADB Shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
cmd String : el comando de shell adb para ejecutar

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

timeUnit TimeUnit : Unidad para maxTimeToOutputShellResponse

Devoluciones
CommandResult

Lanza
DeviceNotAvailableException

EXECTHELLV2COMMAND

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

Ejecuta un comando ADB Shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
cmd String : el comando de shell adb para ejecutar

pipeAsInput File : un ERROR(/File) que se canalizará como entrada al comando o nulo.

pipeToOutput OutputStream : ERROR(/OutputStream) donde se redirigirá la salida STD o nula.

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

timeUnit TimeUnit : Unidad para maxTimeToOutputShellResponse

retryAttempts int : El número máximo de veces para volver al comando si falla debido a una excepción. DevicenotresponsiveException se arrojará si retryAttempts se realizan sin éxito.

Devoluciones
CommandResult

Lanza
DeviceNotAvailableException

EXECTHELLV2COMMAND

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

Ejecuta un comando ADB Shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
cmd String : el comando de shell adb para ejecutar

pipeAsInput File : un ERROR(/File) que se canalizará como entrada al comando o nulo.

pipeToOutput OutputStream : ERROR(/OutputStream) donde se redirigirá la salida STD o nula.

pipeToError OutputStream : ERROR(/OutputStream) donde se redirigirá el error STD o nulo.

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

timeUnit TimeUnit : Unidad para maxTimeToOutputShellResponse

retryAttempts int : El número máximo de veces para volver al comando si falla debido a una excepción. DevicenotresponsiveException se arrojará si retryAttempts se realizan sin éxito.

Devoluciones
CommandResult

Lanza
DeviceNotAvailableException

FastBootWipePartition

public CommandResult fastbootWipePartition (String partition)

Método auxiliar que limpia una partición para el dispositivo.

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

Se espera que se use cuando el dispositivo ya está en modo FastBoot.

Parámetros
partition String : la partición para borrar

Devoluciones
CommandResult El comandante que contiene la salida del comando

Lanza
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

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

Lanza
DeviceNotAvailableException

getallsettings

public  getAllSettings (String namespace)

Devuelve los pares de valor clave del espacio de nombres solicitado.

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

Devoluciones
El mapa de pares de valor clave. Nulo si el espacio de nombres no es compatible.

Lanza
DeviceNotAvailableException

GetAllocationState

public DeviceAllocationState getAllocationState ()

Devolver el estado de asignación actual del dispositivo

Devoluciones
DeviceAllocationState

getandroidid

public String getAndroidId (int userId)

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

Parámetros
userId int

Devoluciones
String

Lanza
DeviceNotAvailableException

getAdroidids

public  getAndroidIds ()

Cree un mapa de ID de Android encontrados ID de usuario coincidentes. No hay seguro que cada ID de usuario encontre una ID de Android asociada en esta función, por lo que algunas ID de usuario pueden coincidir con NULL.

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

Lanza
DeviceNotAvailableException

getapilevel

public int getApiLevel ()

Obtenga el nivel de API del dispositivo. El valor predeterminado a UNKNOWN_API_LEVEL .

Devoluciones
int un entero que indica el nivel API del dispositivo

Lanza
DeviceNotAvailableException

getApppackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

Parámetros
packageName String

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

Lanza
DeviceNotAvailableException

getApppackageInfos

public  getAppPackageInfos ()

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

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

Lanza
DeviceNotAvailableException

getBaseBandversion

public String getBasebandVersion ()

Método de conveniencia para obtener la versión de banda base (radio) de este dispositivo. Obtener la versión de radio es específica del dispositivo, por lo que es posible que no devuelva la información correcta para todos los dispositivos. Este método se basa en la propiedad de la base de gsm.version.base para devolver la información de la versión correcta. Esto no es exacto para algunos dispositivos CDMA y la versión devuelta aquí podría no coincidir con la versión informada desde FastBoot y podría no devolver la versión para la radio CDMA. TL; DR Este método solo informa una versión precisa si la propiedad GSM.version.BaseBand es la misma que la versión devuelta por fastboot getvar version-baseband .

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

Lanza
DeviceNotAvailableException

GetBattery

public Integer getBattery ()

Devuelve el nivel actual de la batería de un dispositivo o nulo si el nivel de la batería no está disponible.

Devoluciones
Integer

GetBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Devuelve el valor booleano de la propiedad dada.

Parámetros
name String : el nombre de la propiedad

defaultValue boolean : valor predeterminado para devolver si la propiedad está vacía o no existe.

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

Lanza
DeviceNotAvailableException

GetBoothistory

public  getBootHistory ()

El método Helper recopila el mapa del historial de arranque con tiempo de arranque y razón de arranque.

Devoluciones
Mapa del tiempo de arranque (tiempo de UTC en segundo lugar desde la época) y la razón del arranque

Lanza
DeviceNotAvailableException

GetBoothistorysince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

El método Helper recopila el mapa del historial de arranque con tiempo de arranque y razón de arranque desde el tiempo dado desde la época desde el dispositivo y la unidad de tiempo especificada. El dispositivo actual UtCepochtime en milisegundo se puede obtener mediante el método getDeviceDate() .

Parámetros
utcEpochTime long : el tiempo del dispositivo desde la época.

timeUnit TimeUnit : la unidad de tiempo TimeUnit .

Devoluciones
Mapa del tiempo de arranque (tiempo de UTC en segundo lugar desde la época) y la razón del arranque

Lanza
DeviceNotAvailableException

getBootloaderversion

public String getBootloaderVersion ()

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

Intentará recuperar la versión del cargador de arranque del estado actual del dispositivo. (es decir, si el dispositivo está en modo FastBoot, intentará recuperar la versión de FastBoot)

Devoluciones
String la versión String bootloader o null si no se puede encontrar

Lanza
DeviceNotAvailableException

getBuGreport

public InputStreamSource getBugreport ()

Recupera un bugreport del dispositivo.

Se garantiza que la implementación de esto continúa funcionando en un dispositivo sin una tarjeta SD (o donde la tarjeta SD aún no está montada).

Devoluciones
InputStreamSource Un InputStreamSource que producirá el contenido de Bugreport a pedido. En el caso de la falla, InputStreamSource producirá un ERROR(/InputStream) .

getBuGreportz

public InputStreamSource getBugreportz ()

Recupera un bufreportz del dispositivo. El formato ZIP BuGreport contiene el principal bugreport y otros archivos de registro que son útiles para la depuración.

Solo admitido para 'Versión ADB'> 1.0.36

Devoluciones
InputStreamSource Un InputStreamSource del archivo ZIP que contiene el Bugreportz, return NULL en caso de falla.

GetBuildalias

public String getBuildAlias ()

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

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

Devoluciones
String el alias de construcción o volver a la identificación de construcción si no se pudiera recuperar

Lanza
DeviceNotAvailableException

GetBuildFlear

public String getBuildFlavor ()

Recupere el sabor de compilación para el dispositivo.

Devoluciones
String el sabor de construcción o nulo si no se pudiera recuperar

Lanza
DeviceNotAvailableException

GetBuildid

public String getBuildId ()

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

Devoluciones
String la identificación de compilación o IBuildInfo#UNKNOWN_BUILD_ID si no se pudiera recuperar

Lanza
DeviceNotAvailableException

GetBuildSigningKeys

public String getBuildSigningKeys ()

Devuelve el tipo de tecla utilizado para firmar la imagen del dispositivo

Por lo general, los dispositivos de Android se pueden firmar con teclas de prueba (como en AOSP) o llaves de liberación (controlados por fabricantes de dispositivos individuales)

Devoluciones
String La clave de firma si se encuentra, nula de lo contrario.

Lanza
DeviceNotAvailableException

getCachedDeviceScriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

Devuelve un DeviceDescriptor en caché si se asigna el dispositivo, de lo contrario devuelve el DeviceDescriptor actual.

Devoluciones
DeviceDescriptor

getCachedDeviceScriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Devuelve un DeviceDescriptor en caché si se asigna el dispositivo, de lo contrario devuelve el DeviceDescriptor actual.

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

Devoluciones
DeviceDescriptor

obtener niños

public String[] getChildren (String path)

Alternativa al uso IFileEntry que a veces no funcionará debido a los permisos.

Parámetros
path String : ¿está la ruta en el dispositivo donde hacer la búsqueda?

Devoluciones
String[] Matriz de cadena que contiene todo el archivo en una ruta en el dispositivo.

Lanza
DeviceNotAvailableException

obtener conexión

public AbstractConnection getConnection ()

La conexión actual asociada con el dispositivo.

Devoluciones
AbstractConnection

GetCurrentFoldeableSestate

public DeviceFoldableState getCurrentFoldableState ()

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

Devoluciones
DeviceFoldableState

Lanza
DeviceNotAvailableException

getCurrentuser

public int getCurrentUser ()

Devuelva la ID del usuario en ejecución actual. En caso de error, return -10000.

Devoluciones
int

Lanza
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

Obtenga la clase del dispositivo.

Devoluciones
String La clase de dispositivo String .

GetDevictado

public long getDeviceDate ()

Devuelva la fecha del dispositivo en milisegundo desde la época.

Devoluciones
long La fecha del dispositivo en formato de época.

Lanza
DeviceNotAvailableException

GetDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

Devuelva un DeviceDescriptor de la información del dispositivo para obtener información al respecto sin pasar el objeto de dispositivo real.

Devoluciones
DeviceDescriptor

GetDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Devuelva un DeviceDescriptor de la información del dispositivo para obtener información al respecto sin pasar el objeto de dispositivo real.

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

Devoluciones
DeviceDescriptor

getDevicestate

public TestDeviceState getDeviceState ()

Obtenga el estado del dispositivo.

Devoluciones
TestDeviceState

getDevicetimeOffset

public long getDeviceTimeOffset (Date date)

Ayudante para obtener la diferencia de tiempo entre el dispositivo y un ERROR(/Date) . Use el tiempo de época internamente.

Parámetros
date Date

Devoluciones
long la diferencia en milisegundos

Lanza
DeviceNotAvailableException

getemulatorOutput

public InputStreamSource getEmulatorOutput ()

Obtenga la corriente de emulador stdout y stderr

Devoluciones
InputStreamSource salida del emulador

GetEmulatorProcess

public Process getEmulatorProcess ()

Devuelva el Process correspondiente a este emulador.

Devoluciones
Process el Process o null

getExecuteshellCommandlog

public final File getExecuteShellCommandLog ()

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

Devoluciones
File

getExternalStoreFreespace

public long getExternalStoreFreeSpace ()

Método auxiliar para determinar la cantidad de espacio libre en el almacenamiento externo del dispositivo.

Devoluciones
long la cantidad de espacio libre en KB

Lanza
DeviceNotAvailableException

Getfastbootpath

public String getFastbootPath ()

Devuelve el camino del fastboot binario que se está utilizando. Todavía requiere que isFastbootEnabled() sea verdadero, para tener funciones de FastBoot habilitadas.

Devoluciones
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. Es una variante un poco más segura que el método genérico getProductType() en este caso, porque ItestDevice sabrá recuperar el dispositivo en FastBoot si el dispositivo está en estado incorrecto o no responde.

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

Lanza
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. Es una variante un poco más segura que el método genérico getProductType() en este caso, porque ItestDevice sabrá recuperar el dispositivo en FastBoot si el dispositivo está en estado incorrecto o no responde.

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

Lanza
DeviceNotAvailableException

GetFastbootserialNumber

public String getFastbootSerialNumber ()

Devuelve el número de serie del modo FastBoot.

Devoluciones
String

GetFastBootVariable

public String getFastbootVariable (String variableName)

Recupere el valor variable FastBoot dado del dispositivo.

Parámetros
variableName String : el nombre de la variable

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

Lanza
DeviceNotAvailableException

GetFastbootversion

public String getFastbootVersion ()

Devuelve la cadena de versión del fastboot binario que se está utilizando. O nulo si algo sale mal.

Devoluciones
String

getFileEntry

public IFileEntry getFileEntry (String path)

Recupere una referencia a un archivo remoto en el dispositivo.

Parámetros
path String : la ruta del archivo para recuperar. Puede ser una ruta o ruta absoluta en relación con '/'. (es decir, se admite la sintaxis "/sistema" y "sistema")

Devoluciones
IFileEntry el IFileEntry o null si no se puede encontrar el archivo en path dada

Lanza
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Ayudante no oficial para obtener un FileEntry de una ruta no raíz. FixMe: Refactor del sistema FileEntry para que esté disponible desde cualquier ruta. (incluso no raíz).

Parámetros
entry FileListingService.FileEntry : un FileEntry no necesariamente root como lo requiere DDMLIB.

Devoluciones
IFileEntry Un FileEntryWrapper que representa el FileEntry.

Lanza
com.android.tradefed.device.devicenotavailableException
DeviceNotAvailableException

GetFoldeBlestates

public  getFoldableStates ()

Devuelve la lista de estados plegables en el dispositivo. Se puede obtener con "CMD Device_State Print-State".

Devoluciones

Lanza
DeviceNotAvailableException

GetEdevice

public IDevice getIDevice ()

Devuelve una referencia al IDevice 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, las personas que llaman no deben mantener una referencia al IDevice , porque esa referencia puede volverse obsoleta.

Devoluciones
IDevice el IDevice

GetInstalledPackagenames

public  getInstalledPackageNames ()

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

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

Lanza
DeviceNotAvailableException

GetintProperty

public long getIntProperty (String name, 
                long defaultValue)

Devuelve el valor entero de la propiedad dada del dispositivo.

Parámetros
name String : el nombre de la propiedad

defaultValue long : valor predeterminado para devolver si la propiedad está vacía o no existe.

Devoluciones
long El valor de la propiedad o defaultValue si la propiedad está vacía, no existe o no tiene un valor entero.

Lanza
DeviceNotAvailableException

getipaddress

public String getIpAddress ()

Obtiene la dirección IP del dispositivo.

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

Lanza
DeviceNotAvailableException

GetKeyGuardState

public KeyguardControllerState getKeyguardState ()

Devuelva un objeto para obtener el estado actual del KeyGuard o NULL si no es compatible.

Devoluciones
KeyguardControllerState Un KeyguardControllerState que contiene una instantánea del estado del KeyGuard y devuelve NULL si la consulta KeyGuard no es compatible.

Lanza
DeviceNotAvailableException

getLastEspedreBoottimemillis

public long getLastExpectedRebootTimeMillis ()

Devuelve la última vez que TradeFed API provocó un reinicio en milisegundos desde la época como devuelve System.currentTimeMillis() .

Devoluciones
long

getLaunchApileVel

public int getLaunchApiLevel ()

Obtenga el primer nivel API lanzado del dispositivo. El valor predeterminado a UNKNOWN_API_LEVEL .

Devoluciones
int un entero que indica el primer nivel de dispositivo API lanzado

Lanza
DeviceNotAvailableException

getLogcat

public InputStreamSource getLogcat ()

Tome un flujo de instantánea de los datos de logCat.

Funciona en dos modos:

  • Si el logCat se captura actualmente en segundo plano, volverá a TestDeviceOptions.getMaxLogcatDataSize() bytes del contenido actual de la captura de logcat de fondo
  • De lo contrario, devolverá un volcado estático de los datos de logCat si el dispositivo está respondiendo actualmente

    Devoluciones
    InputStreamSource

  • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

    Toma una secuencia de instantáneas del último maxBytes de datos de logcat capturados.

    Útil para los casos en que desea capturar instantáneas frecuentes de los datos de logcat capturados sin incurrir en la penalización de espacio de disco potencialmente grande de obtener toda la instantánea getLogcat() .

    Parámetros
    maxBytes int : La cantidad máxima de datos para devolver. Debe ser una cantidad que pueda encajar cómodamente en la memoria

    Devoluciones
    InputStreamSource

    getLogcatdump

    public InputStreamSource getLogcatDump ()

    Obtenga un volcado del logCat actual para el dispositivo. A diferencia de getLogcat() , este método siempre devolverá un volcado estático del logCat.

    Tiene la desventaja de que no se devolverá nada si el dispositivo no es accesible.

    Devoluciones
    InputStreamSource Un InputStreamSource de los datos de LogCat. Se devuelve una transmisión vacía si no capturan los datos de LogCat.

    GetLogCatsince

    public InputStreamSource getLogcatSince (long date)

    Tome un flujo de instantánea de datos de LogCat capturados que comienzan la fecha proporcionada. El tiempo en el dispositivo debe usarse getDeviceDate() .

    Parámetros
    date long : en milisegundo desde el formato de época de cuándo comenzar la instantánea en el presente. (se puede obtener usando 'date +%s')

    Devoluciones
    InputStreamSource

    obtener dirección Mac

    public String getMacAddress ()

    Devuelve la dirección MAC del dispositivo, NULL si no puede consultar desde el dispositivo.

    Devoluciones
    String

    GetMainuserid

    public Integer getMainUserId ()

    Devuelve la ID de usuario principal.

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

    Lanza
    DeviceNotAvailableException

    GetMainLineModuleInfo

    public  getMainlineModuleInfo ()

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

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

    Lanza
    DeviceNotAvailableException

    GetMaxNumberOfrunningUssSupported

    public int getMaxNumberOfRunningUsersSupported ()

    Obtenga el número máximo de usuarios de ejecución simultáneos compatibles. El valor predeterminado es 0.

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

    Lanza
    DeviceNotAvailableException

    GetMaxNumberOfUssSupported

    public int getMaxNumberOfUsersSupported ()

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

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

    Lanza
    DeviceNotAvailableException

    getMicrodroidProcess

    public Process getMicrodroidProcess ()

    Devoluciones
    Process Devuelve el proceso de la VM de MicroDroid. Si TestDevice no es un MicroDroid, devuelve nulo.

    getMonitor

    public IDeviceStateMonitor getMonitor ()

    Devuelve el IDeviceStateMonitor asociado con el dispositivo.

    Devoluciones
    IDeviceStateMonitor

    GetMountpoint

    public String getMountPoint (String mountName)

    Devuelve un punto de montaje.

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

    TODO: Mueva este comportamiento a IDevice#getMountPoint(String)

    Parámetros
    mountName String : el nombre del punto de montaje

    Devoluciones
    String el punto de montaje o null

    GetMountPointInfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Devuelve un MountPointInfo correspondiente a la ruta de punto de montaje especificada, o null si esa ruta no tiene nada montado o de otra manera no aparece en /Proc /Mounts como un punto de montaje.

    Parámetros
    mountpoint String

    Devoluciones
    ITestDevice.MountPointInfo Un ERROR(/List) de MountPointInfo que contiene la información en "/proc/montes"

    Lanza
    DeviceNotAvailableException

    GetMountPointInfo

    public  getMountPointInfo ()

    Devuelve una versión analizada de la información en /proc /se monta en el dispositivo

    Devoluciones
    Un ERROR(/List) de MountPointInfo que contiene la información en "/proc/montes"

    Lanza
    DeviceNotAvailableException

    obtener Opciones

    public TestDeviceOptions getOptions ()

    Obtenga las opciones de prueba para el dispositivo.

    Devoluciones
    TestDeviceOptions TestDeviceOptions relacionados con el dispositivo bajo prueba.

    getPartitionFreespace

    public long getPartitionFreeSpace (String partition)

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

    Parámetros
    partition String

    Devoluciones
    long la cantidad de espacio libre en KB

    Lanza
    DeviceNotAvailableException

    getPrimaryUserid

    public Integer getPrimaryUserId ()

    Devuelve la ID de usuario principal.

    Devoluciones
    Integer El ID de usuario del usuario primario si hay uno y nulo si no hay usuario primario.

    Lanza
    DeviceNotAvailableException

    GetProcessByName

    public ProcessInfo getProcessByName (String processName)

    El método Helper ejecuta el comando "Pidof" y "STAT" y devuelve el objeto ProcessInfo con PID y la hora de inicio del proceso del proceso dado.

    Parámetros
    processName String : la cadena de nombre de proces.

    Devoluciones
    ProcessInfo ProcessInfo de ProcessName dado

    Lanza
    DeviceNotAvailableException

    GetProcesspid

    public String getProcessPid (String process)

    Devuelve el PID del servicio o nulo si algo salió mal.

    Parámetros
    process String : la cadena de nombre de proces.

    Devoluciones
    String

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

    Devoluciones
    String El nombre del tipo de producto String . No será nulo

    Lanza
    DeviceNotAvailableException

    GetProductVariant

    public String getProductVariant ()

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

    Este método funcionará si el dispositivo está en modo ADB o FastBoot.

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

    Lanza
    DeviceNotAvailableException

    obtener propiedad

    public String getProperty (String name)

    Recupere el valor de la propiedad dado del dispositivo.

    Parámetros
    name String : el nombre de la propiedad

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

    Lanza
    DeviceNotAvailableException

    getRecoverymode

    public ITestDevice.RecoveryMode getRecoveryMode ()

    Obtenga el modo de recuperación actual utilizado para el dispositivo.

    Devoluciones
    ITestDevice.RecoveryMode El modo de recuperación actual utilizado para el dispositivo.

    obtener captura de pantalla

    public InputStreamSource getScreenshot (String format)

    Agarra una captura de pantalla del dispositivo. Recomendado para usar GetScreensHot (formato) en su lugar con la codificación JPEG para un tamaño más pequeño

    Parámetros
    format String : PNG compatible, JPEG

    Devoluciones
    InputStreamSource Un InputStreamSource de la captura de pantalla en formato, o null si la captura de pantalla no tuvo éxito.

    Lanza
    DeviceNotAvailableException

    obtener captura de pantalla

    public InputStreamSource getScreenshot (long displayId)

    Tome una captura de pantalla del dispositivo dada la ID de pantalla. El formato es PNG.

    TODO: Extienda las implementaciones anteriores para admitir 'formato' y 'rescala'

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

    Devoluciones
    InputStreamSource Un InputStreamSource de la captura de pantalla en formato, o null si la captura de pantalla no tuvo éxito.

    Lanza
    DeviceNotAvailableException

    obtener captura de pantalla

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

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

    Parámetros
    format String : PNG compatible, JPEG

    rescale boolean : si la captura de pantalla debe ser reescalada para reducir el tamaño de la imagen resultante

    Devoluciones
    InputStreamSource Un InputStreamSource de la captura de pantalla en formato, o null si la captura de pantalla no tuvo éxito.

    Lanza
    DeviceNotAvailableException

    obtener captura de pantalla

    public InputStreamSource getScreenshot ()

    Agarra una captura de pantalla del dispositivo.

    Devoluciones
    InputStreamSource Un InputStreamSource de la captura de pantalla en formato PNG, o null , si la captura de pantalla no tuvo éxito.

    Lanza
    DeviceNotAvailableException

    getserialnumber

    public String getSerialNumber ()

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

    Devoluciones
    String el número de serie String

    getero

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

    Devuelva el valor de la configuración solicitada. El espacio de nombres debe ser uno de: {"sistema", "seguro", "global"}

    Parámetros
    userId int

    namespace String

    key String

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

    Lanza
    DeviceNotAvailableException

    getero

    public String getSetting (String namespace, 
                    String key)

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

    Parámetros
    namespace String

    key String

    Devoluciones
    String

    Lanza
    DeviceNotAvailableException

    getSiMoperator

    public String getSimOperator ()

    Devuelva el operador de la tarjeta SIM o el nulo si no está disponible o si el dispositivo no está disponible.

    Devoluciones
    String

    getSimstate

    public String getSimState ()

    Devuelva el estado de la tarjeta SIM o nulo si no está disponible o el dispositivo no está disponible.

    Devoluciones
    String

    piedras de gettombe

    public  getTombstones ()

    Obtenga y devuelva la lista de lápidas de los dispositivos. Requiere raíz.

    El método es el mejor esfuerzo, por lo que si una lápida no se extrae por cualquier motivo, faltará en la lista. Solo una DeviceNotAvailableException terminará el método temprano.

    Devoluciones
    Una lista de archivos de lápida, vacío si no hay lápida.

    Lanza
    DeviceNotAvailableException

    getTotalMemory

    public long getTotalMemory ()

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

    Devoluciones
    long

    getuninstallablePackagenames

    public  getUninstallablePackageNames ()

    Obtenga los nombres de los paquetes de aplicación que se pueden desinstalar. Esto se define actualmente como paquetes que no son del sistema y paquetes de sistema actualizados.

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

    Lanza
    DeviceNotAvailableException

    GetUseFastBooterasa

    public boolean getUseFastbootErase ()

    Obtenga si usar FastBoot Borrar o FastBoot format para borrar una partición en el dispositivo.

    Devoluciones
    boolean true si FastBoot Erase se usará o se false si se utilizará el formato FastBoot.

    getUserflags

    public int getUserFlags (int userId)

    Encuentre y devuelva las banderas de un usuario determinado. Las banderas se definen en la clase "Android.Content.Pm.UserInfo" en el proyecto de código abierto de Android.

    Parámetros
    userId int

    Devoluciones
    int Las banderas asociadas con el IDED proporcionadas si se encuentran, -10000 en cualquier otro caso.

    Lanza
    DeviceNotAvailableException

    getUserinfos

    public  getUserInfos ()

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

    Devoluciones
    La lista de objetos UserInfo.

    Lanza
    DeviceNotAvailableException

    getUserSerialNumber

    public int getUserSerialNumber (int userId)

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

    Parámetros
    userId int

    Devoluciones
    int

    Lanza
    DeviceNotAvailableException

    HandleAlLocationEvent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    Procese el dispositivo de dispositivo dado. Puede hacer el dispositivo de transición al nuevo estado. Informará al IDeviceMonitor de cualquier transición estatal.

    Procese el dispositivo Event, que puede o no hacer la transición de este dispositivo a un nuevo estado de asignación.

    Parámetros
    event DeviceEvent

    Devoluciones
    IManagedTestDevice.DeviceEventResponse

    HASFAETURA

    public boolean hasFeature (String feature)

    Verifique si hay una función disponible en un dispositivo.

    Parámetros
    feature String : qué formato debería ser "característica: " o " "directamente.

    Devoluciones
    boolean VERDADERO Si se encuentra la función, falso de lo contrario.

    Lanza
    DeviceNotAvailableException

    paquete de instalación

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

    Instale un paquete de Android en el dispositivo.

    Parámetros
    packageFile File : el archivo APK para instalar

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

    extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'ADB Shell PM -H' para ver las opciones disponibles.

    Devoluciones
    String una String con un código de error, o null IF Success.

    Lanza
    DeviceNotAvailableException

    paquete de instalación

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

    Instale un paquete de Android en el dispositivo.

    Nota: Solo los casos de uso que requieren un control explícito de otorgar el permiso de tiempo de ejecución a la hora de instalación deben llamar a esta función.

    Parámetros
    packageFile File : el archivo APK para instalar

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

    grantPermissions boolean : si todos los permisos de tiempo de ejecución deben otorgarse en la hora de instalación

    extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'ADB Shell PM -H' para ver las opciones disponibles.

    Devoluciones
    String una String con un código de error, o null IF Success.

    Lanza
    DeviceNotAvailableException

    installPackageForuser

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

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

    Parámetros
    packageFile File : el archivo APK para instalar

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

    userId int : la ID de usuario entero para instalar.

    extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'ADB Shell PM -H' para ver las opciones disponibles.

    Devoluciones
    String una String con un código de error, o null IF Success.

    Lanza
    DeviceNotAvailableException

    installPackageForuser

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

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

    Nota: Solo los casos de uso que requieren un control explícito de otorgar el permiso de tiempo de ejecución a la hora de instalación deben llamar a esta función.

    Parámetros
    packageFile File : el archivo APK para instalar

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

    grantPermissions boolean : si todos los permisos de tiempo de ejecución deben otorgarse en la hora de instalación

    userId int : la ID de usuario entero para instalar.

    extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'ADB Shell PM -H' para ver las opciones disponibles.

    Devoluciones
    String una String con un código de error, o null IF Success.

    Lanza
    DeviceNotAvailableException

    invalidatePropertyCache

    public void invalidatePropertyCache ()

    isadbroot

    public boolean isAdbRoot ()

    Devoluciones
    boolean

    Lanza
    DeviceNotAvailableException

    isadbtcp

    public boolean isAdbTcp ()

    Devoluciones
    boolean

    iSappenumerationationsupported

    public boolean isAppEnumerationSupported ()

    Verifique si la plataforma en el dispositivo admite la enumeración de la aplicación

    Devoluciones
    boolean Verdadero si la enumeración de la aplicación es compatible, falso de lo contrario

    Lanza
    DeviceNotAvailableException

    isbypasslowTargetSdkblocksupported

    public boolean isBypassLowTargetSdkBlockSupported ()

    Compruebe si la plataforma en el dispositivo admite si el bloque SDK de destino bajo en las instalaciones de la aplicación

    Devoluciones
    boolean Verdadero Si se admite el bloque SDK de Target Bypass bajo, falso de lo contrario

    Lanza
    DeviceNotAvailableException

    isdebugfsmounted

    public boolean isDebugfsMounted ()

    Compruebe si el depugfs está montado.

    Devoluciones
    boolean true si se monta el desbugfs

    Lanza
    DeviceNotAvailableException

    ISDEVICEECRYPTADO

    public boolean isDeviceEncrypted ()

    Devuelve si el dispositivo está encriptado.

    Devoluciones
    boolean true si el dispositivo está encriptado.

    Lanza
    DeviceNotAvailableException

    ISDirectorio

    public boolean isDirectory (String path)

    Devuelve verdadero si la ruta en el dispositivo es un directorio, falso de lo contrario.

    Parámetros
    path String

    Devoluciones
    boolean

    Lanza
    DeviceNotAvailableException

    isenableadbroot

    public boolean isEnableAdbRoot ()

    Devoluciones
    boolean true si la raíz ADB debe habilitarse en el dispositivo

    Isencryptionsupported

    public boolean isEncryptionSupported ()

    Devuelve si el cifrado se admite en el dispositivo.

    Devoluciones
    boolean true si el dispositivo admite el cifrado.

    Lanza
    DeviceNotAvailableException

    isexecutable

    public boolean isExecutable (String fullPath)

    Devuelve True si la ruta del archivo en el dispositivo es un archivo ejecutable, falso de lo contrario.

    Parámetros
    fullPath String

    Devoluciones
    boolean

    Lanza
    DeviceNotAvailableException

    ISFASTBOOTENABLED

    public boolean isFastbootEnabled ()

    Regrese si FastBoot está disponible para el dispositivo.

    Devoluciones
    boolean

    no cabreoso

    public boolean isHeadless ()

    Devuelve verdadero si el dispositivo no tiene cabeza (sin pantalla), falso de lo contrario.

    Devoluciones
    boolean

    Lanza
    DeviceNotAvailableException

    isheadlessSystemUsermode

    public boolean isHeadlessSystemUserMode ()

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

    Devoluciones
    boolean

    Lanza
    DeviceNotAvailableException

    ismainuserpermanentadmin

    public boolean isMainUserPermanentAdmin ()

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

    Devoluciones
    boolean

    Lanza
    DeviceNotAvailableException

    esmultiuserSupported

    public boolean isMultiUserSupported ()

    Determina si es compatible con el usuario múltiple.

    Devoluciones
    boolean Verdadero Si el usuario múltiple es compatible, falso de lo contrario

    Lanza
    DeviceNotAvailableException

    ispackageInstalled

    public boolean isPackageInstalled (String packageName, 
                    String userId)

    Consulte el dispositivo para un nombre de paquete dado y una identificación de usuario dada para verificar si está actualmente instalado o no para ese usuario.

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

    userId String : el ID de usuario para el que estamos comprobando el paquete está instalado. Si es nulo, se utilizará el usuario primario cero.

    Devoluciones
    boolean Es cierto si el paquete se informa como se instala. Falso en caso contrario.

    Lanza
    DeviceNotAvailableException

    ispackageInstalled

    public boolean isPackageInstalled (String packageName)

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

    Parámetros
    packageName String

    Devoluciones
    boolean Es cierto si el paquete se informa como se instala. Falso en caso contrario.

    Lanza
    DeviceNotAvailableException

    isruntimePermissionsupported

    public boolean isRuntimePermissionSupported ()

    Verifique si la plataforma en el dispositivo admite la concesión de permiso de tiempo de ejecución

    Devoluciones
    boolean Verdadero Si el permiso de tiempo de ejecución es compatible, falso de lo contrario.

    Lanza
    DeviceNotAvailableException

    iSstateBootLoaderRastbootd

    public boolean isStateBootloaderOrFastbootd ()

    Devuelve verdadero si el dispositivo está en TestDeviceState#FASTBOOT o TestDeviceState.FASTBOOTD .

    Devoluciones
    boolean

    isuserrunning

    public boolean isUserRunning (int userId)

    Compruebe si un usuario determinado se está ejecutando.

    Parámetros
    userId int

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

    Lanza
    DeviceNotAvailableException

    isusersecundario

    public boolean isUserSecondary (int userId)

    Devuelva si el usuario especificado es un usuario secundario de acuerdo con sus banderas.

    Parámetros
    userId int

    Devoluciones
    boolean Verdadero si el usuario es secundario, falso de lo contrario.

    Lanza
    DeviceNotAvailableException

    isuservisible

    public boolean isUserVisible (int userId)

    Comprueba si el usuario dado es visible.

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

    Parámetros
    userId int

    Devoluciones
    boolean

    Lanza
    DeviceNotAvailableException

    IsuservisibleDesplay

    public boolean isUserVisibleOnDisplay (int userId, 
                    int displayId)

    Comprueba si el usuario dado es visible en la pantalla dada.

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

    Parámetros
    userId int

    displayId int

    Devoluciones
    boolean

    Lanza
    DeviceNotAvailableException

    ISVISible

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

    Si lo hace, puede llamar startVisibleBackgroundUser(int, int, boolean) , pasando una pantalla devuelta por listDisplayIdsForStartingVisibleBackgroundUsers() (que debe incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

    Devoluciones
    boolean

    Lanza
    DeviceNotAvailableException

    ISVISible BackgroundUsersSupported

    public boolean isVisibleBackgroundUsersSupported ()

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

    Si es así, puede llamar startVisibleBackgroundUser(int, int, boolean) , pasando una pantalla devuelta por listDisplayIdsForStartingVisibleBackgroundUsers() .

    Devoluciones
    boolean

    Lanza
    DeviceNotAvailableException

    iswifienable

    public boolean isWifiEnabled ()

    Pruebe si WiFi está habilitado.

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

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

    Lanza
    DeviceNotAvailableException

    listdisplayids

    public  listDisplayIds ()

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

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

    Lanza
    DeviceNotAvailableException

    listDisplayidSforStartingVisibleBackgroundusers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

    Devoluciones

    Lanza
    DeviceNotAvailableException

    usuarios de listados

    public  listUsers ()

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

    Devoluciones
    La lista de ID de usuario.

    Lanza
    DeviceNotAvailableException

    loganrs

    public boolean logAnrs (ITestLogger logger)

    Recoge y registra ANR del dispositivo.

    Parámetros
    logger ITestLogger : un ITestLogger para registrar el ANRS.

    Devoluciones
    boolean Verdadero Si el registro fue exitoso, falso de lo contrario.

    Lanza
    DeviceNotAvailableException

    logbuGreport

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Método auxiliar para tomar un bugreport y registrarlo a los reporteros.

    Parámetros
    dataName String : nombre bajo el cual se informará el bugreport.

    listener ITestLogger : un ITestLogger para registrar el bugreport.

    Devoluciones
    boolean Verdadero Si el registro fue exitoso, falso de lo contrario.

    evidente de logonte

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

    Registre un mensaje en el logCat del dispositivo. Esta es una llamada segura que no lanzará incluso si el registro falla.

    Parámetros
    tag String : la etiqueta en la que registramos nuestro mensaje en el LogCat.

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

    format String : el formato de mensaje.

    args Object : Los args se reemplazarán a través de String.Format ().

    Mountdebugfs

    public void mountDebugfs ()

    MONTAJE DEBUGFS.

    Lanza
    DeviceNotAvailableException

    no bloqueado

    public void nonBlockingReboot ()

    Emite un comando para reiniciar el dispositivo y devuelve el comando completo y cuando el dispositivo ya no es visible para ADB.

    Lanza
    DeviceNotAvailableException

    postadbrootaccion

    public void postAdbRootAction ()

    Anule si el dispositivo necesita que se tomen algunas acciones específicas después de la raíz 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 ADB esté habilitada en esta etapa.

    Lanza
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    posadbunrootacción

    public void postAdbUnrootAction ()

    Anule si el dispositivo necesita algunas acciones específicas para tomar después de ADB Unroot 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 ADB esté deshabilitada en esta etapa.

    Lanza
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    bootsetup

    public void postBootSetup ()

    Realice instrucciones para configurar el dispositivo para probarlo después de cada arranque.

    Debe llamarse después de que el dispositivo esté completamente arrancado/disponible

    En circunstancias normales, este método no necesita llamarse explícitamente, ya que las implementaciones deben realizar estos pasos automáticamente al realizar un reinicio.

    Donde sea posible que deba llamarse es cuando el dispositivo se reinicia debido a otros eventos (por ejemplo, cuando se ha completado un comando de actualización de fastboot)

    Lanza
    DeviceNotAvailableException

    Tardown posterior a la invocación

    public void postInvocationTearDown (Throwable exception)

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

    Parámetros
    exception Throwable : si corresponde, la excepción final planteada por la falla de invocación.

    preinvocationatup

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

    Pasos adicionales para la configuración necesaria específica del dispositivo que se ejecutará en el dispositivo 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

    Lanza
    DeviceNotAvailableException
    TargetSetupError

    polldir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Retire recursivamente el contenido del directorio desde el dispositivo.

    Parámetros
    deviceFilePath String : la ruta de archivo absoluto de la fuente remota

    localDir File : el directorio local para extraer archivos en

    Devoluciones
    boolean true si el archivo se sacó con éxito. false en caso contrario.

    Lanza
    DeviceNotAvailableException

    tirón

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Recupera un archivo de dispositivo.

    Parámetros
    remoteFilePath String : la ruta absoluta para archivar en el dispositivo.

    localFile File : el archivo local para almacenar contenido. Si no es vacío, se reemplazarán los contenidos.

    Devoluciones
    boolean true si el archivo se recuperó con éxito. false en caso contrario.

    Lanza
    DeviceNotAvailableException

    tirón

    public File pullFile (String remoteFilePath, 
                    int userId)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    Parámetros
    remoteFilePath String : the absolute path to file on device.

    userId int : The user id to pull from

    Devoluciones
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Lanza
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    Parámetros
    remoteFilePath String : the absolute path to file on device.

    Devoluciones
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Lanza
    DeviceNotAvailableException

    pullFile

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

    Retrieves a file off device.

    Parámetros
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    userId int : The user id to pull from

    Devoluciones
    boolean true if file was retrieved successfully. false en caso contrario.

    Lanza
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

    Retrieves a file off device, and returns the contents.

    Parámetros
    remoteFilePath String : the absolute path to file on device.

    Devoluciones
    String A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Lanza
    DeviceNotAvailableException

    pullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

    A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

    Parámetros
    remoteFilePath String : the path to file on device, relative to the device's external storage mountpoint

    Devoluciones
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Lanza
    DeviceNotAvailableException

    pushDir

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

    Recursively push directory contents to device while excluding some directories that are filtered.

    Parámetros
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    excludedDirectories : Set of excluded directories names that shouldn't be pushed.

    Devoluciones
    boolean true if file was pushed successfully. false en caso contrario.

    Lanza
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

    Recursively push directory contents to device.

    Parámetros
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    Devoluciones
    boolean true if file was pushed successfully. false en caso contrario.

    Lanza
    DeviceNotAvailableException

    pushFile

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

    Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

    Parámetros
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    evaluateContentProviderNeeded boolean : whether to check if we need the content provider

    Devoluciones
    boolean true if file was pushed successfully. false en caso contrario.

    Lanza
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    Push a file to device. By default using a content provider.

    Parámetros
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    Devoluciones
    boolean true if file was pushed successfully. false en caso contrario.

    Lanza
    DeviceNotAvailableException

    pushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

    Push file created from a string to device

    Parámetros
    contents String : the contents of the file to push

    remoteFilePath String : the remote destination absolute file path

    Devoluciones
    boolean true if string was pushed successfully. false en caso contrario.

    Lanza
    DeviceNotAvailableException

    reiniciar

    public void reboot (String reason)

    Reboots the device into adb mode with given reason to be persisted across reboot.

    Blocks until device becomes available.

    Last reboot reason can be obtained by querying sys.boot.reason propety.

    Parámetros
    reason String : a reason for this reboot, or null if no reason is specified.

    Lanza
    DeviceNotAvailableException

    reiniciar

    public void reboot ()

    Reboots the device into adb mode.

    Blocks until device becomes available.

    Lanza
    DeviceNotAvailableException

    rebootIntoBootloader

    public void rebootIntoBootloader ()

    Reboots the device into bootloader mode.

    Blocks until device is in bootloader mode.

    Lanza
    DeviceNotAvailableException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

    Reboots the device into fastbootd mode.

    Blocks until device is in fastbootd mode.

    Lanza
    DeviceNotAvailableException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

    Reboots the device into adb recovery mode.

    Blocks until device enters recovery

    Lanza
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload ()

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    Lanza
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    Parámetros
    autoReboot boolean : whether to automatically reboot the device after sideload

    Lanza
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline ()

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    Lanza
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline (String reason)

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    Parámetros
    reason String : a reason for this reboot, or null if no reason is specified.

    Lanza
    DeviceNotAvailableException

    rebootUserspace

    public void rebootUserspace ()

    Reboots only userspace part of device.

    Blocks until device becomes available.

    ADVERTENCIA. Userspace reboot is currently under active development, use it on your own risk.

    Lanza
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

    An alternate to rebootUserspace() ()} that only blocks until device is online ie visible to adb.

    Lanza
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

    Attempts to recover device communication.

    Devoluciones
    boolean True if recovery attempted and successful, returns False if recovery was skipped

    Lanza
    DeviceNotAvailableException if device is no longer available

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Registers a IDeviceActionReceiver for this device.

    All registered IDeviceActionReceiver s will be notified before a device action starts and after the device action ends.

    Parámetros
    deviceActionReceiver IDeviceActionReceiver : A IDeviceActionReceiver which will be registered.

    remountSystemReadOnly

    public void remountSystemReadOnly ()

    Make the system partition on the device read-only. May reboot the device.

    Lanza
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

    Make the system partition on the device writable. May reboot the device.

    Lanza
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

    Make the vendor partition on the device read-only. May reboot the device.

    Lanza
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

    Make the vendor partition on the device writable. May reboot the device.

    Lanza
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                    int userId)

    Remove given device admin in given user and return true if it is successful, false otherwise.

    Parámetros
    componentName String : of device admin to be removed.

    userId int : of user that the device admin lives in.

    Devoluciones
    boolean True if it is successful, false otherwise.

    Lanza
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

    Remove all existing device profile owners with the best effort.

    Lanza
    DeviceNotAvailableException

    removeUser

    public boolean removeUser (int userId)

    Remove a given user from the device.

    Parámetros
    userId int : of the user to remove

    Devoluciones
    boolean true if we were successful in removing the user, false otherwise.

    Lanza
    DeviceNotAvailableException

    resetContentProviderSetup

    public void resetContentProviderSetup ()

    Reset the flag for content provider setup in order to trigger it again.

    runInstrumentationTests

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

    Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

    Parámetros
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners ITestLifeCycleReceiver : the test result listener(s)

    Devoluciones
    boolean true if test command completed. false if it failed to complete, but recovery succeeded

    Lanza
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Runs instrumentation tests, and provides device recovery.

    If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.

    If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.

    Parámetros
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners : the test result listeners

    Devoluciones
    boolean true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded

    Lanza
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

    Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

    Parámetros
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Devoluciones
    boolean

    Lanza
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

    Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

    Parámetros
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Devoluciones
    boolean

    Lanza
    DeviceNotAvailableException

    establecer configuración

    public void setConfiguration (IConfiguration configuration)

    Inyecta la IConfiguration en uso.

    Parámetros
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    Parámetros
    avdInfo GceAvdInfo

    Establece la fecha

    public void setDate (Date date)

    Sets the date on device

    Note: setting date on device requires root

    Parámetros
    date Date : specify a particular date; will use host date if null

    Lanza
    DeviceNotAvailableException

    setDeviceOwner

    public boolean setDeviceOwner (String componentName, 
                    int userId)

    Set a device admin component as device owner in given user.

    Parámetros
    componentName String : of device admin to be device owner.

    userId int : of the user that the device owner lives in.

    Devoluciones
    boolean True if it is successful, false otherwise.

    Lanza
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    Update the device's state.

    Parámetros
    deviceState TestDeviceState : the TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    For emulator set SizeLimitedOutputStream to log output

    Parámetros
    output SizeLimitedOutputStream : to log the output

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

    Sets the Process , when this device is an emulator.

    Parámetros
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

    Set the fastboot option for the device. Should be set when device is first allocated.

    Parámetros
    fastbootEnabled boolean : whether fastboot is available for the device or not

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    Sets the path to the fastboot binary that should be used. Still requires isFastbootEnabled() to be true, to have fastboot functions enabled.

    Parámetros
    fastbootPath String

    setIDevice

    public void setIDevice (IDevice newDevice)

    Update the IDevice associated with this ITestDevice.

    The new IDevice must refer the same physical device as the current reference. This method will be called if DDMS has allocated a new IDevice

    Parámetros
    newDevice IDevice : el IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

    Sets the time in ms to wait before starting logcat capture for a online device.

    Parámetros
    delay int : the delay in ms

    establecer opciones

    public void setOptions (TestDeviceOptions options)

    Set the TestDeviceOptions for the device

    Parámetros
    options TestDeviceOptions

    establecer propiedad

    public boolean setProperty (String propKey, 
                    String propValue)

    Sets the given property value on the device. Requires adb root is true.

    Parámetros
    propKey String : The key targeted to be set.

    propValue String : The property value to be set.

    Devoluciones
    boolean returns True if the setprop command was successful, False otherwise.

    Lanza
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

    Set the IDeviceRecovery to use for this device. Should be set when device is first allocated.

    Parámetros
    recovery IDeviceRecovery : the IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Set the current recovery mode to use for the device.

    Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc

    Parámetros
    mode ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not.

    setSetting

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

    See setSetting(int, String, String, String) and performed on system user.

    Parámetros
    namespace String

    key String

    value String

    Lanza
    DeviceNotAvailableException

    setSetting

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

    Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}

    Parámetros
    userId int

    namespace String

    key String

    value String

    Lanza
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    Injects the ITestLogger instance

    Parámetros
    testLogger ITestLogger

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

    Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

    Parámetros
    useFastbootErase boolean : true if fastboot erase should be used or false if fastboot format should be used.

    startLogcat

    public void startLogcat ()

    Start capturing logcat output from device in the background.

    Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.

    When the device is no longer in use, stopLogcat() must be called.

    startLogcat() and stopLogcat() do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.

    startUser

    public boolean startUser (int userId)

    Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.

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

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

    Lanza
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId, 
                    boolean waitFlag)

    Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.

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

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

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

    Lanza
    DeviceNotAvailableException

    startVisibleBackgroundUser

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

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

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

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

    displayId int : display to start user visible on

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

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

    Lanza
    DeviceNotAvailableException

    stopEmulatorOutput

    public void stopEmulatorOutput ()

    Close and delete the emulator output.

    stopLogcat

    public void stopLogcat ()

    Stop capturing logcat output from device, and discard currently saved logcat data.

    Will have no effect if logcat output is not being captured.

    stopUser

    public boolean stopUser (int userId)

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

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

    Devoluciones
    boolean true if the user was successfully stopped.

    Lanza
    DeviceNotAvailableException

    stopUser

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

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

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

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

    forceFlag boolean : will force stop the user.

    Devoluciones
    boolean true if the user was successfully stopped.

    Lanza
    DeviceNotAvailableException

    switchToAdbTcp

    public String switchToAdbTcp ()

    Switch device to adb-over-tcp mode.

    Devoluciones
    String the tcp serial number or null if device could not be switched

    Lanza
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

    Switch device to adb over usb mode.

    Devoluciones
    boolean true if switch was successful, false otherwise.

    Lanza
    DeviceNotAvailableException

    cambiar de usuario

    public boolean switchUser (int userId)

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

    Parámetros
    userId int

    Devoluciones
    boolean True if the new userId matches the userId provider. Falso en caso contrario.

    Lanza
    DeviceNotAvailableException

    cambiar de usuario

    public boolean switchUser (int userId, 
                    long timeout)

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

    Parámetros
    userId int

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

    Devoluciones
    boolean True if the new userId matches the userId provider. Falso en caso contrario.

    Lanza
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Incrementally syncs the contents of a local file directory to device.

    Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.

    Hidden files (with names starting with ".") will be ignored.

    Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.

    Parámetros
    localFileDir File : the local file directory containing files to recursively push.

    deviceFilePath String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail

    Devoluciones
    boolean true if files were synced successfully. false en caso contrario.

    Lanza
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

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

    Devoluciones
    Bugreport

    uninstallPackage

    public String uninstallPackage (String packageName)

    Uninstall an Android package from device.

    Parámetros
    packageName String : the Android package to uninstall

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

    Lanza
    DeviceNotAvailableException

    uninstallPackageForUser

    public String uninstallPackageForUser (String packageName, 
                    int userId)

    Uninstall an Android package from device for a given user.

    Parámetros
    packageName String : the Android package to uninstall

    userId int : the integer user id to uninstall for.

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

    Lanza
    DeviceNotAvailableException

    unlockDevice

    public boolean unlockDevice ()

    Unlocks the device if the device is in an encrypted state.

    This method may restart the framework but will not call postBootSetup() . Therefore, the device might not be fully ready to be tested when this method returns.

    Devoluciones
    boolean true if successful or if the device is unencrypted.

    Lanza
    DeviceNotAvailableException

    unmountDebugfs

    public void unmountDebugfs ()

    Unmount debugfs.

    Lanza
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

    Blocks until the device's boot complete flag is set.

    Parámetros
    timeOut long : time in msecs to wait for the flag to be set

    Devoluciones
    boolean true if device's boot complete flag is set within the timeout

    Lanza
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

    Waits for the device to be responsive and available for testing. Uses default timeout.

    Devoluciones
    boolean True if device is available, False if recovery is disabled and unavailable.

    Lanza
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

    Waits for the device to be responsive and available for testing.

    Parámetros
    waitTime long : the time in ms to wait

    Devoluciones
    boolean True if device is available, False if recovery is disabled and unavailable.

    Lanza
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Waits for the device to be responsive and available without considering recovery path.

    Parámetros
    waitTime long

    Devoluciones
    boolean True if device is available, False if unavailable.

    Lanza
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

    Blocks until device is visible via fastboot. Use default timeout.

    Lanza
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

    Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

    Parámetros
    waitTime long : the time in ms to wait

    Devoluciones
    boolean true if device boots into recovery before time expires. false en caso contrario

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

    Blocks for the device to be in the 'adb sideload' state

    Parámetros
    waitTime long : the time in ms to wait

    Devoluciones
    boolean true if device boots into sideload before time expires. false en caso contrario

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

    Blocks for the device to be not available ie missing from adb

    Parámetros
    waitTime long : the time in ms to wait

    Devoluciones
    boolean true if device becomes not available before time expires. false en caso contrario

    waitForDeviceOnline

    public void waitForDeviceOnline ()

    Blocks until device is visible via adb. Uses default timeout

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    Lanza
    DeviceNotAvailableException

    waitForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

    Blocks until device is visible via adb.

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    Parámetros
    waitTime long : the time in ms to wait

    Lanza
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

    Waits for device to be responsive to a basic adb shell command.

    Parámetros
    waitTime long : the time in ms to wait

    Devoluciones
    boolean true if device becomes responsive before waitTime elapses.

    Métodos protegidos

    addExtraConnectionBuilderArgs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    Parámetros
    builder DefaultConnection.ConnectionBuilder

    buildAdbShellCommand

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

    Builds the OS command for the given adb shell command session and args

    Parámetros
    command String

    forceExitStatusDetection boolean

    Devoluciones
    String[]

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    Parámetros
    feature String

    strictMinLevel int

    createRebootDeviceAction

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

    Create a RebootDeviceAction to be used when performing a reboot action.

    Parámetros
    rebootMode NativeDevice.RebootMode : a mode of this reboot.

    reason String : for this reboot.

    Devoluciones
    NativeDevice.RebootDeviceAction the created RebootDeviceAction .

    createRunUtil

    protected IRunUtil createRunUtil ()

    Devoluciones
    IRunUtil

    doAdbReboot

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

    Perform a adb reboot.

    Parámetros
    rebootMode NativeDevice.RebootMode : a mode of this reboot.

    reason String : for this reboot.

    Lanza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

    helper method to throw exception if runtime permission isn't supported

    Lanza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getApiLevelSafe

    protected int getApiLevelSafe ()

    Devoluciones
    int

    obtenerLogger

    protected ITestLogger getLogger ()

    Devoluciones
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

    Get the RunUtil instance to use.

    Devoluciones
    IRunUtil

    initializeConnection

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

    Parámetros
    info IBuildInfo

    attributes MultiMap

    Lanza
    DeviceNotAvailableException
    TargetSetupError

    internalGetProperty

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

    Fetch a device property, from the ddmlib cache by default, and falling back to either `adb shell getprop` or `fastboot getvar` depending on whether the device is in Fastboot or not.

    Parámetros
    propName String : The name of the device property as returned by `adb shell getprop`

    fastbootVar String : The name of the equivalent fastboot variable to query. if null , fastboot query will not be attempted

    description String : A simple description of the variable. First letter should be capitalized.

    Devoluciones
    String A string, possibly null or empty, containing the value of the given property

    Lanza
    DeviceNotAvailableException

    isInRebootCallback

    protected boolean isInRebootCallback ()

    Returns whether reboot callbacks is currently being executed or not. All public api's for reboot should be disabled if true.

    Devoluciones
    boolean

    isNewer

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    Return true if local file is newer than remote file. IFileEntry being accurate to the minute, in case of equal times, the file will be considered newer.

    Parámetros
    localFile File

    entry IFileEntry

    Devoluciones
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

    Notifies all IDeviceActionReceiver about reboot end event.

    Lanza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    notifyRebootStarted

    protected void notifyRebootStarted ()

    Notifies all IDeviceActionReceiver about reboot start event.

    Lanza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    performDeviceAction

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

    Performs an action on this device. Attempts to recover device and optionally retry command if action fails.

    Parámetros
    actionDescription String : a short description of action to be performed. Used for logging purposes only.

    action NativeDevice.DeviceAction : the action to be performed

    retryAttempts int : the retry attempts to make for action if it fails but recovery succeeds

    Devoluciones
    boolean true if action was performed successfully

    Lanza
    DeviceNotAvailableException if recovery attempt fails or max attempts done without success

    postAdbReboot

    protected void postAdbReboot ()

    Possible extra actions that can be taken after a reboot.

    Lanza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    prePostBootSetup

    protected void prePostBootSetup ()

    Allows each device type (AndroidNativeDevice, TestDevice) to override this method for specific post boot setup.

    Lanza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    pullFileInternal

    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    Parámetros
    remoteFilePath String

    localFile File

    Devoluciones
    boolean

    Lanza
    DeviceNotAvailableException

    establecer reloj

    protected void setClock (Clock clock)

    Set the Clock instance to use.

    Parámetros
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Marks the TestDevice as microdroid and sets its CID.

    Parámetros
    process Process : Process of the Microdroid VM.

    setTestDeviceOptions

    protected void setTestDeviceOptions ( deviceOptions)

    Parámetros
    deviceOptions

    simpleFastbootCommand

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

    Executes a simple fastboot command with environment variables and report the status of the command.

    Parámetros
    timeout long

    envVarMap

    fullCmd String

    Devoluciones
    CommandResult

    simpleFastbootCommand

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

    Executes a simple fastboot command and report the status of the command.

    Parámetros
    timeout long

    fullCmd String

    Devoluciones
    CommandResult

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

    Wait to see the device going unavailable (stop reporting to adb).

    Parámetros
    operationDesc String : The name of the operation that is waiting for unavailable.

    time long : The time to wait for unavailable to occur.

    Devoluciones
    boolean True if device did become unavailable.