Dispositivo nativo

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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

Reintenta los comandos del dispositivo durante una cantidad configurable y proporciona una recuperación del dispositivo. para dispositivos que no responden.

Resumen

Constantes

int UNKNOWN_API_LEVEL

Valor predeterminado cuando no se puede detectar el nivel de API

Métodos públicos

abstract boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Comprueba si una función es compatible actualmente con un nivel mínimamente compatible.

abstract void clearLogcat()

Borra todos los datos acumulados de logcat.

abstract void deleteFile(String deviceFilePath)

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

abstract void deleteFile(String deviceFilePath, int userId)

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

abstract boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

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

abstract boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

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

abstract boolean disableAdbRoot()

Desactiva la raíz de adb.

abstract boolean doesFileExist(String deviceFilePath)

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

abstract boolean enableAdbRoot()

Activa la raíz de adb.

abstract String executeAdbCommand(long timeout, String... commandArgs)

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

abstract String executeAdbCommand(String... commandArgs)

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

abstract String executeAdbCommand(long timeout, envMap, String... commandArgs)

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

abstract CommandResult executeFastbootCommand(long timeout, String... commandArgs)

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

abstract CommandResult executeFastbootCommand(String... commandArgs)

Es un método de ayuda que ejecuta un comando fastboot como un comando del sistema con un tiempo de espera predeterminado de 2 minutos.

abstract CommandResult executeLongFastbootCommand(String... commandArgs)

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

abstract CommandResult executeLongFastbootCommand( envVarMap, String... commandArgs)

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

abstract String executeShellCommand(String command)

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

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

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

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

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

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

abstract CommandResult executeShellV2Command(String command)

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

abstract CommandResult executeShellV2Command(String command, OutputStream pipeToOutput)

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

abstract CommandResult executeShellV2Command(String command, File pipeAsInput)

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

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

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

abstract CommandResult executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)

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

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

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

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

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

abstract CommandResult fastbootWipePartition(String partition)

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

abstract int getApiLevel()

Obtén el nivel de API del dispositivo.

abstract String getBasebandVersion()

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

abstract Integer getBattery()

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

abstract boolean getBooleanProperty(String name, boolean defaultValue)

Muestra el valor booleano de la propiedad especificada.

abstract getBootHistory()

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

abstract getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

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

abstract String getBootloaderVersion()

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

abstract String getBuildAlias()

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

abstract String getBuildFlavor()

Recupera la variante de compilación para el dispositivo.

abstract String getBuildId()

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

abstract String getBuildSigningKeys()

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

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

abstract DeviceDescriptor getCachedDeviceDescriptor()

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

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

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

abstract String[] getChildren(String deviceFilePath)

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

abstract AbstractConnection getConnection()

Muestra la conexión asociada con el dispositivo.

abstract String getDeviceClass()

Obtén la clase de dispositivo.

abstract long getDeviceDate()

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

abstract DeviceDescriptor getDeviceDescriptor()

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

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

abstract TestDeviceState getDeviceState()

Obtén el estado del dispositivo.

abstract long getDeviceTimeOffset(Date date)

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

abstract InputStreamSource getEmulatorOutput()

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

abstract long getExternalStoreFreeSpace()

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

abstract String getFastbootProductType()

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

abstract String getFastbootProductVariant()

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

abstract String getFastbootSerialNumber()

Devuelve el número de serie del modo fastboot.

abstract String getFastbootVariable(String variableName)

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

abstract IFileEntry getFileEntry(String path)

Recupera una referencia a un archivo remoto en el dispositivo.

abstract IDevice getIDevice()

Muestra una referencia al IDevice de ddmlib asociado.

abstract long getIntProperty(String name, long defaultValue)

Muestra el valor entero de la propiedad determinada del dispositivo.

abstract long getLastExpectedRebootTimeMillis()

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

abstract int getLaunchApiLevel()

Obtener el primer nivel de API iniciado en el dispositivo

abstract InputStreamSource getLogcat()

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

abstract InputStreamSource getLogcat(int maxBytes)

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

abstract InputStreamSource getLogcatDump()

Obtén un volcado del logcat actual del dispositivo.

abstract InputStreamSource getLogcatSince(long date)

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

abstract String getMountPoint(String mountName)

Muestra un punto de activación.

abstract ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

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

abstract getMountPointInfo()

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

abstract long getPartitionFreeSpace(String partition)

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

abstract ProcessInfo getProcessByName(String processName)

El método de ayuda ejecuta el elemento “pidof”. y "estadísticas" y muestra el objeto ProcessInfo con Es el PID y la hora de inicio del proceso determinado.

abstract String getProcessPid(String process)

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

abstract String getProductType()

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

abstract String getProductVariant()

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

abstract String getProperty(String name)

Recupera el valor de propiedad determinado del dispositivo.

abstract ITestDevice.RecoveryMode getRecoveryMode()

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

abstract String getSerialNumber()

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

abstract getTombstones()

Recupera y muestra la lista de tombstones de los dispositivos.

abstract long getTotalMemory()

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

default String getTrackingSerial()

Para la administración de dispositivos, obtén el número de serie que se usa para rastrear el dispositivo.

abstract boolean getUseFastbootErase()

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

abstract boolean isAdbRoot()
abstract boolean isAdbTcp()
abstract boolean isAppEnumerationSupported()

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

abstract boolean isBypassLowTargetSdkBlockSupported()

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

abstract boolean isDebugfsMounted()

Verifica si el elemento debugfs está activado.

abstract boolean isDeviceEncrypted()

Muestra si el dispositivo está encriptado.

abstract boolean isDirectory(String deviceFilePath)

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

abstract boolean isEncryptionSupported()

Se devuelve si el dispositivo admite la encriptación.

abstract boolean isExecutable(String fullPath)

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

abstract boolean isHeadless()

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

abstract boolean isRuntimePermissionSupported()

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

abstract boolean isStateBootloaderOrFastbootd()

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

abstract boolean logAnrs(ITestLogger logger)

Recopila y registra ANR del dispositivo.

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

Registra un mensaje en el logcat del dispositivo.

abstract void mountDebugfs()

Activa Debugfs.

abstract void nonBlockingReboot()

Emite un comando para reiniciar el dispositivo y regresa cuando se completa el comando cuando el dispositivo no está en funcionamiento. visible para adb.

abstract void postBootSetup()

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

default void postInvocationTearDown()

Este método dejó de estar disponible. En su lugar, usa postInvocationTearDown(Throwable).

abstract void postInvocationTearDown(Throwable invocationException)

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

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

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

abstract boolean pullDir(String deviceFilePath, File localDir)

Extrae contenido del directorio del dispositivo de manera recurrente.

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

Extrae contenido del directorio del dispositivo de manera recurrente.

abstract File pullFile(String remoteFilePath, int userId)

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

abstract File pullFile(String remoteFilePath)

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

abstract boolean pullFile(String remoteFilePath, File localFile)

Recupera un archivo fuera del dispositivo.

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

Recupera un archivo fuera del dispositivo.

abstract String pullFileContents(String remoteFilePath)

Recupera un archivo fuera del dispositivo y muestra el contenido.

abstract File pullFileFromExternal(String remoteFilePath)

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

abstract boolean pushDir(File localDir, String deviceFilePath, int userId)

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

abstract boolean pushDir(File localDir, String deviceFilePath, excludedDirectories)

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

abstract boolean pushDir(File localDir, String deviceFilePath)

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

abstract boolean pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)

Variante de pushFile(File, String) que puede considerar de manera opcional evaluar la necesidad para el proveedor de contenido.

abstract boolean pushFile(File localFile, String deviceFilePath)

Envía un archivo al dispositivo.

abstract boolean pushFile(File localFile, String deviceFilePath, int userId)

Envía un archivo al dispositivo.

abstract boolean pushString(String contents, String deviceFilePath)

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

abstract void reboot()

Reinicia el dispositivo en modo adb.

abstract void reboot(String reason)

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

abstract void rebootIntoBootloader()

Reinicia el dispositivo en el modo de bootloader.

abstract void rebootIntoFastbootd()

Reinicia el dispositivo en el modo fastbootd.

abstract void rebootIntoRecovery()

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

abstract void rebootIntoSideload(boolean autoReboot)

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

Se bloquea hasta que el dispositivo entre en modo de transferencia

abstract void rebootIntoSideload()

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

Se bloquea hasta que el dispositivo entre en modo de transferencia

abstract void rebootUntilOnline()

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

abstract void rebootUntilOnline(String reason)

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

abstract void rebootUserspace()

Reinicia solo una parte del espacio del usuario del dispositivo.

abstract void rebootUserspaceUntilOnline()

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

abstract void remountSystemReadOnly()

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

abstract void remountSystemWritable()

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

abstract void remountVendorReadOnly()

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

abstract void remountVendorWritable()

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

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

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

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

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

abstract boolean 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 determinado.

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

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

abstract void setDate(Date date)

Establece la fecha en el dispositivo

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

abstract void setOptions(TestDeviceOptions options)

Establece el TestDeviceOptions para el dispositivo.

abstract boolean setProperty(String propKey, String propValue)

Establece el valor de la propiedad determinada en el dispositivo.

abstract void setRecovery(IDeviceRecovery recovery)

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

abstract void setRecoveryMode(ITestDevice.RecoveryMode mode)

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

abstract void setTrackingSerial(String trackingSerial)

Para la administración de dispositivos, realiza un seguimiento del número de serie que usamos para referirnos al dispositivo.

abstract void setUseFastbootErase(boolean useFastbootErase)

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

abstract void startLogcat()

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

abstract void stopEmulatorOutput()

Cierra y borra el resultado del emulador.

abstract void stopLogcat()

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

abstract String switchToAdbTcp()

Cambia el dispositivo al modo adb-over-tcp.

abstract boolean switchToAdbUsb()

Cambia el dispositivo al modo adb mediante USB.

abstract boolean syncFiles(File localFileDir, String deviceFilePath)

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

abstract boolean unlockDevice()

Desbloquea el dispositivo si está encriptado.

abstract void unmountDebugfs()

Desactiva Debugfs.

abstract boolean waitForBootComplete(long timeOut)

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

abstract boolean waitForDeviceAvailable()

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

abstract boolean waitForDeviceAvailable(long waitTime)

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

abstract boolean waitForDeviceAvailableInRecoverPath(long waitTime)

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

abstract void waitForDeviceBootloader()

Se bloquea hasta que el dispositivo sea visible mediante fastboot.

abstract boolean waitForDeviceInRecovery(long waitTime)

Bloqueos para que el dispositivo esté en la "recuperación de adb" (ten en cuenta que esto es diferente de IDeviceRecovery).

abstract boolean waitForDeviceInSideload(long waitTime)

Bloqueos para que el dispositivo esté en la "transferencia de adb" estado

abstract boolean waitForDeviceNotAvailable(long waitTime)

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

abstract void waitForDeviceOnline()

Se bloquea hasta que el dispositivo sea visible mediante adb.

abstract void waitForDeviceOnline(long waitTime)

Se bloquea hasta que el dispositivo sea visible mediante adb.

abstract boolean waitForDeviceShell(long waitTime)

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

Constantes

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Valor predeterminado cuando no se puede detectar el nivel de API

Valor constante: -1 (0xffffffff)

Métodos públicos

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deleteLogcat

public abstract void clearLogcat ()

Borra todos los datos acumulados de logcat.

Esto es útil cuando quieres asegurarte de que ITestDevice#getLogcat() solo devuelva Datos de registro producidos después de un momento determinado (por ejemplo, después de escribir en la memoria flash una nueva compilación de un dispositivo, etcétera).

deleteFile

public abstract void deleteFile (String deviceFilePath)

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Reinicio en segundo plano del dispositivo

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

Arroja
RuntimeException si el dispositivo tiene un motivo de inicio anormal
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Reinicio no definitiva desde el dispositivo

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

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

Arroja
RuntimeException si el dispositivo tiene un motivo de inicio anormal
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

inhabilitarAdbRoot

public abstract boolean disableAdbRoot ()

Desactiva la raíz de adb.

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

Muestra
boolean true si se realiza correctamente.

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

haceArchivoexist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

Activa la raíz de adb. Si el comando "enable-root" es “false”, registrará un mensaje y que se mostrará sin habilitar la raíz.

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

Muestra
boolean true si se realiza correctamente.

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

EjecutarAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

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

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

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

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

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

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

EjecutarAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

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

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

EjecutarAdbCommand

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

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

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

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

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

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

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

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

EjecutarFastbootCommand

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

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

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

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

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

Muestra
CommandResult el CommandResult, que contiene la salida del comando

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

EjecutarFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

Es un método de ayuda que ejecuta un comando fastboot como un comando del sistema con un tiempo de espera predeterminado de 2 minutos.

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

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

Muestra
CommandResult el CommandResult, que contiene la salida del comando

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

ejecutarLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

Muestra
CommandResult el CommandResult, que contiene la salida del comando

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

ejecutarLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

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

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

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

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

Muestra
CommandResult el CommandResult, que contiene la salida del comando

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

Comando runShell

public abstract String executeShellCommand (String command)

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

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

Muestra
String el resultado del shell

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

Comando runShell

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

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

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

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

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

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

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

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

Comando runShell

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

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

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

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

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

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

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se reintenta el comando si falla debido a un excepción. Se arrojará DeviceNotResponseException si se cumplen las siguientes condiciones: retryAttempts se realizó sin éxito.

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

Comando runShell

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

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

Comando runShellV2

public abstract CommandResult executeShellV2Command (String command)

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

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

Muestra
CommandResult El resultado en CommandResult.

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

Comando runShellV2

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

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

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

Muestra
CommandResult El resultado en CommandResult.

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

Comando runShellV2

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

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

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

Muestra
CommandResult El resultado en CommandResult.

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

Comando runShellV2

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

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

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

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

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se reintenta el comando si falla debido a un excepción. Se arrojará DeviceNotResponseException si se cumplen las siguientes condiciones: retryAttempts se realizó sin éxito.

Muestra
CommandResult

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

Comando runShellV2

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

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

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

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

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

Muestra
CommandResult

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

Comando runShellV2

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

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

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

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

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

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

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se reintenta el comando si falla debido a un excepción. Se arrojará DeviceNotResponseException si se cumplen las siguientes condiciones: retryAttempts se realizó sin éxito.

Muestra
CommandResult

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

Comando runShellV2

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

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

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

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

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

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

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

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se reintenta el comando si falla debido a un excepción. Se arrojará DeviceNotResponseException si se cumplen las siguientes condiciones: retryAttempts se realizó sin éxito.

Muestra
CommandResult

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

fastbootWipePartition.

public abstract CommandResult fastbootWipePartition (String partition)

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

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

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

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

Muestra
CommandResult el CommandResult, que contiene la salida del comando

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

getApiLevel.

public abstract int getApiLevel ()

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

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

getBatería

public abstract Integer getBattery ()

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

Muestra
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Muestra el valor booleano de la propiedad especificada.

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

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

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

Arroja
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

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

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

Arroja
DeviceNotAvailableException

getBootHistoryDesde

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

timeUnit TimeUnit: Es la unidad de tiempo TimeUnit.

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

Arroja
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

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

getBuildAlias

public abstract String getBuildAlias ()

Recupera 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 el ID de compilación (generalmente, un número del para las versiones de Nexus). Por ejemplo, la versión final de Android 4.2 tiene el alias de compilación JDQ39 y el ID de compilación. 573038

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor.

public abstract String getBuildFlavor ()

Recupera la variante de compilación para el dispositivo.

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildSigningKeys.

public abstract String getBuildSigningKeys ()

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

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

Muestra
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

Muestra
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Muestra la conexión asociada con el dispositivo.

Muestra
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Obtén la clase de dispositivo.

Muestra
String la clase de dispositivo String

getDeviceDate

public abstract long getDeviceDate ()

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

Muestra
long la fecha del dispositivo en formato epoch.

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor.

public abstract DeviceDescriptor getDeviceDescriptor ()

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

Muestra
DeviceDescriptor

getDeviceDescriptor.

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

Muestra
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Obtén el estado del dispositivo.

Muestra
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Es una herramienta de ayuda para obtener la diferencia de hora entre el dispositivo y un ERROR(/Date) determinado. Cómo usar el tiempo de ciclo de entrenamiento internamente.

Parámetros
date Date

Muestra
long la diferencia en milisegundos

Arroja
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

Muestra
InputStreamSource salida del emulador

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

Muestra
long la cantidad de espacio libre en KB

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

getFastbootProductType

public abstract 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á que debe recuperar el dispositivo en fastboot si se encuentra en un estado incorrecto o que no responden.

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

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

getFastbootProductVariant

public abstract 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á que debe recuperar el dispositivo en fastboot si se encuentra en un estado incorrecto o que no responden.

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

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

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Devuelve el número de serie del modo fastboot.

Muestra
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

Arroja
Excepción de operación no admitida
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Recupera una referencia a un archivo remoto en el dispositivo.

Parámetros
path String: Es la ruta del archivo que se recuperará. Puede ser una ruta de acceso absoluta o relativa a “/”. (p. ej., "/system" y "sistema" se admite la sintaxis)

Muestra
IFileEntry IFileEntry o null si el archivo en el path especificado no puede que lo encuentren

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Muestra una referencia al IDevice de ddmlib asociado.

DDMS puede asignar un nuevo IDevice cada vez que el dispositivo se desconecta y se reconecta desde adb. Por lo tanto, los llamadores no deben mantener una referencia a IDevice. porque esa referencia podría quedar obsoleta.

Muestra
IDevice IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Muestra el valor entero de la propiedad determinada del dispositivo.

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

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

Muestra
long el valor de la propiedad o defaultValue si la propiedad está vacía o no existe o no tiene un valor entero.

Arroja
DeviceNotAvailableException

getLastExpectedRestartTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

Muestra
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getLogcat.

public abstract InputStreamSource getLogcat ()

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

Funciona en dos modos:

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

    Muestra
    InputStreamSource

  • getLogcat.

    public abstract InputStreamSource getLogcat (int maxBytes)

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

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

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

    Muestra
    InputStreamSource

    getLogcatDump.

    public abstract InputStreamSource getLogcatDump ()

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

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

    Muestra
    InputStreamSource un InputStreamSource de los datos de logcat Se muestra una transmisión vacía si falla. para capturar datos de Logcat.

    getLogcatdesde.

    public abstract InputStreamSource getLogcatSince (long date)

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

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

    Muestra
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

    Muestra un punto de activación.

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

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

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

    Muestra
    String el punto de activación o null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    Parámetros
    mountpoint String

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

    Arroja
    DeviceNotAvailableException

    getMountPointInfo

    public abstract  getMountPointInfo ()

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

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

    Arroja
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

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

    Parámetros
    partition String

    Muestra
    long la cantidad de espacio libre en KB

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

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

    El método de ayuda ejecuta el elemento “pidof”. y "estadísticas" y muestra el objeto ProcessInfo con Es el PID y la hora de inicio del proceso determinado.

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

    Muestra
    ProcessInfo ProcessInfo de processName determinado

    Arroja
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

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

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

    Muestra
    String

    Arroja
    DeviceNotAvailableException

    getProductType

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

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

    Arroja
    DeviceNotAvailableException Si se pierde la conexión con el dispositivo y no se puede recuperarse o si no se puede determinar el tipo de producto

    getProductVariant

    public abstract String getProductVariant ()

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

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

    Muestra
    String el nombre de la variante del producto String o null si no se puede determinado

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

    getProperty

    public abstract String getProperty (String name)

    Recupera el valor de propiedad determinado del dispositivo.

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

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getRecoveryMode.

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

    getSerialNumber

    public abstract String getSerialNumber ()

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

    Muestra
    String el número de serie de String

    getTombstones

    public abstract  getTombstones ()

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

    es el mejor esfuerzo, así que si una tombstone no se puede extraer por algún motivo, será que falta en la lista. Solo una DeviceNotAvailableException finalizará el método. desde el principio.

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

    Arroja
    DeviceNotAvailableException

    getTotalMemory

    public abstract long getTotalMemory ()

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

    Muestra
    long

    getTrackingSerial

    public String getTrackingSerial ()

    Para la administración de dispositivos, obtén el número de serie que se usa para rastrear el dispositivo.

    Muestra
    String

    getUseFastbootBorra

    public abstract boolean getUseFastbootErase ()

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

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

    RaízAdB

    public abstract boolean isAdbRoot ()

    Muestra
    boolean true si el dispositivo tiene raíz de adb. De lo contrario, es false.

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

    isAdbTcp

    public abstract boolean isAdbTcp ()

    Muestra
    boolean true si el dispositivo está conectado a adb-over-tcp, false de lo contrario.

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

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

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Verifica si el elemento debugfs está activado.

    Muestra
    boolean true si se activa "debugfs"

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Muestra si el dispositivo está encriptado.

    Muestra
    boolean Es true si el dispositivo está encriptado.

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

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

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

    Parámetros
    deviceFilePath String

    Muestra
    boolean

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Compatible con la encriptación

    public abstract boolean isEncryptionSupported ()

    Se devuelve si el dispositivo admite la encriptación.

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Se puede ejecutar

    public abstract boolean isExecutable (String fullPath)

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

    Parámetros
    fullPath String

    Muestra
    boolean

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Sin interfaz gráfica

    public abstract boolean isHeadless ()

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

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

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

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

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

    Muestra
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Recopila y registra ANR del dispositivo.

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

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

    Arroja
    DeviceNotAvailableException

    Dispositivo de acceso

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

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

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

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

    format String: Es el formato del mensaje.

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

    monteDebugfs

    public abstract void mountDebugfs ()

    Activa Debugfs.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    reinicio no bloqueado

    public abstract void nonBlockingReboot ()

    Emite un comando para reiniciar el dispositivo y regresa cuando se completa el comando cuando el dispositivo no está en funcionamiento. visible para adb.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Configuración posterior al arranque

    public abstract void postBootSetup ()

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

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

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

    A donde se debería llamar es cuando el dispositivo se reinicia debido a otros eventos (p. ej., cuando un se completó el comando de actualización de fastboot)

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

    TearDown después de la invocación

    public void postInvocationTearDown ()

    Este método dejó de estar disponible.
    En su lugar, usa postInvocationTearDown(Throwable).

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

    TearDown después de la invocación

    public abstract void postInvocationTearDown (Throwable invocationException)

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

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

    Configuración previa a la invocación

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

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

    Parámetros
    info IBuildInfo: El IBuildInfo del dispositivo.

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

    Arroja
    com.android.tradefed.targetprep.TargetSetupError
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

    Extrae contenido del directorio del dispositivo de manera recurrente.

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

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

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

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

    pullDir

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

    Extrae contenido del directorio del dispositivo de manera recurrente.

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

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

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

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

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

    Archivo pull

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

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

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

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

    Muestra
    File Una ERROR(/File) con el contenido del archivo del dispositivo, o null si el elemento no se pudo copiar por algún motivo (incluidos los problemas con el sistema de archivos del host).

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

    Archivo pull

    public abstract File pullFile (String remoteFilePath)

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

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

    Muestra
    File Una ERROR(/File) con el contenido del archivo del dispositivo, o null si el elemento no se pudo copiar por algún motivo (incluidos los problemas con el sistema de archivos del host).

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

    Archivo pull

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

    Recupera un archivo fuera del dispositivo.

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

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

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

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

    Archivo pull

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

    Recupera un archivo fuera del dispositivo.

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

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

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

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

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

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

    Recupera un archivo fuera del dispositivo y muestra el contenido.

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

    Muestra
    String Una String con el contenido del archivo del dispositivo, o null si el elemento no se pudo copiar por algún motivo (incluidos los problemas con el sistema de archivos del host).

    Arroja
    DeviceNotAvailableException

    extraerArchivoDeexterno

    public abstract File pullFileFromExternal (String remoteFilePath)

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

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

    Muestra
    File Una ERROR(/File) con el contenido del archivo del dispositivo, o null si el elemento no se pudo copiar por algún motivo (incluidos los problemas con el sistema de archivos del host).

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

    PushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath, 
                    int userId)

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

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

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

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

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

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

    PushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath, 
                     excludedDirectories)

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

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

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

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

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

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

    PushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

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

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

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

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

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

    Archivo push

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    boolean evaluateContentProviderNeeded)

    Variante de pushFile(File, String) que puede considerar de manera opcional evaluar la necesidad para el proveedor de contenido.

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

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

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

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

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

    Archivo push

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

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

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

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

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

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

    Archivo push

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    int userId)

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

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

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

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

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

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

    PushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

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

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

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

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

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

    reiniciar

    public abstract void reboot ()

    Reinicia el dispositivo en modo adb.

    Se bloquea hasta que el dispositivo esté disponible.

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después de reiniciar el dispositivo

    reiniciar

    public abstract void reboot (String reason)

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

    Se bloquea hasta que el dispositivo esté disponible.

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

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

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después de reiniciar el dispositivo

    reiniciarIntoBootloader

    public abstract void rebootIntoBootloader ()

    Reinicia el dispositivo en el modo de bootloader.

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

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

    reiniciarIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Reinicia el dispositivo en el modo fastbootd.

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

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

    reinicio en la recuperación

    public abstract void rebootIntoRecovery ()

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

    Se bloquea hasta que el dispositivo entre en recuperación

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después de reiniciar el dispositivo

    reiniciarIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

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

    Se bloquea hasta que el dispositivo entre en modo de transferencia

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

    Arroja
    DeviceNotAvailableException si el dispositivo no se transfiere después de reiniciar el dispositivo

    reiniciarIntoSideload

    public abstract void rebootIntoSideload ()

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

    Se bloquea hasta que el dispositivo entre en modo de transferencia

    Arroja
    DeviceNotAvailableException si el dispositivo no está en side-load después de reiniciar.

    reiniciarHastaEn línea

    public abstract void rebootUntilOnline ()

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

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después de reiniciar el dispositivo

    reiniciarHastaEn línea

    public abstract void rebootUntilOnline (String reason)

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

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

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después de reiniciar el dispositivo

    También:

    espacio de usuario de reinicio

    public abstract void rebootUserspace ()

    Reinicia solo una parte del espacio del usuario del dispositivo.

    Se bloquea hasta que el dispositivo esté disponible.

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

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después de reiniciar el dispositivo

    reiniciarelespaciodeusuarioHastaEn línea

    public abstract void rebootUserspaceUntilOnline ()

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

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después de reiniciar el dispositivo

    remountSystemReadOnly

    public abstract void remountSystemReadOnly ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountSystemWritable

    public abstract void remountSystemWritable ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendor (solo lectura)

    public abstract void remountVendorReadOnly ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorWritable

    public abstract void remountVendorWritable ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    runInstrumentationTests

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

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

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

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

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

    Arroja
    DeviceNotAvailableException Si se pierde la conexión con el dispositivo y no se puede recuperarse. es decir, no se pudo completar el comando de prueba y falló la recuperación.

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

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

    Si se pierde la conexión con el dispositivo antes de que se complete la ejecución de prueba y la recuperación se completa correctamente, a los objetos de escucha se les informará sobre testRunFailed y “false”. se devolverán. El comando de prueba no se volverán a ejecutar. Los emisores deben volver a intentarlo si es necesario.

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

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

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

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

    Arroja
    DeviceNotAvailableException Si se pierde la conexión con el dispositivo y no se puede recuperarse. es decir, no se pudo completar el comando de prueba y falló la recuperación.

    runInstrumentationTestsComoUsuario

    public abstract boolean 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 determinado.

    Parámetros
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    runInstrumentationTestsComoUsuario

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

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

    Parámetros
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    Configurar Fecha

    public abstract void setDate (Date date)

    Establece la fecha en el dispositivo

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

    Parámetros
    date Date: Especifica una fecha en particular. utilizará la fecha de host si null

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Establece el TestDeviceOptions para el dispositivo.

    Parámetros
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                    String propValue)

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

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

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

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

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

    Parámetros
    recovery IDeviceRecovery: el IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

    Se usa para controlar qué método de recuperación usar cuando ocurre un problema de comunicación del dispositivo que encuentran. Se recomienda usar este método con moderación solo cuando sea necesario (por ejemplo, cuando el framework no funciona, etcétera

    Parámetros
    mode ITestDevice.RecoveryMode: si la recuperación es solo hasta que finalice en línea el modo debe estar activado o no.

    setTrackingSerial

    public abstract void setTrackingSerial (String trackingSerial)

    Para la administración de dispositivos, realiza un seguimiento del número de serie que usamos para referirnos al dispositivo.

    Parámetros
    trackingSerial String

    setUsarInicioRápidoBorrar

    public abstract void setUseFastbootErase (boolean useFastbootErase)

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

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

    startLogcat

    public abstract void startLogcat ()

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

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

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

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

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Cierra y borra el resultado del emulador.

    detenerLogcat

    public abstract void stopLogcat ()

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

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

    cambiarAAdbTcp

    public abstract String switchToAdbTcp ()

    Cambia el dispositivo al modo adb-over-tcp.

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    cambiarAAdbusb

    public abstract boolean switchToAdbUsb ()

    Cambia el dispositivo al modo adb mediante USB.

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Archivos sincronizados

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

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

    Decide qué archivos enviar comparando las marcas de tiempo de los archivos locales con su recurso remoto equivalentes. Solo “más nuevos” o los archivos inexistentes se enviarán al dispositivo. Por lo tanto, la sobrecarga debe ser relativamente pequeño si el archivo configurado en el dispositivo ya está actualizado.

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

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

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

    deviceFilePath String: Es la raíz de la ruta de acceso absoluta del archivo de destino remoto. Todos los directorios en estos la ruta del archivo debe ser legible. Es decir, enviar a /data/local/tmp cuando adb no tiene permisos de administrador. fallará

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

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

    desbloquearDispositivo

    public abstract boolean unlockDevice ()

    Desbloquea el dispositivo si está encriptado.

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

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

    Arroja
    DeviceNotAvailableException Si se pierde la conexión con el dispositivo y no se puede recuperarse.
    UnsupportedOperationException si el dispositivo no admite la encriptación.

    unmountDebugfs

    public abstract void unmountDebugfs ()

    Desactiva Debugfs.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

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

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

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable ()

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

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

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

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable (long waitTime)

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

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

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

    Arroja
    DeviceNotAvailableException Si el dispositivo aún no responde después de que se acabe el tiempo de espera.

    waitForDeviceAvailableInRecoverPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

    Parámetros
    waitTime long

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

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

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

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

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

    waitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

    Bloqueos para que el dispositivo esté en la "recuperación de adb" (ten en cuenta que esto es diferente de IDeviceRecovery).

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

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

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Bloqueos para que el dispositivo esté en la "transferencia de adb" estado

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

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

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

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

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

    waitForDeviceEn línea

    public abstract void waitForDeviceOnline ()

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

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

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

    waitForDeviceEn línea

    public abstract void waitForDeviceOnline (long waitTime)

    Se bloquea hasta que el dispositivo sea visible mediante adb.

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

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

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

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

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

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

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