Dispositivo nativo
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
ITestLoggerReceiver
Objeto java.lang. | |
↳ | com.android.tradefed.device.NativeDevice |
Implementación predeterminada de un dispositivo Android ITestDevice
que no es de pila completa.
Resumen
Clases anidadas | |
---|---|
class |
NativeDevice.AdbAction
Un |
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
Constantes | |
---|---|
int |
INVALID_USER_ID
Valor que se muestra para cualquier ID de usuario no válido o no encontrado: UserHandle definió el valor -10000 |
long |
MAX_HOST_DEVICE_TIME_OFFSET
|
int |
MAX_RETRY_ATTEMPTS
la cantidad predeterminada de reintentos de comando para realizar |
Campos | |
---|---|
public
static
final
String |
DEBUGFS_PATH
|
protected
static
final
String |
SD_CARD
|
protected
static
final
String |
STORAGE_EMULATED
|
protected
TestDeviceOptions |
mOptions
|
protected
final
IDeviceStateMonitor |
mStateMonitor
|
Constructores públicos | |
---|---|
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Crea un |
Métodos públicos | |
---|---|
void
|
batchPrefetchStartupBuildProps()
Microoptimización (alrededor de 400 milis) mediante la carga previa de todas las props que necesitamos, en lugar de llamar a "adb getprop para cada uno. |
boolean
|
canSwitchToHeadlessSystemUser()
Muestra si se le permite cambiar al usuario de SYSTEM sin interfaz gráfica. |
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
Comprobar si una función es compatible actualmente con un nivel mínimamente admitido |
boolean
|
checkConnectivity()
Verifica que el dispositivo tenga conectividad de red. |
boolean
|
clearErrorDialogs()
Intenta descartar los diálogos de error que se muestran actualmente en la IU del dispositivo. |
void
|
clearLastConnectedWifiNetwork()
Borra la última red Wi-Fi conectada. |
void
|
clearLogcat()
Borra todos los datos acumulados de logcat. |
boolean
|
connectToWifiNetwork(
Se conecta a una red Wi-Fi. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Se conecta a una red Wi-Fi. |
boolean
|
connectToWifiNetwork(
Se conecta a una red Wi-Fi. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
Se conecta a una red Wi-Fi. |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
Una variante de |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
Una variante de |
int
|
createUser(String name, boolean guest, boolean ephemeral)
Crea un usuario con un nombre determinado y las marcas proporcionadas |
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Crea un usuario con un nombre determinado y las marcas proporcionadas |
int
|
createUser(String name)
Crea un usuario con un nombre determinado y las marcas predeterminadas 0. |
int
|
createUserNoThrow(String name)
Crea un usuario con un nombre determinado y las marcas predeterminadas 0. |
void
|
deleteFile(String deviceFilePath, int userId)
Es un método de ayuda para borrar un archivo o directorio del dispositivo. |
void
|
deleteFile(String deviceFilePath)
Es un método de ayuda para borrar un archivo o directorio del dispositivo. |
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Quita el |
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 |
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 |
boolean
|
disableAdbRoot()
Desactiva la raíz de adb. |
void
|
disableKeyguard()
Intenta inhabilitar el bloqueo del teclado. |
boolean
|
disableNetworkMonitor()
Inhabilita la supervisión de red en el dispositivo. |
boolean
|
disconnectFromWifi()
Se desconecta de una red Wi-Fi. |
boolean
|
doesFileExist(String deviceFilePath, int userId)
Es un método de ayuda para determinar si existe un archivo en el dispositivo para un usuario determinado. |
boolean
|
doesFileExist(String deviceFilePath)
Es un método de ayuda para determinar si existe un archivo en el dispositivo. |
File
|
dumpHeap(String process, String devicePath)
Intenta volcar el montón desde system_server. |
boolean
|
enableAdbRoot()
Activa la raíz de adb. |
boolean
|
enableNetworkMonitor()
Habilita la supervisión de red en el dispositivo. |
String
|
executeAdbCommand(long timeout, String... cmdArgs)
Método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera especificado. |
String
|
executeAdbCommand(long timeout,
Método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera especificado. |
String
|
executeAdbCommand(String... cmdArgs)
Es un método de ayuda que ejecuta un comando adb como un comando del sistema. |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
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. |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
Es un método de ayuda que ejecuta un comando fastboot como un comando del sistema. |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
Es un método de ayuda que ejecuta un comando fastboot de larga duración como un comando del sistema. |
CommandResult
|
executeLongFastbootCommand(
Método de ayuda que ejecuta un comando fastboot de larga duración como un comando del sistema con el sistema variables de entorno. |
String
|
executeShellCommand(String command)
Es un método de ayuda que ejecuta un comando shell de adb y muestra el resultado como |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
Ejecuta el comando shell de adb determinado y vuelve a intentarlo varias veces si el comando falla. |
CommandResult
|
executeShellV2Command(String cmd)
Es un método auxiliar que ejecuta un comando shell de adb y muestra los resultados como un |
CommandResult
|
executeShellV2Command(String cmd, OutputStream pipeToOutput)
Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como un |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput)
Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como un |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando. |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando. |
CommandResult
|
fastbootWipePartition(String partition)
Es un método de ayuda que borra una partición del dispositivo. |
|
getActiveApexes()
Recupera la información sobre los APEX activados en el dispositivo. |
|
getAllSettings(String namespace)
Muestra los pares clave-valor del espacio de nombres solicitado. |
DeviceAllocationState
|
getAllocationState()
Devuelve el estado de asignación actual del dispositivo |
String
|
getAndroidId(int userId)
Busca y muestra el android-id asociado con un userId (valor nulo si no se encuentra). |
|
getAndroidIds()
Crea un mapa de los ID de Android encontrados que coincidan con los ID de usuario. |
int
|
getApiLevel()
Obtén el nivel de API del dispositivo. |
PackageInfo
|
getAppPackageInfo(String packageName)
Recupera información sobre un paquete instalado en el dispositivo. |
|
getAppPackageInfos()
Recupera información de paquetes instalados en el dispositivo. |
String
|
getBasebandVersion()
Método de conveniencia para obtener la versión de banda base (radio) de este dispositivo. |
Integer
|
getBattery()
Muestra el nivel de batería actual de un dispositivo o Valor Nulo si el nivel de batería no está disponible. |
boolean
|
getBooleanProperty(String name, boolean defaultValue)
Muestra el valor booleano de la propiedad especificada. |
|
getBootHistory()
El método auxiliar recopila el mapa del historial de inicio con el tiempo y el motivo de inicio. |
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
El método 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. |
String
|
getBootloaderVersion()
Método de conveniencia para obtener la versión del bootloader de este dispositivo. |
InputStreamSource
|
getBugreport()
Recupera un informe de errores del dispositivo. |
InputStreamSource
|
getBugreportz()
Recupera un bugreportz del dispositivo. |
String
|
getBuildAlias()
Recupera el alias de la compilación que el dispositivo está ejecutando actualmente. |
String
|
getBuildFlavor()
Recupera la variante de compilación para el dispositivo. |
String
|
getBuildId()
Recupera la compilación que el dispositivo está ejecutando actualmente. |
String
|
getBuildSigningKeys()
Devuelve el tipo de clave usado para firmar la imagen del dispositivo Por lo general, los dispositivos Android se pueden firmar con claves de prueba (como en AOSP) o de lanzamiento. (controlado por fabricantes de dispositivos individuales) |
DeviceDescriptor
|
getCachedDeviceDescriptor()
Devuelve un |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Devuelve un |
String[]
|
getChildren(String path)
Es una alternativa al uso de |
AbstractConnection
|
getConnection()
La conexión actual asociada con el dispositivo. |
ContentProviderHandler
|
getContentProvider(int userId)
Muestra |
DeviceFoldableState
|
getCurrentFoldableState()
Muestra el estado plegable actual del dispositivo o un valor nulo si se produjeron algunos problemas. |
int
|
getCurrentUser()
Muestra el ID del usuario en ejecución actual. |
String
|
getDeviceClass()
Obtén la clase de dispositivo. |
long
|
getDeviceDate()
Muestra la fecha del dispositivo en milisegundos desde el ciclo de entrenamiento. |
DeviceDescriptor
|
getDeviceDescriptor()
Muestra un |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Muestra un |
TestDeviceState
|
getDeviceState()
Obtén el estado del dispositivo. |
long
|
getDeviceTimeOffset(Date date)
Es una herramienta de ayuda para obtener la diferencia de hora entre el dispositivo y un |
InputStreamSource
|
getEmulatorOutput()
Cómo obtener la transmisión de stdout y stderr del emulador |
Process
|
getEmulatorProcess()
Muestra el |
final
File
|
getExecuteShellCommandLog()
El registro que contiene todos los registros de |
long
|
getExternalStoreFreeSpace()
Es un método de ayuda para determinar la cantidad de espacio libre en el almacenamiento externo del dispositivo. |
String
|
getFastbootPath()
Muestra la ruta de acceso del objeto binario de fastboot que se usa. |
String
|
getFastbootProductType()
Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo fastboot. |
String
|
getFastbootProductVariant()
Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo fastboot. |
String
|
getFastbootSerialNumber()
Devuelve el número de serie del modo fastboot. |
String
|
getFastbootVariable(String variableName)
Recupera el valor de la variable de fastboot específico del dispositivo. |
String
|
getFastbootVersion()
Muestra la cadena de versión del objeto binario de fastboot que se usa. |
IFileEntry
|
getFileEntry(String path)
Recupera una referencia a un archivo remoto en el dispositivo. |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
Es un asistente no oficial para obtener un |
|
getFoldableStates()
Devuelve la lista de estados plegables en el dispositivo. |
IDevice
|
getIDevice()
Muestra una referencia al |
|
getInstalledPackageNames()
Recupera los nombres de paquetes de aplicaciones presentes en el dispositivo. |
long
|
getIntProperty(String name, long defaultValue)
Muestra el valor entero de la propiedad determinada del dispositivo. |
String
|
getIpAddress()
Obtiene la dirección IP del dispositivo. |
KeyguardControllerState
|
getKeyguardState()
Muestra un objeto para obtener el estado actual de la protección de teclado o un valor nulo si no se admite. |
long
|
getLastExpectedRebootTimeMillis()
Devuelve la última vez que las APIs de Tradefed activaron un reinicio en milisegundos desde EPOCH, como
que devuelve |
int
|
getLaunchApiLevel()
Obtener el primer nivel de API iniciado en el dispositivo |
InputStreamSource
|
getLogcat()
Captura una transmisión de instantáneas de los datos de Logcat. |
InputStreamSource
|
getLogcat(int maxBytes)
Captura una transmisión de instantáneas del último |
InputStreamSource
|
getLogcatDump()
Obtén un volcado del logcat actual del dispositivo. |
InputStreamSource
|
getLogcatSince(long date)
Captura una transmisión de instantáneas de los datos capturados de logcat a partir de la fecha proporcionada. |
String
|
getMacAddress()
Devuelve la dirección MAC del dispositivo, nula si no se puede consultar desde el dispositivo. |
Integer
|
getMainUserId()
Muestra el ID de usuario principal. |
|
getMainlineModuleInfo()
Obtén información sobre los módulos de línea principales instalados en el dispositivo. |
int
|
getMaxNumberOfRunningUsersSupported()
Obtén la cantidad máxima de usuarios que se ejecutan de manera simultánea. |
int
|
getMaxNumberOfUsersSupported()
Obtén la cantidad máxima de usuarios admitidos. |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
Devuelve el |
String
|
getMountPoint(String mountName)
Muestra un punto de activación. |
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
Muestra un |
|
getMountPointInfo()
Devuelve una versión analizada de la información en /proc/mounts en el dispositivo. |
TestDeviceOptions
|
getOptions()
Recupera las opciones de prueba para el dispositivo. |
long
|
getPartitionFreeSpace(String partition)
Método de ayuda para determinar la cantidad de espacio libre en la partición del dispositivo. |
Integer
|
getPrimaryUserId()
Muestra el ID de usuario principal. |
ProcessInfo
|
getProcessByName(String processName)
El método de ayuda ejecuta el elemento “pidof”. y "estadísticas" y muestra el objeto |
String
|
getProcessPid(String process)
Muestra el pid del servicio o un valor nulo si se produjo un error. |
String
|
getProductType()
Método de conveniencia para obtener el tipo de producto de este dispositivo. |
String
|
getProductVariant()
Es un método de conveniencia para obtener la variante de producto de este dispositivo. |
String
|
getProperty(String name)
Recupera el valor de propiedad determinado del dispositivo. |
ITestDevice.RecoveryMode
|
getRecoveryMode()
Obtén el modo de recuperación que se usa actualmente para el dispositivo. |
InputStreamSource
|
getScreenshot(String format)
Toma una captura de pantalla del dispositivo. |
InputStreamSource
|
getScreenshot(long displayId)
Toma una captura de pantalla del ID de visualización del dispositivo. |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Toma una captura de pantalla del dispositivo. |
InputStreamSource
|
getScreenshot()
Toma una captura de pantalla del dispositivo. |
String
|
getSerialNumber()
Método de conveniencia para obtener el número de serie de este dispositivo. |
String
|
getSetting(int userId, String namespace, String key)
Muestra el valor de la configuración solicitada. |
String
|
getSetting(String namespace, String key)
Consulta |
String
|
getSimOperator()
Muestra el operador de la tarjeta SIM o un valor nulo si no está disponible o si el dispositivo no está disponible. |
String
|
getSimState()
Devuelve el estado de la tarjeta SIM o es nulo si no está disponible o el dispositivo no está disponible. |
|
getTombstones()
Recupera y muestra la lista de tombstones de los dispositivos. |
long
|
getTotalMemory()
Devuelve el tamaño total de la memoria física en bytes o -1 en caso de error interno. |
String
|
getTrackingSerial()
Para la administración de dispositivos, obtén el número de serie que se usa para rastrear el dispositivo. |
|
getUninstallablePackageNames()
Recupera los nombres de los paquetes de aplicaciones que se pueden desinstalar. |
boolean
|
getUseFastbootErase()
Determina si se debe usar el formato de fastboot o borrado de fastboot para limpiar una partición del dispositivo. |
int
|
getUserFlags(int userId)
Busca y muestra las marcas de un usuario determinado. |
|
getUserInfos()
Obtiene el mapa de useId como |
int
|
getUserSerialNumber(int userId)
Devuelve el número de serie asociado con el userId si lo encuentras; -10000 en cualquier otro caso. |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
Procesa un DeviceEvent determinado. Procesar el DeviceEvent, lo que puede o no hacer la transición de este dispositivo a una nueva asignación para cada estado. |
boolean
|
hasFeature(String feature)
Comprueba si una función está disponible en un dispositivo. |
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Instala un paquete de Android en el dispositivo. |
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Instala un paquete de Android en el dispositivo. |
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Instala un paquete de Android en el dispositivo para un usuario determinado. |
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Instala un paquete de Android en el dispositivo para un usuario determinado. |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
boolean
|
isAppEnumerationSupported()
Cómo comprobar si la plataforma en el dispositivo admite la enumeración de apps |
boolean
|
isBypassLowTargetSdkBlockSupported()
Verifica si la plataforma en el dispositivo admite la omisión del bloqueo del SDK de destino bajo en las instalaciones de apps |
boolean
|
isDebugfsMounted()
Verifica si el elemento debugfs está activado. |
boolean
|
isDeviceEncrypted()
Muestra si el dispositivo está encriptado. |
boolean
|
isDirectory(String path)
Muestra el valor True si la ruta de acceso en el dispositivo es un directorio. De lo contrario, muestra false. |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
Se devuelve si el dispositivo admite la encriptación. |
boolean
|
isExecutable(String fullPath)
Muestra el valor True si la ruta de acceso al archivo en el dispositivo es ejecutable. De lo contrario, muestra false. |
boolean
|
isFastbootEnabled()
Muestra si fastboot está disponible para el dispositivo. |
boolean
|
isHeadless()
Muestra true si el dispositivo no tiene interfaz gráfica (sin pantalla). De lo contrario, muestra false. |
boolean
|
isHeadlessSystemUserMode()
Indica si el dispositivo usa el modo de usuario del sistema sin interfaz gráfica. |
boolean
|
isMainUserPermanentAdmin()
Muestra si el usuario principal es un administrador permanente y si no se puede borrar ni cambiar a una versión inferior no es administrador. |
boolean
|
isMultiUserSupported()
Determina si se admite multiusuario. |
boolean
|
isPackageInstalled(String packageName, String userId)
Consulta el dispositivo para obtener un nombre de paquete y un ID de usuario determinados para comprobar si está actualmente instalado o no para ese usuario. |
boolean
|
isPackageInstalled(String packageName)
Consulta el dispositivo para obtener un nombre de paquete determinado para comprobar si está instalado o no. |
boolean
|
isRuntimePermissionSupported()
Verifica si la plataforma integrada en el dispositivo admite el otorgamiento de permisos de tiempo de ejecución |
boolean
|
isStateBootloaderOrFastbootd()
Muestra true si el dispositivo está en |
boolean
|
isUserRunning(int userId)
Verifica si un usuario determinado está en ejecución. |
boolean
|
isUserSecondary(int userId)
Muestra si el usuario especificado es un usuario secundario según sus marcas. |
boolean
|
isUserVisible(int userId)
Comprueba si el usuario especificado es visible. |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Comprueba si el usuario determinado es visible en la pantalla determinada. |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Muestra si el dispositivo permite que los usuarios se inicien visibles en segundo plano en |
boolean
|
isVisibleBackgroundUsersSupported()
Muestra si el dispositivo permite que los usuarios se inicien visibles en segundo plano. |
boolean
|
isWifiEnabled()
Prueba si el Wi-Fi está habilitado. |
|
listDisplayIds()
Recopila la lista de ID de pantallas disponibles en el dispositivo según lo informa "dumpsys". SurfaceFlinger”. |
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Obtiene la lista de pantallas que se pueden usar para |
|
listUsers()
Obtiene la lista de usuarios en el dispositivo. |
boolean
|
logAnrs(ITestLogger logger)
Recopila y registra ANR del dispositivo. |
boolean
|
logBugreport(String dataName, ITestLogger listener)
Es un método de ayuda para tomar un informe de errores y registrarlo en los generadores. |
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
Registra un mensaje en el logcat del dispositivo. |
void
|
mountDebugfs()
Activa Debugfs. |
void
|
nonBlockingReboot()
Emite un comando para reiniciar el dispositivo y regresa cuando se completa el comando cuando el dispositivo no está en funcionamiento. visible para adb. |
void
|
postAdbRootAction()
Anula si el dispositivo necesita que se realicen algunas acciones específicas después de la raíz de adb y antes de que el dispositivo vuelva a estar en línea. |
void
|
postAdbUnrootAction()
Anula si el dispositivo necesita que se realicen algunas acciones específicas después de que adb desroot y antes de que el dispositivo vuelva a estar en línea. |
void
|
postBootSetup()
Sigue las instrucciones para configurar el dispositivo y probarlo después de cada inicio. |
void
|
postInvocationTearDown(Throwable exception)
Pasos adicionales para la limpieza obligatoria específica del dispositivo que se ejecutará después de la invocación el proyecto. |
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. |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Extrae contenido del directorio del dispositivo de manera recurrente. |
boolean
|
pullDir(String deviceFilePath, File localDir)
Extrae contenido del directorio del dispositivo de manera recurrente. |
boolean
|
pullFile(String remoteFilePath, File localFile)
Recupera un archivo fuera del dispositivo. |
File
|
pullFile(String remoteFilePath, int userId)
Recupera un archivo fuera del dispositivo, lo almacena en un |
File
|
pullFile(String remoteFilePath)
Recupera un archivo fuera del dispositivo, lo almacena en un |
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
Recupera un archivo fuera del dispositivo. |
String
|
pullFileContents(String remoteFilePath)
Recupera un archivo fuera del dispositivo y muestra el contenido. |
File
|
pullFileFromExternal(String remoteFilePath)
Un método útil para recuperar un archivo desde el almacenamiento externo del dispositivo, lo almacena en una
|
boolean
|
pushDir(File localFileDir, String deviceFilePath,
Envía de manera recurrente el contenido del directorio al dispositivo y, al mismo tiempo, excluye algunos directorios filtrado. |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
Envía de manera recurrente el contenido del directorio al dispositivo. |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
Envía de manera recurrente el contenido del directorio al dispositivo. |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variante de |
boolean
|
pushFile(File localFile, String remoteFilePath)
Envía un archivo al dispositivo. |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
Envía un archivo al dispositivo. |
boolean
|
pushString(String contents, String remoteFilePath)
Envío de archivo creado a partir de una cadena al dispositivo |
void
|
reboot(String reason)
Reinicia el dispositivo en modo adb con el |
void
|
reboot()
Reinicia el dispositivo en modo adb. |
void
|
rebootIntoBootloader()
Reinicia el dispositivo en el modo de bootloader. |
void
|
rebootIntoFastbootd()
Reinicia el dispositivo en el modo fastbootd. |
void
|
rebootIntoRecovery()
Reinicia el dispositivo en el modo de recuperación de adb. |
void
|
rebootIntoSideload()
Reinicia el dispositivo en el modo de transferencia de adb (ten en cuenta que se trata de un modo especial en recuperación). Se bloquea hasta que el dispositivo entre en modo de transferencia |
void
|
rebootIntoSideload(boolean autoReboot)
Reinicia el dispositivo en el modo de transferencia de adb (ten en cuenta que se trata de un modo especial en recuperación). Se bloquea hasta que el dispositivo entre en modo de transferencia |
void
|
rebootUntilOnline()
Una alternativa a |
void
|
rebootUntilOnline(String reason)
Una alternativa a |
void
|
rebootUserspace()
Reinicia solo una parte del espacio del usuario del dispositivo. |
void
|
rebootUserspaceUntilOnline()
Una alternativa a |
boolean
|
recoverDevice()
Intenta recuperar la comunicación con el dispositivo. |
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Registra un |
void
|
remountSystemReadOnly()
Haz que la partición del sistema en el dispositivo sea de solo lectura. |
void
|
remountSystemWritable()
Permite que se pueda escribir en la partición del sistema del dispositivo. |
void
|
remountVendorReadOnly()
Haz que la partición del proveedor en el dispositivo sea de solo lectura. |
void
|
remountVendorWritable()
Permitir que se pueda escribir en la partición del proveedor en el dispositivo. |
boolean
|
removeAdmin(String componentName, int userId)
Quita el administrador de dispositivo determinado de un usuario determinado y muestra |
void
|
removeOwners()
Quita a todos los propietarios de perfiles de dispositivo existentes con todo lo que puedas. |
boolean
|
removeUser(int userId)
Quitar a un usuario determinado del dispositivo |
void
|
resetContentProviderSetup()
Restablece la marca de la configuración del proveedor de contenido para volver a activarla. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Método de conveniencia para ejecutar |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
Ejecuta pruebas de instrumentación y proporciona recuperación de dispositivos. |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
Igual que |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Es igual que |
void
|
setConfiguration(IConfiguration configuration)
Inserta el |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
void
|
setDate(Date date)
Establece la fecha en el dispositivo Nota: La configuración de la fecha en el dispositivo requiere permisos de administrador |
boolean
|
setDeviceOwner(String componentName, int userId)
Establece un componente de administración de dispositivos como propietario para un usuario determinado. |
void
|
setDeviceState(TestDeviceState deviceState)
Actualiza el estado del dispositivo. |
void
|
setEmulatorOutputStream(SizeLimitedOutputStream output)
Para el emulador, configura |
void
|
setEmulatorProcess(Process p)
Establece |
void
|
setFastbootEnabled(boolean fastbootEnabled)
Configura la opción fastboot para el dispositivo. |
void
|
setFastbootPath(String fastbootPath)
Establece la ruta de acceso al objeto binario de fastboot que se debe usar. |
void
|
setIDevice(IDevice newDevice)
Actualiza el IDevice asociado con este ITestDevice. |
void
|
setLogStartDelay(int delay)
Establece el tiempo en ms que se debe esperar antes de iniciar la captura de logcat para un dispositivo en línea. |
void
|
setOptions(TestDeviceOptions options)
Establece el |
boolean
|
setProperty(String propKey, String propValue)
Establece el valor de la propiedad determinada en el dispositivo. |
void
|
setRecovery(IDeviceRecovery recovery)
Configura la |
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
Configura el modo de recuperación que se usará en el dispositivo. |
void
|
setSetting(String namespace, String key, String value)
Consulta |
void
|
setSetting(int userId, String namespace, String key, String value)
Agrega un valor de configuración al espacio de nombres de un usuario determinado. |
void
|
setTestLogger(ITestLogger testLogger)
Inserta la instancia |
void
|
setTrackingSerial(String trackingSerial)
Para la administración de dispositivos, realiza un seguimiento del número de serie que usamos para referirnos al dispositivo. |
void
|
setUseFastbootErase(boolean useFastbootErase)
Configura si quieres usar el formato de fastboot o borrado de fastboot para limpiar una partición del dispositivo. |
void
|
startLogcat()
Comienza a capturar resultados de logcat del dispositivo en segundo plano. |
boolean
|
startUser(int userId)
Inicia un usuario determinado en segundo plano si está detenido. |
boolean
|
startUser(int userId, boolean waitFlag)
Inicia un usuario determinado en segundo plano si está detenido. |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Inicia un usuario determinado en segundo plano, visible en la pantalla determinada (es decir, permitiendo al usuario para iniciar actividades en esa pantalla). |
void
|
stopEmulatorOutput()
Cierra y borra el resultado del emulador. |
void
|
stopLogcat()
Detén la captura de resultados de logcat del dispositivo y descarta los datos de logcat guardados actualmente. |
boolean
|
stopUser(int userId)
Detiene a un usuario determinado. |
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Detener un usuario determinado |
String
|
switchToAdbTcp()
Cambia el dispositivo al modo adb-over-tcp. |
boolean
|
switchToAdbUsb()
Cambia el dispositivo al modo adb mediante USB. |
boolean
|
switchUser(int userId)
Cambia a otro userId con un tiempo de espera predeterminado. |
boolean
|
switchUser(int userId, long timeout)
Cambia a otro userId con el tiempo de espera proporcionado como fecha límite. |
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Sincroniza de forma incremental el contenido de un directorio de archivos local con el dispositivo. |
Bugreport
|
takeBugreport()
Toma un informe de errores y lo muestra dentro de un objeto |
String
|
uninstallPackage(String packageName)
Desinstala un paquete de Android del dispositivo. |
String
|
uninstallPackageForUser(String packageName, int userId)
Desinstala el paquete de Android del dispositivo para un usuario determinado. |
boolean
|
unlockDevice()
Desbloquea el dispositivo si está encriptado. |
void
|
unmountDebugfs()
Desactiva Debugfs. |
boolean
|
waitForBootComplete(long timeOut)
Se bloquea hasta que se establezca la marca de inicio completado del dispositivo. |
boolean
|
waitForDeviceAvailable()
Espera a que el dispositivo responda y esté disponible para las pruebas. |
boolean
|
waitForDeviceAvailable(long waitTime)
Espera a que el dispositivo responda y esté disponible para las pruebas. |
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Espera a que el dispositivo responda y esté disponible sin considerar la ruta de recuperación. |
void
|
waitForDeviceBootloader()
Se bloquea hasta que el dispositivo sea visible mediante fastboot. |
boolean
|
waitForDeviceInRecovery(long waitTime)
Bloqueos para que el dispositivo esté en la "recuperación de adb" (ten en cuenta que esto es distinto de
|
boolean
|
waitForDeviceInSideload(long waitTime)
Bloqueos para que el dispositivo esté en la "transferencia de adb" estado |
boolean
|
waitForDeviceNotAvailable(long waitTime)
Bloqueos para que el dispositivo no esté disponible, es decir, falta en adb |
void
|
waitForDeviceOnline()
Se bloquea hasta que el dispositivo sea visible mediante adb. |
void
|
waitForDeviceOnline(long waitTime)
Se bloquea hasta que el dispositivo sea visible mediante adb. |
boolean
|
waitForDeviceShell(long waitTime)
Espera a que el dispositivo responda a un comando shell adb básico. |
Métodos protegidos | |
---|---|
void
|
addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
|
String[]
|
buildAdbShellCommand(String command, boolean forceExitStatusDetection)
Compila el comando de SO para la sesión y los argumentos del comando de shell adb determinados. |
void
|
checkApiLevelAgainst(String feature, int strictMinLevel)
|
NativeDevice.RebootDeviceAction
|
createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)
Crea un |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
Ejecuta un reinicio de adb. |
void
|
ensureRuntimePermissionSupported()
un método auxiliar para arrojar una excepción si no se admite el permiso de tiempo de ejecución |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
Obtén la instancia de |
void
|
initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
|
String
|
internalGetProperty(String propName, String fastbootVar, String description)
Recupera una propiedad de dispositivo, a partir de la caché de ddmlib de forma predeterminada, y recurrir a "adb" shell getprop` o `fastboot getvar`, según si el dispositivo está en Fastboot o no. |
boolean
|
isInRebootCallback()
Muestra si las devoluciones de llamada de reinicio se están ejecutando o no. |
boolean
|
isNewer(File localFile, IFileEntry entry)
Muestra |
void
|
notifyRebootEnded()
Notifica a todos los |
void
|
notifyRebootStarted()
Notifica a todos los |
boolean
|
performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Realiza una acción en este dispositivo. |
void
|
postAdbReboot()
Posibles acciones adicionales que se pueden realizar después de reiniciar el dispositivo. |
void
|
prePostBootSetup()
Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) anule este método para una configuración específica posterior al inicio. |
boolean
|
pullFileInternal(String remoteFilePath, File localFile)
|
void
|
setClock(Clock clock)
Configura la instancia de reloj que se usará. |
void
|
setMicrodroidProcess(Process process)
Marca el TestDevice como microdroid y establece su CID. |
void
|
setTestDeviceOptions(
|
CommandResult
|
simpleFastbootCommand(long timeout,
Ejecuta un comando fastboot simple con variables de entorno e informa el estado de la kubectl. |
CommandResult
|
simpleFastbootCommand(long timeout, String[] fullCmd)
Ejecuta un comando fastboot simple y, luego, informa el estado del comando. |
boolean
|
waitForDeviceNotAvailable(String operationDesc, long time)
Espera a que el dispositivo deje de estar disponible (deja de informar a adb). |
Constantes
ID DE USUARIO NO VÁLIDO
public static final int INVALID_USER_ID
Valor que se muestra para cualquier ID de usuario no válido o no encontrado: UserHandle definió el valor -10000
Valor constante: -10,000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
Valor constante: 5,000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
la cantidad predeterminada de reintentos de comando para realizar
Valor constante: (2) (0x00000002)
Campos
RUTA_DE_BUGFS
public static final String DEBUGFS_PATH
TARJETA_SD
protected static final String SD_CARD
ALMACENAMIENTO_EMULADO
protected static final String STORAGE_EMULATED
Constructores públicos
Dispositivo nativo
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Crea un TestDevice
.
Parámetros | |
---|---|
device |
IDevice : Es el IDevice asociado. |
stateMonitor |
IDeviceStateMonitor : Es el mecanismo IDeviceStateMonitor para usar. |
allocationMonitor |
IDeviceMonitor : Es el IDeviceMonitor que se informará sobre los cambios de estado de la asignación.
Puede ser nulo |
Métodos públicos
batchPrefetchStartupBuildProps.
public void batchPrefetchStartupBuildProps ()
Microoptimización (alrededor de 400 milis) mediante la carga previa de todas las props que necesitamos, en lugar de llamar a "adb getprop para cada uno. Es decir, recuperar todas las propiedades es tan rápido como recuperar una. Se realizan llamadas a device.getApiLevel(), checkApiLevelAgainstNextRelease y getBuildAlias "adb getprop" de forma interna. Los recuperamos en una llamada y llamamos a NativeDevice.setProperty. Incluso si no hacemos esto, NativeDevice llamará por sí mismo a setProperty y almacenará en caché el resultado para futuras llamadas. Lo estamos haciendo un poco antes. Si el dispositivo está en recuperación otros errores cuando se recuperan los objetos, simplemente los ignoramos.
Cambiar a usuario del sistema sin cabeza
public boolean canSwitchToHeadlessSystemUser ()
Muestra si se le permite cambiar al usuario de SYSTEM sin interfaz gráfica.
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
checkApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Comprobar si una función es compatible actualmente con un nivel mínimamente admitido 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 | |
---|---|
DeviceNotAvailableException |
checkConnectivity
public boolean checkConnectivity ()
Verifica que el dispositivo tenga conectividad de red.
Muestra | |
---|---|
boolean |
true si el dispositivo tiene una conexión de red en funcionamiento.
false en exceso. |
Arroja | |
---|---|
DeviceNotAvailableException |
deleteErrorDialogs
public boolean clearErrorDialogs ()
Intenta descartar los diálogos de error que se muestran actualmente en la IU del dispositivo.
Muestra | |
---|---|
boolean |
true si no hay diálogos presentes o estos se borraron correctamente.
De lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
clearLastConnectedWifiNetwork
public void clearLastConnectedWifiNetwork ()
Borra la última red Wi-Fi conectada. Se debe llamar a este elemento cuando se inicia una nueva invocación. para evitar conectarte a la red Wi-Fi utilizada en la prueba anterior después de reiniciar el dispositivo.
deleteLogcat
public 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).
conectarAlaredWi-Fi
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Se conecta a una red Wi-Fi.
Se activa el Wi-Fi y se bloquea hasta que se establece una conexión exitosa con uno de los dispositivos
redes proporcionadas en el mapa wifiSsidToPsk. Una vez que se establece la conexión, la instancia intentará
restablece la conexión después de cada reinicio hasta la(s) ITestDevice#disconnectFromWifi()
o
Se llama a ITestDevice#clearLastConnectedWifiNetwork()
.
Parámetros | |
---|---|
wifiSsidToPsk |
: Un mapa de los SSID de Wi-Fi a las contraseñas. |
scanSsid |
boolean : Indica si se deben buscar SSID ocultos de esta red. |
Muestra | |
---|---|
boolean |
true si se conectó correctamente a la red Wi-Fi. false
de lo contrario |
Arroja | |
---|---|
DeviceNotAvailableException |
conectarAlaredWi-Fi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
Se conecta a una red Wi-Fi.
Activa el Wi-Fi y bloquea hasta que se establezca una conexión exitosa a la red Wi-Fi especificada.
Una vez que se establezca la conexión, la instancia intentará restablecerla después de cada reinicio
hasta el ITestDevice#disconnectFromWifi()
o
Se llama a ITestDevice#clearLastConnectedWifiNetwork()
.
Parámetros | |
---|---|
wifiSsid |
String : El cable de Wi-Fi al que se debe conectar |
wifiPsk |
String : Frase de contraseña de PSK o nula si no está encriptada |
Muestra | |
---|---|
boolean |
true si se conectó correctamente a la red Wi-Fi. false
de lo contrario |
Arroja | |
---|---|
DeviceNotAvailableException |
conectarAlaredWi-Fi
public boolean connectToWifiNetwork (wifiSsidToPsk)
Se conecta a una red Wi-Fi.
Se activa el Wi-Fi y se bloquea hasta que se establece una conexión exitosa con uno de los dispositivos
redes proporcionadas en el mapa wifiSsidToPsk. Una vez que se establece la conexión, la instancia intentará
restablece la conexión después de cada reinicio hasta la(s) ITestDevice#disconnectFromWifi()
o
Se llama a ITestDevice#clearLastConnectedWifiNetwork()
.f
Parámetros | |
---|---|
wifiSsidToPsk |
: Un mapa de los SSID de Wi-Fi a las contraseñas. |
Muestra | |
---|---|
boolean |
true si se conectó correctamente a la red Wi-Fi. false
de lo contrario |
Arroja | |
---|---|
DeviceNotAvailableException |
conectarAlaredWi-Fi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
Se conecta a una red Wi-Fi.
Activa el Wi-Fi y bloquea hasta que se establezca una conexión exitosa a la red Wi-Fi especificada.
Una vez que se establezca la conexión, la instancia intentará restablecerla después de cada reinicio
hasta el ITestDevice#disconnectFromWifi()
o
Se llama a ITestDevice#clearLastConnectedWifiNetwork()
.
Parámetros | |
---|---|
wifiSsid |
String : El cable de Wi-Fi al que se debe conectar |
wifiPsk |
String : Frase de contraseña de PSK o nula si no está encriptada |
scanSsid |
boolean : Indica si se debe buscar un SSID oculto de esta red. |
Muestra | |
---|---|
boolean |
true si se conectó correctamente a la red Wi-Fi. false
de lo contrario |
Arroja | |
---|---|
DeviceNotAvailableException |
ConectarConWi-FiNetworkSi Es necesario
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
Una variante de connectToWifiNetwork(String, String)
que solo se conecta si el dispositivo
actualmente no tiene conectividad de red.
Parámetros | |
---|---|
scanSsid |
boolean : Indica si se debe buscar un SSID oculto de esta red. |
Muestra | |
---|---|
boolean |
true si se conectó correctamente a la red Wi-Fi. false
de lo contrario |
Arroja | |
---|---|
DeviceNotAvailableException |
ConectarConWi-FiNetworkSi Es necesario
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
Una variante de connectToWifiNetwork(String, String)
que solo se conecta si el dispositivo
actualmente no tiene conectividad de red.
Muestra | |
---|---|
boolean |
true si se conectó correctamente a la red Wi-Fi. false
de lo contrario |
Arroja | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name, boolean guest, boolean ephemeral)
Crea un usuario con un nombre determinado y las marcas proporcionadas
Parámetros | |
---|---|
name |
String : del usuario que se creará en el dispositivo |
guest |
boolean : Habilita la marca de usuario --guest durante la creación. |
ephemeral |
boolean : Habilita la marca de usuario --efímeros durante la creación |
Muestra | |
---|---|
int |
ID del usuario creado |
Arroja | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
Crea un usuario con un nombre determinado y las marcas proporcionadas
Parámetros | |
---|---|
name |
String : del usuario que se creará en el dispositivo |
guest |
boolean : Habilita la marca de usuario --guest durante la creación. |
ephemeral |
boolean : Habilita la marca de usuario --efímeros durante la creación |
forTesting |
boolean : Habilita la marca de prueba --for-testing durante la creación |
Muestra | |
---|---|
int |
ID del usuario creado |
Arroja | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name)
Crea un usuario con un nombre determinado y las marcas predeterminadas 0.
Parámetros | |
---|---|
name |
String : del usuario que se creará en el dispositivo |
Muestra | |
---|---|
int |
el número entero para el ID de usuario creado |
Arroja | |
---|---|
DeviceNotAvailableException |
createUserNoThrow
public int createUserNoThrow (String name)
Crea un usuario con un nombre determinado y las marcas predeterminadas 0.
Parámetros | |
---|---|
name |
String : del usuario que se creará en el dispositivo |
Muestra | |
---|---|
int |
el número entero para el ID de usuario creado o -1 para el error. |
Arroja | |
---|---|
DeviceNotAvailableException |
deleteFile
public void deleteFile (String deviceFilePath, int userId)
Es un método de ayuda para borrar un archivo o directorio del dispositivo.
Parámetros | |
---|---|
deviceFilePath |
String : Es la ruta de acceso absoluta del archivo en el dispositivo. |
userId |
int : Es el ID de usuario del que se borrará. |
Arroja | |
---|---|
DeviceNotAvailableException |
deleteFile
public void deleteFile (String deviceFilePath)
Es un método de ayuda para borrar un archivo o directorio del dispositivo.
Parámetros | |
---|---|
deviceFilePath |
String : Es la ruta de acceso absoluta del archivo en el dispositivo. |
Arroja | |
---|---|
DeviceNotAvailableException |
anular el registro deDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Quita el IDeviceActionReceiver
registrado.
Parámetros | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : Es un IDeviceActionReceiver que se quitará. |
Reinicio en segundo plano del dispositivo
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Método de ayuda para verificar si el dispositivo se reinició de forma 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 | |
---|---|
DeviceNotAvailableException |
Reinicio no definitiva desde el dispositivo
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Método de ayuda para verificar si el dispositivo se reinició de forma no definitiva desde la hora UTC desde 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 | |
---|---|
DeviceNotAvailableException |
inhabilitarAdbRoot
public boolean disableAdbRoot ()
Desactiva la raíz de adb.
Si inhabilitas la raíz de adb, es posible que el dispositivo se desconecte de adb. Este método se bloqueará hasta está disponible.
Muestra | |
---|---|
boolean |
true si se realiza correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
deshabilitar bloqueo de teclado
public void disableKeyguard ()
Intenta inhabilitar el bloqueo del teclado.
Primero, espera a que esté listo el envío. Esto sucede casi al mismo tiempo que El dispositivo informa BOOT_COMPLETE, aparentemente de forma asíncrona, porque el framework actual. implementación tiene una condición de carrera ocasional. A continuación, se envía un comando para descartar el bloqueo del teclado (funciona solo en las que no son seguras)
Arroja | |
---|---|
DeviceNotAvailableException |
inhabilitarNetworkMonitor
public boolean disableNetworkMonitor ()
Inhabilita la supervisión de red en el dispositivo.
Muestra | |
---|---|
boolean |
Es true si la supervisión se inhabilitó correctamente. false
si falla. |
Arroja | |
---|---|
DeviceNotAvailableException |
DesconectarDeWi-Fi
public boolean disconnectFromWifi ()
Se desconecta de una red Wi-Fi.
Quita todas las redes de la lista de redes conocidas e inhabilita el Wi-Fi.
Muestra | |
---|---|
boolean |
true si se desconectó correctamente de la red Wi-Fi. false
si falló la desconexión. |
Arroja | |
---|---|
DeviceNotAvailableException |
haceArchivoexist
public boolean doesFileExist (String deviceFilePath, int userId)
Es un método de ayuda para determinar si existe un archivo en el dispositivo para un usuario determinado.
Parámetros | |
---|---|
deviceFilePath |
String : Es la ruta de acceso absoluta del archivo en el dispositivo que se debe verificar. |
userId |
int : Es el ID de usuario con el que se comprueba la existencia del archivo. |
Muestra | |
---|---|
boolean |
true si el archivo ya existe; de lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
haceArchivoexist
public boolean doesFileExist (String deviceFilePath)
Es un método de ayuda para determinar si existe un archivo en el dispositivo.
Parámetros | |
---|---|
deviceFilePath |
String : Es la ruta de acceso absoluta del archivo en el dispositivo que se debe verificar. |
Muestra | |
---|---|
boolean |
true si el archivo ya existe; de lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
Volcado de montón
public File dumpHeap (String process, String devicePath)
Intenta volcar el montón desde system_server. El llamador es responsable de limpiar el archivo de volcado.
Parámetros | |
---|---|
process |
String : Es el nombre del proceso del dispositivo en el que se realizará el volcado de nuevo. |
devicePath |
String : Es la ruta de acceso en el dispositivo en el que se debe colocar el volcado. Debe ser una ubicación donde
los permisos lo permitan. |
Muestra | |
---|---|
File |
el objeto ERROR(/File) que contiene el informe. Nulo si algo falló. |
Arroja | |
---|---|
DeviceNotAvailableException |
enableAdbRoot
public boolean enableAdbRoot ()
Activa la raíz de adb. Si el comando "enable-root" es “false”, registrará un mensaje y regresar 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 |
enableNetworkMonitor
public boolean enableNetworkMonitor ()
Habilita la supervisión de red en el dispositivo.
Muestra | |
---|---|
boolean |
Es true si la supervisión se habilitó correctamente. false
si falla. |
Arroja | |
---|---|
DeviceNotAvailableException |
EjecutarAdbCommand
public String executeAdbCommand (long timeout, String... cmdArgs)
Método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera 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 |
cmdArgs |
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 |
EjecutarAdbCommand
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
Método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera 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. |
cmdArgs |
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 |
EjecutarAdbCommand
public String executeAdbCommand (String... cmdArgs)
Es un método de ayuda que ejecuta un comando adb como un comando del sistema.
En su lugar, se debe usar executeShellCommand(String)
siempre que sea posible, ya que
proporciona una mejor detección
de fallas y un mejor rendimiento.
Parámetros | |
---|---|
cmdArgs |
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 |
EjecutarFastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
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 | |
---|---|
cmdArgs |
String : Es el comando fastboot y los argumentos para ejecutar. |
Muestra | |
---|---|
CommandResult |
el CommandResult, que contiene la salida del comando |
Arroja | |
---|---|
DeviceNotAvailableException |
EjecutarFastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
Es un método de ayuda que ejecuta un comando fastboot como un comando del sistema.
Se debe usar cuando el dispositivo ya está en Modo fastboot [Fastboot mode].
Parámetros | |
---|---|
timeout |
long : Es el tiempo en milisegundos antes de que venza el comando |
cmdArgs |
String : Es el comando fastboot y los argumentos para ejecutar. |
Muestra | |
---|---|
CommandResult |
el CommandResult, que contiene la salida del comando |
Arroja | |
---|---|
DeviceNotAvailableException |
ejecutarLongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
Es un método de ayuda que ejecuta un comando fastboot de larga duración como un comando del sistema.
Idéntico a executeFastbootCommand(String)
, excepto que usa un tiempo de espera más largo.
Parámetros | |
---|---|
cmdArgs |
String : Es el comando fastboot y los argumentos para ejecutar. |
Muestra | |
---|---|
CommandResult |
el CommandResult, que contiene la salida del comando |
Arroja | |
---|---|
DeviceNotAvailableException |
ejecutarLongFastbootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
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. |
cmdArgs |
String : Es el comando fastboot y los argumentos para ejecutar. |
Muestra | |
---|---|
CommandResult |
el CommandResult, que contiene la salida del comando |
Arroja | |
---|---|
DeviceNotAvailableException |
Comando runShell
public String executeShellCommand (String command)
Es un método de ayuda que ejecuta un comando shell de adb y muestra el resultado como String
.
Parámetros | |
---|---|
command |
String : Es el comando shell de adb que se ejecutará. |
Muestra | |
---|---|
String |
el resultado del shell |
Arroja | |
---|---|
DeviceNotAvailableException |
Comando runShell
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.
Parámetros | |
---|---|
command |
String : Es el comando shell de adb que se ejecutará. |
receiver |
IShellOutputReceiver : Es el IShellOutputReceiver al que se dirigirá el resultado de la shell. |
maxTimeToOutputShellResponse |
long : Es la cantidad máxima de tiempo durante la cual 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 |
Comando runShell
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.
Parámetros | |
---|---|
command |
String : Es el comando shell de adb que se ejecutará. |
receiver |
IShellOutputReceiver : Es el IShellOutputReceiver al que se dirigirá el resultado de la shell. |
maxTimeoutForCommand |
long : Es el tiempo de espera máximo para que se complete el comando. unidad como
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 |
Comando runShell
public void executeShellCommand (String command, IShellOutputReceiver receiver)
Ejecuta el comando shell de adb determinado y vuelve a intentarlo varias veces si el comando falla.
Una forma más 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 |
Comando runShellV2
public CommandResult executeShellV2Command (String cmd)
Es un método auxiliar que ejecuta un comando shell de adb y muestra los resultados como un CommandResult
propagado correctamente con el resultado del estado del comando, stdout y stderr.
Parámetros | |
---|---|
cmd |
String : Es el comando que se debe ejecutar. |
Muestra | |
---|---|
CommandResult |
El resultado en CommandResult . |
Arroja | |
---|---|
DeviceNotAvailableException |
Comando runShellV2
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como un CommandResult
correctamente propagado con el resultado del estado del comando y stderr. stdout está
se dirija a la transmisión especificada.
Parámetros | |
---|---|
cmd |
String : Es el comando que se debe ejecutar. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) donde se redireccionará el resultado estándar, o nulo |
Muestra | |
---|---|
CommandResult |
El resultado en CommandResult . |
Arroja | |
---|---|
DeviceNotAvailableException |
Comando runShellV2
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como un CommandResult
propagado correctamente con el resultado del estado del comando, stdout y stderr.
Parámetros | |
---|---|
cmd |
String : Es el comando que se debe ejecutar. |
pipeAsInput |
File : Es una ERROR(/File) que se canalizará como entrada para el comando o que será nula. |
Muestra | |
---|---|
CommandResult |
El resultado en CommandResult . |
Arroja | |
---|---|
DeviceNotAvailableException |
Comando runShellV2
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.
Parámetros | |
---|---|
cmd |
String : Es el comando shell de adb que se ejecutará. |
maxTimeoutForCommand |
long : Es el tiempo de espera máximo para que se complete el comando. unidad como
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 |
Comando runShellV2
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.
Parámetros | |
---|---|
cmd |
String : Es el comando shell de adb que se ejecutará. |
maxTimeoutForCommand |
long : Es el tiempo de espera máximo para que se complete el comando. unidad como
especificado en timeUnit |
timeUnit |
TimeUnit : unidad para maxTimeToOutputShellResponse |
Muestra | |
---|---|
CommandResult |
Arroja | |
---|---|
DeviceNotAvailableException |
Comando runShellV2
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.
Parámetros | |
---|---|
cmd |
String : Es el comando shell de adb que se ejecutará. |
pipeAsInput |
File : Es una ERROR(/File) que se canalizará como entrada para el comando o 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 |
Comando runShellV2
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando.
Parámetros | |
---|---|
cmd |
String : Es el comando shell de adb que se ejecutará. |
pipeAsInput |
File : Es una ERROR(/File) que se canalizará como entrada para el comando o 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 |
fastbootWipePartition.
public CommandResult fastbootWipePartition (String partition)
Es un método de ayuda que borra una partición del dispositivo.
Si getUseFastbootErase()
es true
, se usará el borrado de fastboot para 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 |
getActiveApexes
publicgetActiveApexes ()
Recupera la información sobre los APEX activados en el dispositivo.
Muestra | |
---|---|
|
Actualmente, hay ERROR(/Set) de ApexInfo activados en el dispositivo |
Arroja | |
---|---|
DeviceNotAvailableException |
getAllSettings
publicgetAllSettings (String namespace)
Muestra los pares clave-valor del espacio de nombres solicitado.
Parámetros | |
---|---|
namespace |
String : debe ser {"system", "secure", "global"} |
Muestra | |
---|---|
|
el mapa de pares clave-valor. Nulo si el espacio de nombres no es compatible. |
Arroja | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
Devuelve el estado de asignación actual del dispositivo
Muestra | |
---|---|
DeviceAllocationState |
getAndroidId
public String getAndroidId (int userId)
Busca y muestra el android-id asociado con un userId (valor nulo si no se encuentra).
Parámetros | |
---|---|
userId |
int |
Muestra | |
---|---|
String |
Arroja | |
---|---|
DeviceNotAvailableException |
getAndroidIds
publicgetAndroidIds ()
Crea un mapa de los ID de Android encontrados que coincidan con los ID de usuario. No hay un seguro de que cada usuario id encontrará un ID de Android asociado en esta función, por lo que algunos ID de usuario pueden coincidir con el valor nulo.
Muestra | |
---|---|
|
Mapa de los IDs de Android encontrados con los IDs de usuario. |
Arroja | |
---|---|
DeviceNotAvailableException |
getApiLevel.
public 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 | |
---|---|
DeviceNotAvailableException |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Recupera información sobre un paquete instalado en el dispositivo.
Parámetros | |
---|---|
packageName |
String |
Muestra | |
---|---|
PackageInfo |
el PackageInfo o la null si la información no se pudo recuperar |
Arroja | |
---|---|
DeviceNotAvailableException |
getAppPackageInfos
publicgetAppPackageInfos ()
Recupera información de paquetes instalados en el dispositivo.
Muestra | |
---|---|
|
Se instalaron ERROR(/List) de PackageInfo en el dispositivo. |
Arroja | |
---|---|
DeviceNotAvailableException |
getBasebandVersion
public String getBasebandVersion ()
Método de conveniencia para obtener la versión de banda base (radio) de este dispositivo. Cómo obtener la versión de radio
es específico de un 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 |
getBatería
public Integer getBattery ()
Muestra el nivel de batería actual de un dispositivo o Valor Nulo si el nivel de batería no está disponible.
Muestra | |
---|---|
Integer |
getBooleanProperty
public boolean getBooleanProperty (String name, boolean defaultValue)
Muestra el valor booleano de la propiedad especificada.
Parámetros | |
---|---|
name |
String : Es el nombre de la propiedad. |
defaultValue |
boolean : Es el valor predeterminado que se muestra si la propiedad está vacía o no existe. |
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
publicgetBootHistory ()
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
publicgetBootHistorySince (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 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 |
getBugreport
public InputStreamSource getBugreport ()
Recupera un informe de errores del dispositivo.
Se garantiza que la implementación de esto seguirá funcionando en un dispositivo sin tarjeta sd (o cuando la sdcard aún no está activada).
Muestra | |
---|---|
InputStreamSource |
Un InputStreamSource que producirá el contenido del informe de errores a pedido. En
caso de falla, InputStreamSource producirá un ERROR(/InputStream) vacío. |
getBugreportz
public InputStreamSource getBugreportz ()
Recupera un bugreportz del dispositivo. El informe de errores en formato ZIP contiene el informe de errores principal y otros archivos de registro que son útiles para la depuración.
Solo es compatible con "adb version". > 1.0.36
Muestra | |
---|---|
InputStreamSource |
un InputStreamSource del archivo ZIP que contiene bugreportz, en la que se muestra un valor nulo
caso de falla. |
getBuildAlias
public String getBuildAlias ()
Recupera el alias de la compilación que el dispositivo está ejecutando actualmente.
El alias de compilación suele ser una 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 | |
---|---|
DeviceNotAvailableException |
getBuildFlavor.
public 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 | |
---|---|
DeviceNotAvailableException |
getBuildId
public 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 | |
---|---|
DeviceNotAvailableException |
getBuildSigningKeys.
public 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 | |
---|---|
DeviceNotAvailableException |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Devuelve un DeviceDescriptor
almacenado en caché si el dispositivo está asignado; de lo contrario, muestra el
DeviceDescriptor
actual.
Muestra | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public 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 String[] getChildren (String path)
Es una alternativa al uso de IFileEntry
, que a veces no funciona debido a los permisos.
Parámetros | |
---|---|
path |
String : Es la ruta de acceso en el dispositivo en la que se realizará la búsqueda. |
Muestra | |
---|---|
String[] |
Array de cadena que contiene todo el archivo de una ruta de acceso en el dispositivo. |
Arroja | |
---|---|
DeviceNotAvailableException |
getConnection
public AbstractConnection getConnection ()
La conexión actual asociada con el dispositivo.
Muestra | |
---|---|
AbstractConnection |
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
Muestra ContentProviderHandler
o un valor nulo si no está disponible.
Se puede volver a usar el proveedor de contenido si se creó antes con el mismo userId
.
Parámetros | |
---|---|
userId |
int : Es el ID de usuario con el que se inicializará el proveedor de contenido. |
Muestra | |
---|---|
ContentProviderHandler |
Arroja | |
---|---|
DeviceNotAvailableException |
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Muestra el estado plegable actual del dispositivo o un valor nulo si se produjeron algunos problemas.
Muestra | |
---|---|
DeviceFoldableState |
Arroja | |
---|---|
DeviceNotAvailableException |
getCurrentUser.
public int getCurrentUser ()
Muestra el ID del usuario en ejecución actual. En caso de error, muestra -10000.
Muestra | |
---|---|
int |
Arroja | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public String getDeviceClass ()
Obtén la clase de dispositivo.
Muestra | |
---|---|
String |
la clase de dispositivo String |
getDeviceDate
public long getDeviceDate ()
Muestra la fecha del dispositivo en milisegundos desde el ciclo de entrenamiento.
Muestra | |
---|---|
long |
la fecha del dispositivo en formato epoch. |
Arroja | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor.
public DeviceDescriptor getDeviceDescriptor ()
Muestra un DeviceDescriptor
a partir de la información del dispositivo para obtener información sobre él sin
y pasar el objeto del dispositivo en sí.
Muestra | |
---|---|
DeviceDescriptor |
getDeviceDescriptor.
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Muestra un DeviceDescriptor
a partir de la información del dispositivo para obtener información sobre él sin
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 TestDeviceState getDeviceState ()
Obtén el estado del dispositivo.
Muestra | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
Es una herramienta de ayuda para obtener la diferencia de hora entre el dispositivo y un ERROR(/Date)
determinado. Cómo usar el tiempo de ciclo de entrenamiento
internamente.
Parámetros | |
---|---|
date |
Date |
Muestra | |
---|---|
long |
la diferencia en milisegundos |
Arroja | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public InputStreamSource getEmulatorOutput ()
Cómo obtener la transmisión de stdout y stderr del emulador
Muestra | |
---|---|
InputStreamSource |
salida del emulador |
getEmulatorProcess
public Process getEmulatorProcess ()
Muestra el Process
correspondiente a este emulador.
Muestra | |
---|---|
Process |
la Process o null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
El registro que contiene todos los registros de executeShellCommand(String)
.
Muestra | |
---|---|
File |
getExternalStoreFreeSpace
public 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 |
getFastbootPath
public String getFastbootPath ()
Muestra la ruta de acceso del objeto binario de fastboot que se usa.
Aún se requiere que isFastbootEnabled()
sea verdadero para tener habilitadas las funciones de fastboot.
Muestra | |
---|---|
String |
getFastbootProductType
public String getFastbootProductType ()
Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.
Este método solo debe usarse si el dispositivo debe estar en fastboot. Es una variante un poco más segura
que el método genérico getProductType()
en este caso, porque ITestDevice
sabrá 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 |
getFastbootProductVariant
public String getFastbootProductVariant ()
Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.
Este método solo debe usarse si el dispositivo debe estar en fastboot. Es una variante un poco más segura
que el método genérico getProductType()
en este caso, porque ITestDevice
sabrá 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 |
getFastbootSerialNumber
public String getFastbootSerialNumber ()
Devuelve el número de serie del modo fastboot.
Muestra | |
---|---|
String |
getFastbootVariable
public String getFastbootVariable (String variableName)
Recupera el valor de la variable de fastboot específico del dispositivo.
Parámetros | |
---|---|
variableName |
String : Es el nombre de la variable. |
Muestra | |
---|---|
String |
el valor de la propiedad o null si no existe |
Arroja | |
---|---|
DeviceNotAvailableException |
getFastbootVersion
public String getFastbootVersion ()
Muestra la cadena de versión del objeto binario de fastboot que se usa. O nulo si algo sale está mal.
Muestra | |
---|---|
String |
getFileEntry
public IFileEntry getFileEntry (String path)
Recupera una referencia a un archivo remoto en el dispositivo.
Parámetros | |
---|---|
path |
String : Es la ruta del archivo que se recuperará. Puede ser una ruta de acceso absoluta o 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 | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Es un asistente no oficial para obtener un FileEntry
de una ruta no raíz. FIXME: Refactoriza
FileEntry para tenerla disponible desde cualquier ruta. (incluso los que no son raíz).
Parámetros | |
---|---|
entry |
FileListingService.FileEntry : Es un FileEntry que no necesariamente tiene permisos de administrador como lo requiere Ddmlib. |
Muestra | |
---|---|
IFileEntry |
Un FileEntryWrapper que representa a FileEntry |
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getFoldableStates
publicgetFoldableStates ()
Devuelve la lista de estados plegables en el dispositivo. Se puede obtener con “cmd device_state”. estados de impresión”.
Muestra | |
---|---|
|
Arroja | |
---|---|
DeviceNotAvailableException |
getIDevice
public IDevice getIDevice ()
Muestra una referencia al IDevice
de ddmlib asociado.
DDMS puede asignar un nuevo IDevice
cada vez que el dispositivo se desconecta y
se 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 |
getInstalledPackageNames
publicgetInstalledPackageNames ()
Recupera los nombres de paquetes de aplicaciones presentes en el dispositivo.
Muestra | |
---|---|
|
Hay ERROR(/Set) de String nombres de paquetes instalados en el dispositivo. |
Arroja | |
---|---|
DeviceNotAvailableException |
getIntProperty
public long getIntProperty (String name, long defaultValue)
Muestra el valor entero de la propiedad determinada del dispositivo.
Parámetros | |
---|---|
name |
String : Es el nombre de la propiedad. |
defaultValue |
long : Es el valor predeterminado que se muestra si la propiedad está vacía o no existe. |
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 |
getIpAddress
public String getIpAddress ()
Obtiene la dirección IP del dispositivo.
Muestra | |
---|---|
String |
la dirección IP del dispositivo o null si el dispositivo no tiene dirección IP |
Arroja | |
---|---|
DeviceNotAvailableException |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Muestra un objeto para obtener el estado actual de la protección de teclado o un valor nulo si no se admite.
Muestra | |
---|---|
KeyguardControllerState |
un KeyguardControllerState que contiene una instantánea del estado del bloqueo de teclado
y muestra Null si la consulta de bloqueo de teclado no es compatible. |
Arroja | |
---|---|
DeviceNotAvailableException |
getLastExpectedRestartTimeMillis
public 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 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 | |
---|---|
DeviceNotAvailableException |
getLogcat.
public InputStreamSource getLogcat ()
Captura una transmisión de instantáneas de los datos de Logcat.
Funciona en dos modos:
TestDeviceOptions.getMaxLogcatDataSize()
bytes del contenido actual en segundo plano.
captura de logcat
Muestra | |
---|---|
InputStreamSource |
getLogcat.
public InputStreamSource getLogcat (int maxBytes)
Captura una transmisión de instantáneas del último maxBytes
de los datos de logcat capturados.
Es útil para los casos en los que deseas capturar instantáneas frecuentes de los datos 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 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 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 |
getMacAddress
public String getMacAddress ()
Devuelve la dirección MAC del dispositivo, nula si no se puede consultar desde el dispositivo.
Muestra | |
---|---|
String |
getMainUserId
public Integer getMainUserId ()
Muestra el ID de usuario principal.
Muestra | |
---|---|
Integer |
El userId del usuario principal, si existe, es nulo si no lo hay. |
Arroja | |
---|---|
DeviceNotAvailableException |
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
Obtén información sobre los módulos de línea principales instalados en el dispositivo.
Muestra | |
---|---|
|
Hay ERROR(/Set) de String módulos de línea principales instalados en el dispositivo actualmente. |
Arroja | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfRunningUsersSupported
public int getMaxNumberOfRunningUsersSupported ()
Obtén la cantidad máxima de usuarios que se ejecutan de manera simultánea. La configuración predeterminada es 0.
Muestra | |
---|---|
int |
un número entero que indica la cantidad de usuarios que se ejecutan simultáneamente |
Arroja | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfUsersSupported
public int getMaxNumberOfUsersSupported ()
Obtén la cantidad máxima de usuarios admitidos. La configuración predeterminada es 0.
Muestra | |
---|---|
int |
un número entero que indica la cantidad de usuarios admitidos |
Arroja | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess.
public Process getMicrodroidProcess ()
Muestra | |
---|---|
Process |
Muestra el proceso de la VM de Microdroid. Si TestDevice no es un Microdroid, devuelve null. |
getMonitor.
public IDeviceStateMonitor getMonitor ()
Devuelve el IDeviceStateMonitor
asociado con el dispositivo.
Muestra | |
---|---|
IDeviceStateMonitor |
getMountPoint
public String getMountPoint (String mountName)
Muestra un punto de activación.
Consulta al dispositivo directamente si la información almacenada en caché en IDevice
no está disponible.
PENDIENTE: Trasladar este comportamiento a IDevice#getMountPoint(String)
Parámetros | |
---|---|
mountName |
String : Es el nombre del punto de activación. |
Muestra | |
---|---|
String |
el punto de activación o null |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Muestra un MountPointInfo
que corresponde a la ruta de acceso del punto de activación especificado.
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
publicgetMountPointInfo ()
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 |
getOptions
public TestDeviceOptions getOptions ()
Recupera las opciones de prueba para el dispositivo.
Muestra | |
---|---|
TestDeviceOptions |
TestDeviceOptions relacionado con el dispositivo de prueba. |
getPartitionFreeSpace
public long getPartitionFreeSpace (String partition)
Método de ayuda para determinar la cantidad de espacio libre en la partición del dispositivo.
Parámetros | |
---|---|
partition |
String |
Muestra | |
---|---|
long |
la cantidad de espacio libre en KB |
Arroja | |
---|---|
DeviceNotAvailableException |
ID de usuario principal de getPrimary
public Integer getPrimaryUserId ()
Muestra el ID de usuario principal.
Muestra | |
---|---|
Integer |
El userId del usuario principal si existe uno y nulo si no hay uno. |
Arroja | |
---|---|
DeviceNotAvailableException |
getProcessByName
public ProcessInfo getProcessByName (String processName)
El método de ayuda ejecuta 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 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 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 |
getProductVariant
public String getProductVariant ()
Es un 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 |
getProperty
public 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 | |
---|---|
DeviceNotAvailableException |
getRecoveryMode.
public 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. |
obtener captura de pantalla
public InputStreamSource getScreenshot (String format)
Toma una captura de pantalla del dispositivo. Se recomienda usar getScreenshot(format) con codificación JPEG para un tamaño más pequeño.
Parámetros | |
---|---|
format |
String : PNG y JPEG compatibles |
Muestra | |
---|---|
InputStreamSource |
una InputStreamSource de la captura de pantalla en formato, o null si
la captura de pantalla no se realizó correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
obtener captura de pantalla
public InputStreamSource getScreenshot (long displayId)
Toma una captura de pantalla del ID de visualización del dispositivo. El formato es PNG.
PENDIENTE: Extender las implementaciones anteriores para admitir "formato" y reescalarla
Parámetros | |
---|---|
displayId |
long : Es el ID de la pantalla de la que se realizará la captura de pantalla. |
Muestra | |
---|---|
InputStreamSource |
una InputStreamSource de la captura de pantalla en formato, o null si la
la captura de pantalla no se realizó correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
obtener captura de pantalla
public InputStreamSource getScreenshot (String format, boolean rescale)
Toma una captura de pantalla del dispositivo. Se recomienda usar getScreenshot(String)
en su lugar
con codificación JPEG para un tamaño más pequeño.
Parámetros | |
---|---|
format |
String : PNG y JPEG compatibles |
rescale |
boolean : Si la captura de pantalla se debe reajustar para reducir el tamaño de la imagen resultante. |
Muestra | |
---|---|
InputStreamSource |
una InputStreamSource de la captura de pantalla en formato, o null si la
la captura de pantalla no se realizó correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
obtener captura de pantalla
public InputStreamSource getScreenshot ()
Toma una captura de pantalla del dispositivo.
Muestra | |
---|---|
InputStreamSource |
una InputStreamSource de la captura de pantalla en formato PNG, o null si
la captura de pantalla no se realizó correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
getSerialNumber
public 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 |
getSetting
public String getSetting (int userId, String namespace, String key)
Muestra el valor de la configuración solicitada. el espacio de nombres debe ser uno de los siguientes: {"system", "secure", "global"}
Parámetros | |
---|---|
userId |
int |
namespace |
String |
key |
String |
Muestra | |
---|---|
String |
el valor asociado con el espacio de nombres:clave de un usuario. Nulo si no se encuentra. |
Arroja | |
---|---|
DeviceNotAvailableException |
getSetting
public String getSetting (String namespace, String key)
Consulta getSetting(int, String, String)
y se realizó en el usuario del sistema.
Parámetros | |
---|---|
namespace |
String |
key |
String |
Muestra | |
---|---|
String |
Arroja | |
---|---|
DeviceNotAvailableException |
getSimOperator
public String getSimOperator ()
Muestra el operador de la tarjeta SIM o un valor nulo si no está disponible o si el dispositivo no está disponible.
Muestra | |
---|---|
String |
getSimState
public String getSimState ()
Devuelve el estado de la tarjeta SIM o es nulo si no está disponible o el dispositivo no está disponible.
Muestra | |
---|---|
String |
getTombstones
publicgetTombstones ()
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 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 |
getUninstallablePackageNames
publicgetUninstallablePackageNames ()
Recupera los nombres de los paquetes de aplicaciones que se pueden desinstalar. Actualmente, esto se define como paquetes que no son del sistema y paquetes de sistema actualizados.
Muestra | |
---|---|
|
Actualmente, hay ERROR(/Set) de nombres de paquetes desinstalables de String instalados en el
dispositivo. |
Arroja | |
---|---|
DeviceNotAvailableException |
getUseFastbootBorra
public 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á. |
getUserFlags.
public int getUserFlags (int userId)
Busca y muestra las marcas de un usuario determinado. Las marcas se definen en "android.content.pm.UserInfo" en el Proyecto de código abierto de Android.
Parámetros | |
---|---|
userId |
int |
Muestra | |
---|---|
int |
las marcas asociadas con el userId proporcionado si se encuentra, -10000 en cualquier otro caso. |
Arroja | |
---|---|
DeviceNotAvailableException |
getUserInfos
publicgetUserInfos ()
Obtiene el mapa de useId como UserInfo
en el dispositivo. Arrojará DeviceRuntimeException
si el resultado del dispositivo no es el esperado.
Muestra | |
---|---|
|
la lista de objetos UserInfo. |
Arroja | |
---|---|
DeviceNotAvailableException |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Devuelve el número de serie asociado con el userId si lo encuentras; -10000 en cualquier otro caso.
Parámetros | |
---|---|
userId |
int |
Muestra | |
---|---|
int |
Arroja | |
---|---|
DeviceNotAvailableException |
controladordeAsignaciónEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Procesa un DeviceEvent determinado. Puede realizar la transición del dispositivo
al estado nuevo. Informará a IDeviceMonitor
sobre cualquier transición de estado.
Procesar el DeviceEvent, lo que puede o no hacer la transición de este dispositivo a una nueva asignación para cada estado.
Parámetros | |
---|---|
event |
DeviceEvent |
Muestra | |
---|---|
IManagedTestDevice.DeviceEventResponse |
hasFeature
public boolean hasFeature (String feature)
Comprueba si una función está disponible en un dispositivo.
Parámetros | |
---|---|
feature |
String : qué formato debe ser “feature: |
Muestra | |
---|---|
boolean |
Es verdadero si se encuentra un atributo. De lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
Instala un paquete de Android en el dispositivo.
Parámetros | |
---|---|
packageFile |
File : Es el archivo APK que se instalará. |
reinstall |
boolean : Es la true si se debe reinstalar el sistema. |
extraArgs |
String : Son argumentos adicionales opcionales que se deben pasar. Consulta "adb shell pm -h". disponible
opciones de estado. |
Muestra | |
---|---|
String |
una String con un código de error, o null si se ejecuta de forma correcta. |
Arroja | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Instala un paquete de Android en el dispositivo.
Nota: Solo los casos de uso que requieren un control explícito para otorgar permisos de tiempo de ejecución en el tiempo de instalación debería llamar a esta función.
Parámetros | |
---|---|
packageFile |
File : Es el archivo APK que se instalará. |
reinstall |
boolean : Es la true si se debe reinstalar el sistema. |
grantPermissions |
boolean : Si se deben otorgar todos los permisos de tiempo de ejecución en el momento de la instalación. |
extraArgs |
String : Son argumentos adicionales opcionales que se deben pasar. Consulta "adb shell pm -h". disponible
opciones de estado. |
Muestra | |
---|---|
String |
una String con un código de error, o null si se ejecuta de forma correcta. |
Arroja | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
Instala un paquete de Android en el dispositivo para un usuario determinado.
Parámetros | |
---|---|
packageFile |
File : Es el archivo APK que se instalará. |
reinstall |
boolean : Es la true si se debe reinstalar el sistema. |
userId |
int : Es el ID de usuario entero para el que se instalará. |
extraArgs |
String : Son argumentos adicionales opcionales que se deben pasar. Consulta "adb shell pm -h". disponible
opciones de estado. |
Muestra | |
---|---|
String |
una String con un código de error, o null si se ejecuta de forma correcta. |
Arroja | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Instala un paquete de Android en el dispositivo para un usuario determinado.
Nota: Solo los casos de uso que requieren un control explícito para otorgar permisos de tiempo de ejecución en el tiempo de instalación debería llamar a esta función.
Parámetros | |
---|---|
packageFile |
File : Es el archivo APK que se instalará. |
reinstall |
boolean : Es la true si se debe reinstalar el sistema. |
grantPermissions |
boolean : Si se deben otorgar todos los permisos de tiempo de ejecución en el momento de la instalación. |
userId |
int : Es el ID de usuario entero para el que se instalará. |
extraArgs |
String : Son argumentos adicionales opcionales que se deben pasar. Consulta "adb shell pm -h". disponible
opciones de estado. |
Muestra | |
---|---|
String |
una String con un código de error, o null si se ejecuta de forma correcta. |
Arroja | |
---|---|
DeviceNotAvailableException |
invalidatePropertyCache
public void invalidatePropertyCache ()
isAdbTcp
public boolean isAdbTcp ()
Muestra | |
---|---|
boolean |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Cómo comprobar si la plataforma en el dispositivo admite la enumeración de apps
Muestra | |
---|---|
boolean |
Es verdadero si se admite la enumeración de app. De lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported
public boolean isBypassLowTargetSdkBlockSupported ()
Verifica si la plataforma en el dispositivo admite la omisión del bloqueo del SDK de destino bajo en las instalaciones de apps
Muestra | |
---|---|
boolean |
Es verdadero si se admite la omisión del bloque de SDK de destino bajo; de lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
isDebugfsMounted
public boolean isDebugfsMounted ()
Verifica si el elemento debugfs está activado.
Muestra | |
---|---|
boolean |
true si se activa "debugfs" |
Arroja | |
---|---|
DeviceNotAvailableException |
isDeviceEncrypted
public boolean isDeviceEncrypted ()
Muestra si el dispositivo está encriptado.
Muestra | |
---|---|
boolean |
Es true si el dispositivo está encriptado. |
Arroja | |
---|---|
DeviceNotAvailableException |
isDirectory
public boolean isDirectory (String path)
Muestra el valor True si la ruta de acceso en el dispositivo es un directorio. De lo contrario, muestra false.
Parámetros | |
---|---|
path |
String |
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
RaízdeAdBAdm.
public boolean isEnableAdbRoot ()
Muestra | |
---|---|
boolean |
true si la raíz de adb debe estar habilitada en el dispositivo. |
Compatible con la encriptación
public boolean isEncryptionSupported ()
Se devuelve si el dispositivo admite la encriptación.
Muestra | |
---|---|
boolean |
Es true si el dispositivo es compatible con la encriptación. |
Arroja | |
---|---|
DeviceNotAvailableException |
Se puede ejecutar
public boolean isExecutable (String fullPath)
Muestra el valor True si la ruta de acceso al archivo en el dispositivo es ejecutable. De lo contrario, muestra false.
Parámetros | |
---|---|
fullPath |
String |
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
estáFastbootEnabled
public boolean isFastbootEnabled ()
Muestra si fastboot está disponible para el dispositivo.
Muestra | |
---|---|
boolean |
Sin interfaz gráfica
public boolean isHeadless ()
Muestra true si el dispositivo no tiene interfaz gráfica (sin pantalla). De lo contrario, muestra false.
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
Modo de usuario del sistema sin interfaz gráfica
public boolean isHeadlessSystemUserMode ()
Indica si el dispositivo usa el modo de usuario del sistema sin interfaz gráfica.
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
EsMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Muestra si el usuario principal es un administrador permanente y si no se puede borrar ni cambiar a una versión inferior no es administrador.
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
Compatibilidad con múltiples usuarios
public boolean isMultiUserSupported ()
Determina si se admite multiusuario.
Muestra | |
---|---|
boolean |
true si se admite multiusuarios; de lo contrario, false |
Arroja | |
---|---|
DeviceNotAvailableException |
PaqueteInstalado
public boolean isPackageInstalled (String packageName, String userId)
Consulta el dispositivo para obtener un nombre de paquete y un ID de usuario determinados para comprobar si está actualmente instalado o no para ese usuario.
Parámetros | |
---|---|
packageName |
String : Es el paquete que estamos verificando si está instalado. |
userId |
String : Es el ID de usuario para el que verificaremos que el paquete esté instalado. Si es nulo, el usuario principal
se usará cero. |
Muestra | |
---|---|
boolean |
Es verdadero si se informa que el paquete está instalado. De lo contrario, el valor es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
PaqueteInstalado
public boolean isPackageInstalled (String packageName)
Consulta el dispositivo para obtener un nombre de paquete determinado para comprobar si está instalado o no.
Parámetros | |
---|---|
packageName |
String |
Muestra | |
---|---|
boolean |
Es verdadero si se informa que el paquete está instalado. De lo contrario, el valor es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported
public 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 | |
---|---|
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
Muestra true si el dispositivo está en TestDeviceState#FASTBOOT
o TestDeviceState.FASTBOOTD
.
Muestra | |
---|---|
boolean |
EstáUserRunning
public boolean isUserRunning (int userId)
Verifica si un usuario determinado está en ejecución.
Parámetros | |
---|---|
userId |
int |
Muestra | |
---|---|
boolean |
Es verdadero si el usuario está en ejecución y es falso en todos los demás casos. |
Arroja | |
---|---|
DeviceNotAvailableException |
UsuarioSecundario
public boolean isUserSecondary (int userId)
Muestra si el usuario especificado es un usuario secundario según sus marcas.
Parámetros | |
---|---|
userId |
int |
Muestra | |
---|---|
boolean |
true si el usuario es secundario; de lo contrario, false |
Arroja | |
---|---|
DeviceNotAvailableException |
esUserVisible
public boolean isUserVisible (int userId)
Comprueba si el usuario especificado es visible.
Elemento "visible" usuario es un usuario que interactúa con el "humano" usuario y, por lo tanto, puede iniciar actividades de inicio (por lo general, en la pantalla predeterminada).
Parámetros | |
---|---|
userId |
int |
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
esUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
Comprueba si el usuario determinado es visible en la pantalla determinada.
Elemento "visible" usuario es un usuario que interactúa con el "humano" usuario y, por lo tanto, puede iniciar actividades de inicio en esa pantalla.
Parámetros | |
---|---|
userId |
int |
displayId |
int |
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Muestra si el dispositivo permite que los usuarios se inicien visibles en segundo plano en ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
.
Si es así, puedes llamar a startVisibleBackgroundUser(int, int, boolean)
y pasar
una pantalla que devuelve listDisplayIdsForStartingVisibleBackgroundUsers()
(que
debe incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
).
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersSupported
public boolean isVisibleBackgroundUsersSupported ()
Muestra si el dispositivo permite que los usuarios se inicien visibles en segundo plano.
Si es así, puedes llamar a startVisibleBackgroundUser(int, int, boolean)
y pasar
una pantalla que muestra listDisplayIdsForStartingVisibleBackgroundUsers()
.
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
Wi-Fi habilitado
public boolean isWifiEnabled ()
Prueba si el Wi-Fi está habilitado.
Comprueba si el Wi-Fi está habilitado en el dispositivo. Es útil para confirmar el estado de la conexión Wi-Fi antes de realizar pruebas que no se deben ejecutar con Wi-Fi, p.ej., y pruebas de datos móviles.
Muestra | |
---|---|
boolean |
true si el Wi-Fi está habilitado. false si está inhabilitada |
Arroja | |
---|---|
DeviceNotAvailableException |
IDDisplayDisplay
publiclistDisplayIds ()
Recopila la lista de ID de pantallas disponibles en el dispositivo según lo informa "dumpsys". SurfaceFlinger”.
Muestra | |
---|---|
|
Es la lista de pantallas. El valor predeterminado siempre muestra el valor de visualización predeterminado 0. |
Arroja | |
---|---|
DeviceNotAvailableException |
listDisplayIdsForStartingVisibleBackgroundUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Obtiene la lista de pantallas que se pueden usar para start a user visible in the background
.
Muestra | |
---|---|
|
Arroja | |
---|---|
DeviceNotAvailableException |
usuarios de la lista
publiclistUsers ()
Obtiene la lista de usuarios en el dispositivo. arrojará DeviceRuntimeException
si la salida es
del dispositivo no es el esperado.
Muestra | |
---|---|
|
la lista de IDs de usuario. |
Arroja | |
---|---|
DeviceNotAvailableException |
LogAnrs.
public boolean logAnrs (ITestLogger logger)
Recopila y registra ANR del dispositivo.
Parámetros | |
---|---|
logger |
ITestLogger : Es un ITestLogger para registrar los errores de ANR. |
Muestra | |
---|---|
boolean |
Es verdadero si se realizó correctamente el registro. De lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
informe de errores de registro
public boolean logBugreport (String dataName, ITestLogger listener)
Es un método de ayuda para tomar un informe de errores y registrarlo en los generadores.
Parámetros | |
---|---|
dataName |
String : Es el nombre con el que se informará el informe de errores. |
listener |
ITestLogger : Es un ITestLogger para registrar el informe de errores. |
Muestra | |
---|---|
boolean |
Es verdadero si se realizó correctamente el registro. De lo contrario, es falso. |
Dispositivo de acceso
public void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Registra un mensaje en el logcat del dispositivo. Esta es una llamada segura que no arrojará 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(). |
reinicio no bloqueado
public 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 | |
---|---|
DeviceNotAvailableException |
postAdbRootAction
public void postAdbRootAction ()
Anula si el dispositivo necesita que se realicen algunas acciones específicas después de la raíz de adb y antes de que el dispositivo vuelva a estar en línea. La implementación predeterminada no incluye ninguna acción de adición. No se garantiza que la raíz de adb esté habilitada en esta etapa.
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postAdbUnrootAction
public void postAdbUnrootAction ()
Anula si el dispositivo necesita que se realicen algunas acciones específicas después de que adb desroot y antes de que el dispositivo vuelva a estar en línea. La implementación predeterminada no incluye ninguna acción adicional. No se garantiza que la raíz de adb esté inhabilitada en esta etapa.
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Configuración posterior al arranque
public void postBootSetup ()
Sigue las instrucciones para configurar el dispositivo y probarlo después de cada inicio.
Se debe llamar una vez que el dispositivo se haya iniciado por completo o esté disponible
En circunstancias normales, no es necesario llamar a este método de 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 |
TearDown después de la invocación
public void postInvocationTearDown (Throwable exception)
Pasos adicionales para la limpieza obligatoria específica del dispositivo que se ejecutará después de la invocación el proyecto.
Parámetros | |
---|---|
exception |
Throwable : Si existe, es la excepción final que generó el error de invocación. |
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 | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
pullDir
public boolean pullDir (String deviceFilePath, File localDir, int userId)
Extrae contenido del directorio del dispositivo de manera recurrente.
Parámetros | |
---|---|
deviceFilePath |
String : La ruta de acceso absoluta al archivo de la fuente remota |
localDir |
File : El directorio local al que se extraerán archivos |
userId |
int : Es el ID de usuario desde el que se realizará la extracción. |
Muestra | |
---|---|
boolean |
true si el archivo se extrajo correctamente. De lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
pullDir
public boolean pullDir (String deviceFilePath, File localDir)
Extrae contenido del directorio del dispositivo de manera recurrente.
Parámetros | |
---|---|
deviceFilePath |
String : La ruta de acceso absoluta al archivo de la fuente remota |
localDir |
File : El directorio local al que se extraerán archivos |
Muestra | |
---|---|
boolean |
true si el archivo se extrajo correctamente. De lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile)
Recupera un archivo fuera del dispositivo.
Parámetros | |
---|---|
remoteFilePath |
String : Es la ruta de acceso absoluta al archivo en el dispositivo. |
localFile |
File : Es el archivo local en el que se almacenará el contenido. Si no está vacío, el contenido se
y reemplazarse. |
Muestra | |
---|---|
boolean |
Es true si el archivo se recuperó correctamente. De lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
pullFile
public 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 |
Un objeto ERROR(/File) con el contenido del archivo del dispositivo, o bien null si el elemento
no se pudo copiar por algún motivo (incluidos los problemas con el sistema de archivos del host). |
Arroja | |
---|---|
DeviceNotAvailableException |
pullFile
public 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 |
Un objeto ERROR(/File) con el contenido del archivo del dispositivo, o bien null si el elemento
no se pudo copiar por algún motivo (incluidos los problemas con el sistema de archivos del host). |
Arroja | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile, int userId)
Recupera un archivo fuera del dispositivo.
Parámetros | |
---|---|
remoteFilePath |
String : Es la ruta de acceso absoluta al archivo en el dispositivo. |
localFile |
File : Es el archivo local en el que se almacenará el contenido. Si no está vacío, 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 |
pullFileContents
public String pullFileContents (String remoteFilePath)
Recupera un archivo fuera del dispositivo y muestra el contenido.
Parámetros | |
---|---|
remoteFilePath |
String : Es la ruta de acceso absoluta al archivo en el dispositivo. |
Muestra | |
---|---|
String |
Un objeto String con el contenido del archivo del dispositivo, o bien 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 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 |
Un objeto ERROR(/File) con el contenido del archivo del dispositivo, o bien null si el elemento
no se pudo copiar por algún motivo (incluidos los problemas con el sistema de archivos del host). |
Arroja | |
---|---|
DeviceNotAvailableException |
PushDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
Envía de manera recurrente el contenido del directorio al dispositivo y, al mismo tiempo, excluye algunos directorios filtrado.
Parámetros | |
---|---|
localFileDir |
File : Es el directorio local que se enviará. |
deviceFilePath |
String : Es la ruta de acceso absoluta al archivo del destino remoto. |
excludedDirectories |
: Es el conjunto de nombres de directorios excluidos que no se deben enviar. |
Muestra | |
---|---|
boolean |
true si el archivo se envió correctamente. De lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
PushDir
public boolean pushDir (File localFileDir, String deviceFilePath)
Envía de manera recurrente el contenido del directorio al dispositivo.
Parámetros | |
---|---|
localFileDir |
File : Es el directorio local que se enviará. |
deviceFilePath |
String : Es la ruta de acceso absoluta al archivo del destino remoto. |
Muestra | |
---|---|
boolean |
true si el archivo se envió correctamente. De lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
PushDir
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
Envía de manera recurrente el contenido del directorio al dispositivo.
Parámetros | |
---|---|
localFileDir |
File : Es el directorio local que se enviará. |
deviceFilePath |
String : Es la ruta de acceso absoluta al archivo del destino remoto. |
userId |
int : Es el ID de usuario al que se enviará el mensaje. |
Muestra | |
---|---|
boolean |
true si el archivo se envió correctamente. De lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
Archivo push
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
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á. |
remoteFilePath |
String : Es la ruta de acceso absoluta del archivo de destino remoto. |
evaluateContentProviderNeeded |
boolean : Indica si se debe verificar si necesitamos el proveedor de contenido. |
Muestra | |
---|---|
boolean |
true si el archivo se envió correctamente. De lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
Archivo push
public boolean pushFile (File localFile, String remoteFilePath)
Envía un archivo al dispositivo. De forma predeterminada, con un proveedor de contenido.
Parámetros | |
---|---|
localFile |
File : Es el archivo local que se enviará. |
remoteFilePath |
String : Es la ruta de acceso absoluta del archivo de destino remoto. |
Muestra | |
---|---|
boolean |
true si el archivo se envió correctamente. De lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
Archivo push
public boolean pushFile (File localFile, String remoteFilePath, int userId)
Envía un archivo al dispositivo. De forma predeterminada, con un proveedor de contenido.
Parámetros | |
---|---|
localFile |
File : Es el archivo local que se enviará. |
remoteFilePath |
String : Es la ruta de acceso absoluta del archivo de destino remoto. |
userId |
int : El userId al que se enviará el mensaje |
Muestra | |
---|---|
boolean |
true si el archivo se envió correctamente. De lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
PushString
public boolean pushString (String contents, String remoteFilePath)
Envío de archivo creado a partir de una cadena al dispositivo
Parámetros | |
---|---|
contents |
String : Es el contenido del archivo que se enviará. |
remoteFilePath |
String : Es la ruta de acceso absoluta del archivo de destino remoto. |
Muestra | |
---|---|
boolean |
true si la cadena se envió correctamente. De lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
reiniciar
public void reboot (String reason)
Reinicia el dispositivo en modo adb con el reason
determinado para que persista durante el reinicio.
Se bloquea hasta que el dispositivo esté disponible.
El motivo del último reinicio se puede obtener consultando la propiedad sys.boot.reason
.
Parámetros | |
---|---|
reason |
String : Es un motivo para el reinicio o null si no se especifica un motivo. |
Arroja | |
---|---|
DeviceNotAvailableException |
reiniciar
public void reboot ()
Reinicia el dispositivo en modo adb.
Se bloquea hasta que el dispositivo esté disponible.
Arroja | |
---|---|
DeviceNotAvailableException |
reiniciarIntoBootloader
public void rebootIntoBootloader ()
Reinicia el dispositivo en el modo de bootloader.
Se bloquea hasta que el dispositivo esté en el modo de bootloader.
Arroja | |
---|---|
DeviceNotAvailableException |
reiniciarIntoFastbootd
public void rebootIntoFastbootd ()
Reinicia el dispositivo en el modo fastbootd.
Se bloquea hasta que el dispositivo esté en modo de inicio rápido.
Arroja | |
---|---|
DeviceNotAvailableException |
reinicio en la recuperación
public void rebootIntoRecovery ()
Reinicia el dispositivo en el modo de recuperación de adb.
Se bloquea hasta que el dispositivo entre en recuperación
Arroja | |
---|---|
DeviceNotAvailableException |
reiniciarIntoSideload
public void rebootIntoSideload ()
Reinicia el dispositivo en el modo de transferencia de adb (ten en cuenta que se trata de un modo especial en recuperación).
Se bloquea hasta que el dispositivo entre en modo de transferencia
Arroja | |
---|---|
DeviceNotAvailableException |
reiniciarIntoSideload
public void rebootIntoSideload (boolean autoReboot)
Reinicia el dispositivo en el modo de transferencia de adb (ten en cuenta que se trata de un modo especial en recuperación).
Se bloquea hasta que el dispositivo entre en modo de transferencia
Parámetros | |
---|---|
autoReboot |
boolean : Indica si se debe reiniciar automáticamente el dispositivo después de una transferencia. |
Arroja | |
---|---|
DeviceNotAvailableException |
reiniciarHastaEn línea
public void rebootUntilOnline ()
Una alternativa a reboot()
que solo se bloquea hasta que el dispositivo esté en línea, es decir, visible para adb
Arroja | |
---|---|
DeviceNotAvailableException |
reiniciarHastaEn línea
public void rebootUntilOnline (String reason)
Una alternativa a reboot()
que solo se bloquea hasta que el dispositivo esté en línea, es decir, visible para adb
Parámetros | |
---|---|
reason |
String : Es un motivo para el reinicio o null si no se especifica un motivo. |
Arroja | |
---|---|
DeviceNotAvailableException |
espacio de usuario de reinicio
public void rebootUserspace ()
Reinicia solo una parte del espacio del usuario del dispositivo.
Se bloquea hasta que el dispositivo esté disponible.
ADVERTENCIA. En este momento, el reinicio del espacio del usuario está en desarrollo activo. Úsalo bajo tu responsabilidad.
Arroja | |
---|---|
DeviceNotAvailableException |
reiniciarelespaciodeusuarioHastaEn línea
public void rebootUserspaceUntilOnline ()
Una alternativa a rebootUserspace()
()} que solo se bloquea hasta que el dispositivo esté en línea, es decir,
visible para adb.
Arroja | |
---|---|
DeviceNotAvailableException |
recuperarDispositivo
public boolean recoverDevice ()
Intenta recuperar la comunicación con el dispositivo.
Muestra | |
---|---|
boolean |
Es verdadero si se intentó la recuperación correctamente; el resultado es falso si se omitió la recuperación. |
Arroja | |
---|---|
DeviceNotAvailableException |
si el dispositivo ya no está disponible |
registerDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Registra un IDeviceActionReceiver
para este dispositivo.
Se notificará a todos los IDeviceActionReceiver
registrados antes de una acción del dispositivo
y luego de que finalice la acción del dispositivo.
Parámetros | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : Es un IDeviceActionReceiver que se registrará. |
remountSystemReadOnly
public void remountSystemReadOnly ()
Haz que la partición del sistema en el dispositivo sea de solo lectura. Es posible que se reinicie el dispositivo.
Arroja | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
Permite que se pueda escribir en la partición del sistema del dispositivo. Es posible que se reinicie el dispositivo.
Arroja | |
---|---|
DeviceNotAvailableException |
remountVendor (solo lectura)
public void remountVendorReadOnly ()
Haz que la partición del proveedor en el dispositivo sea de solo lectura. Es posible que se reinicie el dispositivo.
Arroja | |
---|---|
DeviceNotAvailableException |
remountVendorWritable
public void remountVendorWritable ()
Permitir que se pueda escribir en la partición del proveedor en el dispositivo. Es posible que se reinicie el dispositivo.
Arroja | |
---|---|
DeviceNotAvailableException |
quitarAdministrador
public boolean removeAdmin (String componentName, int userId)
Quita el administrador de dispositivo determinado de un usuario determinado y muestra true
si se realiza correctamente; de lo contrario, muestra false
.
Parámetros | |
---|---|
componentName |
String : del administrador del dispositivo que se quitará. |
userId |
int : Indica el usuario en el que reside el administrador del dispositivo. |
Muestra | |
---|---|
boolean |
Es verdadero si tiene éxito. De lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
quitarPropietarios
public void removeOwners ()
Quita a todos los propietarios de perfiles de dispositivo existentes con todo lo que puedas.
Arroja | |
---|---|
DeviceNotAvailableException |
quitar el usuario
public boolean removeUser (int userId)
Quitar a un usuario determinado del dispositivo
Parámetros | |
---|---|
userId |
int : del usuario que se quitará |
Muestra | |
---|---|
boolean |
true si logramos eliminar al usuario correctamente; de lo contrario, false. |
Arroja | |
---|---|
DeviceNotAvailableException |
restablecerContentProviderConfiguración
public void resetContentProviderSetup ()
Restablece la marca de la configuración del proveedor de contenido para volver a activarla.
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Método de conveniencia para ejecutar 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 |
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Ejecuta pruebas de instrumentación y proporciona recuperación de dispositivos.
Si se pierde la conexión con el dispositivo antes de que se complete la ejecución de prueba y la recuperación se 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 de los resultados 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 |
runInstrumentationTestsComoUsuario
public 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 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 |
setConfiguration
public void setConfiguration (IConfiguration configuration)
Inserta el IConfiguration
en uso.
Parámetros | |
---|---|
configuration |
IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
Parámetros | |
---|---|
avdInfo |
GceAvdInfo |
Configurar Fecha
public void setDate (Date date)
Establece la fecha en el dispositivo
Nota: La configuración de la fecha en el dispositivo requiere permisos de administrador
Parámetros | |
---|---|
date |
Date : Especifica una fecha en particular. usará la fecha de host si null |
Arroja | |
---|---|
DeviceNotAvailableException |
setDeviceOwner
public boolean setDeviceOwner (String componentName, int userId)
Establece un componente de administración de dispositivos como propietario para un usuario determinado.
Parámetros | |
---|---|
componentName |
String : del administrador del dispositivo será propietario del dispositivo. |
userId |
int : del usuario en el que vive el propietario del dispositivo. |
Muestra | |
---|---|
boolean |
Es verdadero si tiene éxito. De lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
Actualiza el estado del dispositivo.
Parámetros | |
---|---|
deviceState |
TestDeviceState : el TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
Para el emulador, configura SizeLimitedOutputStream
para registrar resultados
Parámetros | |
---|---|
output |
SizeLimitedOutputStream : Para registrar el resultado |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Establece Process
, cuando este dispositivo es un emulador.
Parámetros | |
---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Configura la opción fastboot para el dispositivo. Se debe configurar cuando se inicia el dispositivo por primera vez asignados.
Parámetros | |
---|---|
fastbootEnabled |
boolean : Indica si fastboot está disponible para el dispositivo o no. |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Establece la ruta de acceso al objeto binario de fastboot que se debe usar.
Aún se requiere que isFastbootEnabled()
sea verdadero para tener habilitadas las funciones de fastboot.
Parámetros | |
---|---|
fastbootPath |
String |
SetIDevice
public void setIDevice (IDevice newDevice)
Actualiza el IDevice asociado con este ITestDevice.
El nuevo IDevice debe hacer referencia al mismo dispositivo físico que la referencia actual. Este método se llamará si DDMS asignó un nuevo IDevice
Parámetros | |
---|---|
newDevice |
IDevice : el IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Establece el tiempo en ms que se debe esperar antes de iniciar la captura de logcat para un dispositivo en línea.
Parámetros | |
---|---|
delay |
int : la demora en ms |
setOptions
public void setOptions (TestDeviceOptions options)
Establece el TestDeviceOptions
para el dispositivo.
Parámetros | |
---|---|
options |
TestDeviceOptions |
setProperty
public boolean setProperty (String propKey, String propValue)
Establece el valor de la propiedad determinada en el dispositivo. Se requiere que la raíz de adb sea verdadera.
Parámetros | |
---|---|
propKey |
String : Es la clave que se establecerá. |
propValue |
String : Es el valor de la propiedad que se establecerá. |
Muestra | |
---|---|
boolean |
Devuelve True si el comando setprop tuvo éxito; de lo contrario, muestra False. |
Arroja | |
---|---|
DeviceNotAvailableException |
setRecovery
public void setRecovery (IDeviceRecovery recovery)
Configura la 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 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. |
setSetting
public void setSetting (String namespace, String key, String value)
Consulta setSetting(int, String, String, String)
y se realizó en el usuario del sistema.
Parámetros | |
---|---|
namespace |
String |
key |
String |
value |
String |
Arroja | |
---|---|
DeviceNotAvailableException |
setSetting
public void setSetting (int userId, String namespace, String key, String value)
Agrega un valor de configuración al espacio de nombres de un usuario determinado. Algunos parámetros de configuración solo estarán disponibles después de un reinicio. el espacio de nombres debe ser uno de los siguientes: {"system", "secure", "global"}
Parámetros | |
---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
Arroja | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Inserta la instancia ITestLogger
.
Parámetros | |
---|---|
testLogger |
ITestLogger |
setTrackingSerial
public 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 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 void startLogcat ()
Comienza a capturar resultados de logcat del dispositivo en segundo plano.
No tendrá efecto si ya se está capturando el resultado de logcat. Los datos se pueden recuperar más adelante a través de getLogcat.
Cuando el dispositivo ya no esté en uso, se debe llamar a stopLogcat()
.
Por lo general, no es necesario llamar a startLogcat()
y stopLogcat()
cuando
en un contexto de invocación de TF, ya que el framework de TF iniciará y detendrá Logcat.
Usuario de inicio
public boolean startUser (int userId)
Inicia un usuario determinado en segundo plano si está detenido. Si el usuario ya está que se ejecuta en segundo plano, este es un NOOP.
Parámetros | |
---|---|
userId |
int : Del usuario que se iniciará en segundo plano |
Muestra | |
---|---|
boolean |
true si el usuario se inició correctamente en segundo plano. |
Arroja | |
---|---|
DeviceNotAvailableException |
Usuario de inicio
public boolean startUser (int userId, boolean waitFlag)
Inicia un usuario determinado en segundo plano si está detenido. Si el usuario ya está que se ejecuta en segundo plano, este es un NOOP. Es posible proporcionar marcas adicionales para esperar para que surta efecto la operación.
Parámetros | |
---|---|
userId |
int : Del usuario que se iniciará en segundo plano |
waitFlag |
boolean : Hace que el comando espere hasta que el usuario se inicie y se desbloquee. |
Muestra | |
---|---|
boolean |
true si el usuario se inició correctamente en segundo plano. |
Arroja | |
---|---|
DeviceNotAvailableException |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
Inicia un usuario determinado en segundo plano, visible en la pantalla determinada (es decir, permitiendo al usuario para iniciar actividades en esa pantalla).
NOTA: Este comando no verifica si el usuario existe, si la pantalla está disponible, device supports such feature
, etcétera.
Parámetros | |
---|---|
userId |
int : Del usuario que se iniciará en segundo plano |
displayId |
int : Muestra para que el usuario sea visible en |
waitFlag |
boolean : Hace que el comando espere hasta que el usuario se inicie y se desbloquee. |
Muestra | |
---|---|
boolean |
Es true si el usuario se inició correctamente en segundo plano. |
Arroja | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
Cierra y borra el resultado del emulador.
detenerLogcat
public void stopLogcat ()
Detén la captura de resultados de logcat del dispositivo y descarta los datos de logcat guardados actualmente.
No tendrá efecto si no se captura el resultado de logcat.
usuario detención
public boolean stopUser (int userId)
Detiene a un usuario determinado. Si el usuario ya se detuvo, este método es un NOOP. No se pueden detener el usuario actual y el del sistema.
Parámetros | |
---|---|
userId |
int : del usuario que debe detenerse |
Muestra | |
---|---|
boolean |
true si el usuario se detuvo correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
usuario detención
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
Detener un usuario determinado Es posible proporcionar marcas adicionales para esperar a que la operación tenga efecto. y forzar la rescisión del usuario. No se pueden detener el usuario actual y el del sistema.
Parámetros | |
---|---|
userId |
int : del usuario que debe detenerse |
waitFlag |
boolean : Hace que el comando espere hasta que se detenga el usuario. |
forceFlag |
boolean : Forzará la detención del usuario. |
Muestra | |
---|---|
boolean |
true si el usuario se detuvo correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
switchToAdbTcp
public 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 | |
---|---|
DeviceNotAvailableException |
cambiarAAdbusb
public boolean switchToAdbUsb ()
Cambia el dispositivo al modo adb mediante USB.
Muestra | |
---|---|
boolean |
true si el cambio se realizó correctamente; de lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
Cambiar de usuario
public boolean switchUser (int userId)
Cambia a otro userId con un tiempo de espera predeterminado. switchUser(int, long)
.
Parámetros | |
---|---|
userId |
int |
Muestra | |
---|---|
boolean |
Es verdadero si el userId nuevo coincide con el proveedor de userId. De lo contrario, el valor es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
Cambiar de usuario
public boolean switchUser (int userId, long timeout)
Cambia a otro userId con el tiempo de espera proporcionado como fecha límite. Se intenta inhabilitar el bloqueo del teclado después de que se realiza correctamente el cambio de usuario.
Parámetros | |
---|---|
userId |
int |
timeout |
long : Espera antes de mostrar un valor falso para switch-user. |
Muestra | |
---|---|
boolean |
Es verdadero si el userId nuevo coincide con el proveedor de userId. De lo contrario, el valor es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
Archivos sincronizados
public boolean syncFiles (File localFileDir, String deviceFilePath)
Sincroniza de forma incremental el contenido de un directorio de archivos local con el dispositivo.
Decide qué archivos enviar comparando las marcas de tiempo de los archivos locales con 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 |
informe de errores de toma
public Bugreport takeBugreport ()
Toma un informe de errores y lo muestra dentro de un objeto Bugreport
para controlarlo. Se muestra un valor nulo
en caso de que haya un problema. El archivo al que se hace referencia en el objeto del informe de errores se debe limpiar a través de Bugreport.close()
.
Muestra | |
---|---|
Bugreport |
desinstalarPaquete
public String uninstallPackage (String packageName)
Desinstala un paquete de Android del dispositivo.
Parámetros | |
---|---|
packageName |
String : Es el paquete de Android que se desinstalará. |
Muestra | |
---|---|
String |
una String con un código de error, o null si se ejecuta de forma correcta. |
Arroja | |
---|---|
DeviceNotAvailableException |
desinstalarPaqueteParaUsuario
public String uninstallPackageForUser (String packageName, int userId)
Desinstala el paquete de Android del dispositivo para un usuario determinado.
Parámetros | |
---|---|
packageName |
String : Es el paquete de Android que se desinstalará. |
userId |
int : Es el ID de usuario entero para el que se debe desinstalar. |
Muestra | |
---|---|
String |
una String con un código de error, o null si se ejecuta de forma correcta. |
Arroja | |
---|---|
DeviceNotAvailableException |
desbloquearDispositivo
public boolean unlockDevice ()
Desbloquea el dispositivo si está encriptado.
Este método puede reiniciar el framework, pero no llamará apostBootSetup()
. 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 |
waitForBootComplete
public boolean waitForBootComplete (long timeOut)
Se bloquea hasta que se establezca la marca de inicio completado del dispositivo.
Parámetros | |
---|---|
timeOut |
long : Tiempo en ms para esperar a que se establezca la marca |
Muestra | |
---|---|
boolean |
true si la marca de inicio completado del dispositivo se establece dentro del tiempo de espera |
Arroja | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable ()
Espera a que el dispositivo responda y esté disponible para las pruebas. Usa el tiempo de espera predeterminado.
Muestra | |
---|---|
boolean |
Verdadero si el dispositivo está disponible. Falso si la recuperación está inhabilitada y no está disponible. |
Arroja | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable (long waitTime)
Espera a que el dispositivo responda y esté disponible para las pruebas.
Parámetros | |
---|---|
waitTime |
long : Es el tiempo en ms que se debe esperar. |
Muestra | |
---|---|
boolean |
Verdadero si el dispositivo está disponible. Falso si la recuperación está inhabilitada y no está disponible. |
Arroja | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Espera a que el dispositivo responda y esté disponible sin considerar la ruta de recuperación.
Parámetros | |
---|---|
waitTime |
long |
Muestra | |
---|---|
boolean |
Verdadero si el dispositivo está disponible. Falso si no lo está. |
Arroja | |
---|---|
DeviceNotAvailableException |
waitForDeviceBootloader
public void waitForDeviceBootloader ()
Se bloquea hasta que el dispositivo sea visible mediante fastboot. Usar el tiempo de espera predeterminado
Arroja | |
---|---|
DeviceNotAvailableException |
waitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
Bloqueos para que el dispositivo esté en la "recuperación de adb" (ten en cuenta que esto es distinto 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 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 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 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 |
waitForDeviceEn línea
public void waitForDeviceOnline (long waitTime)
Se bloquea hasta que el dispositivo sea visible mediante adb.
Ten en cuenta que es posible que el dispositivo no responda a los comandos una vez completado. Usa
waitForDeviceAvailable()
en su lugar.
Parámetros | |
---|---|
waitTime |
long : Es el tiempo en ms que se debe esperar. |
Arroja | |
---|---|
DeviceNotAvailableException |
waitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
Espera a que el dispositivo responda a un comando shell adb básico.
Parámetros | |
---|---|
waitTime |
long : Es el tiempo en ms que se debe esperar. |
Muestra | |
---|---|
boolean |
Es true si el dispositivo responde antes de que transcurra la waitTime. |
Métodos protegidos
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
Parámetros | |
---|---|
builder |
DefaultConnection.ConnectionBuilder |
Comando buildAdbShell
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
Compila el comando de SO para la sesión y los argumentos del comando de shell adb determinados.
Parámetros | |
---|---|
command |
String |
forceExitStatusDetection |
boolean |
Muestra | |
---|---|
String[] |
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
Parámetros | |
---|---|
feature |
String |
strictMinLevel |
int |
createRestartDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Crea un RebootDeviceAction
para usar cuando se realice una acción de reinicio.
Parámetros | |
---|---|
rebootMode |
NativeDevice.RebootMode : Es un modo de este reinicio. |
reason |
String : Para este reinicio. |
Muestra | |
---|---|
NativeDevice.RebootDeviceAction |
el RebootDeviceAction creado. |
Reinicio de doAdb
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Ejecuta un reinicio de adb.
Parámetros | |
---|---|
rebootMode |
NativeDevice.RebootMode : Es un modo de este reinicio. |
reason |
String : Para este reinicio. |
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
AssuredRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
un método auxiliar para arrojar una excepción si no se admite el permiso de tiempo de ejecución
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
Muestra | |
---|---|
int |
getRunUtil
protected IRunUtil getRunUtil ()
Obtén la instancia de RunUtil
que se usará.
Muestra | |
---|---|
IRunUtil |
inicializarConnection
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Parámetros | |
---|---|
info |
IBuildInfo |
attributes |
MultiMap |
Arroja | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
internalGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
Recupera una propiedad de dispositivo, a partir de la caché de ddmlib de forma predeterminada, y recurrir a "adb" shell getprop` o `fastboot getvar`, según si el dispositivo está en Fastboot o no.
Parámetros | |
---|---|
propName |
String : Es el nombre de la propiedad del dispositivo como lo muestra "adb shell getprop". |
fastbootVar |
String : Es el nombre de la variable de fastboot equivalente que se debe consultar. si null ,
No se intentará realizar la consulta de fastboot |
description |
String : Es una descripción simple de la variable. La primera letra debe estar en mayúscula. |
Muestra | |
---|---|
String |
Es una cadena, posiblemente null o vacía, que contiene el valor de la propiedad determinada. |
Arroja | |
---|---|
DeviceNotAvailableException |
isInRestartCallback
protected boolean isInRebootCallback ()
Muestra si las devoluciones de llamada de reinicio se están ejecutando o no. Todas las APIs públicas son para el reinicio se debe inhabilitar si es verdadero.
Muestra | |
---|---|
boolean |
Más reciente
protected boolean isNewer (File localFile, IFileEntry entry)
Muestra true
si el archivo local es más reciente que el archivo remoto. IFileEntry
es
con precisión minuto a minuto, en caso de que la misma cantidad de veces, el archivo se considere más nuevo.
Parámetros | |
---|---|
localFile |
File |
entry |
IFileEntry |
Muestra | |
---|---|
boolean |
notificar RestartEnded
protected void notifyRebootEnded ()
Notifica a todos los IDeviceActionReceiver
sobre el evento de finalización de reinicio.
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Notificar ReiniciarInicio
protected void notifyRebootStarted ()
Notifica a todos los IDeviceActionReceiver
sobre el evento de inicio de reinicio.
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
realice una acción en el dispositivo
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Realiza una acción en este dispositivo. Intenta recuperar el dispositivo y, opcionalmente, vuelve a intentar el comando si la acción falla.
Parámetros | |
---|---|
actionDescription |
String : Es una descripción breve de la acción que se realizará. Se usa para el registro
con fines de seguridad. |
action |
NativeDevice.DeviceAction : Es la acción que se realizará. |
retryAttempts |
int : El reintento intenta realizar la acción si falla, pero la recuperación se realiza correctamente. |
Muestra | |
---|---|
boolean |
true si la acción se realizó correctamente |
Arroja | |
---|---|
DeviceNotAvailableException |
si falla el intento de recuperación o la cantidad máxima de intentos realizados sin correcto |
relanzamiento de post Adb
protected void postAdbReboot ()
Posibles acciones adicionales que se pueden realizar después de reiniciar el dispositivo.
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Configuración previa al inicio posterior
protected void prePostBootSetup ()
Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) anule este método para una configuración específica posterior al inicio.
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
pullFileInterno
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Parámetros | |
---|---|
remoteFilePath |
String |
localFile |
File |
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
Configurar reloj
protected void setClock (Clock clock)
Configura la instancia de reloj que se usará.
Parámetros | |
---|---|
clock |
Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
Marca el TestDevice como microdroid y establece su CID.
Parámetros | |
---|---|
process |
Process : Proceso de la VM de Microdroid. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
Parámetros | |
---|---|
deviceOptions |
|
Comando simpleFastboot
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Ejecuta un comando fastboot simple con variables de entorno e informa el estado de la kubectl.
Parámetros | |
---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
Muestra | |
---|---|
CommandResult |
Comando simpleFastboot
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Ejecuta un comando fastboot simple y, luego, informa el estado del comando.
Parámetros | |
---|---|
timeout |
long |
fullCmd |
String |
Muestra | |
---|---|
CommandResult |
waitForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
Espera a que el dispositivo deje de estar disponible (deja de informar a adb).
Parámetros | |
---|---|
operationDesc |
String : Es el nombre de la operación que espera que no esté disponible. |
time |
long : Es el tiempo que se debe esperar hasta que ocurra un evento no disponible. |
Muestra | |
---|---|
boolean |
Es verdadero si el dispositivo no está disponible. |