A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.

Se usó la API de Cloud Translation para traducir esta página.

StubDevice

public class StubDevice
extends Object implements IDevice

java.lang.Object
↳	com.android.tradefed.device.StubDevice

Subclases directas conocidas

DeviceManager.FastbootDevice, NullDevice, RemoteAvdIDevice, StubLocalAndroidVirtualDevice, VmRemoteDevice

DeviceManager.FastbootDevice	Representación de un dispositivo en modo fastboot.
NullDevice	Es un marcador de posición `IDevice` que usa `DeviceManager` para asignar cuándo `IDeviceSelection.nullDeviceRequested()` es `true`.
RemoteAvdIDevice	Es un marcador de posición `IDevice` que usa `DeviceManager` para asignar cuándo `DeviceSelectionOptions.gceDeviceRequested()` es `true`.
StubLocalAndroidVirtualDevice	Es un marcador de posición `IDevice` que usa `DeviceManager` para asignar cuándo `DeviceSelectionOptions.localVirtualDeviceRequested()` es `true`.
VmRemoteDevice	Un dispositivo virtual remoto que administraremos desde la máquina virtual.

Es una implementación de marcador de posición de stub de un IDevice.

Resumen

Constructores públicos
`StubDevice(String serial)`
`StubDevice(String serial, boolean isEmulator)`

Métodos públicos
`boolean`	`arePropertiesSet()` Devuelve `true` si las propiedades se almacenaron en caché.
`void`	`createForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)` Crea un reenvío de puertos entre un puerto TCP local y un socket de dominio Unix remoto.
`void`	`createForward(int localPort, int remotePort)` Crea un reenvío de puertos entre un puerto local y uno remoto.
`void`	`createReverse(int remotePort, int localPort)` Crea una inversión de puertos entre un puerto remoto y uno local.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Ejecuta un comando shell en el dispositivo y envía el resultado a un `receiver`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Ejecuta un comando shell en el dispositivo y envía el resultado a un `receiver` Esto es similar a llamar a `executeShellCommand(command, receiver, DdmPreferences.getTimeOut())`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)` Este método dejó de estar disponible. usar `executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit)`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Ejecuta un comando shell en el dispositivo y envía el resultado a un `receiver`.
	`getAbis()` Devuelve las ABI que admite este dispositivo.
`String`	`getAvdName()` Devuelve el nombre del AVD en el que se ejecuta el emulador.
`String`	`getAvdPath()` Devuelve la ruta de acceso absoluta al dispositivo virtual en el sistema de archivos.
	`getBattery(long freshnessTime, TimeUnit timeUnit)` Devuelve el nivel de batería del dispositivo, de 0 a 100 por ciento.
	`getBattery()` Devuelve el nivel de batería del dispositivo, de 0 a 100 por ciento.
`Integer`	`getBatteryLevel(long freshnessMs)` Este método dejó de estar disponible. utiliza `getBattery(long, TimeUnit)` en su lugar.
`Integer`	`getBatteryLevel()` Este método dejó de estar disponible. utiliza `getBattery()` en su lugar.
`Client`	`getClient(String applicationName)` Devuelve un `Client` por el nombre de la aplicación.
`String`	`getClientName(int pid)` Devuelve el nombre del cliente por PID o `null` si el PID es desconocido.
`Client[]`	`getClients()` Devuelve el array de clientes.
`int`	`getDensity()` Devuelve el bucket de densidad de la pantalla del dispositivo leyendo el valor de la propiedad del sistema `PROP_DEVICE_DENSITY`.
`FileListingService`	`getFileListingService()` Devuelve un `FileListingService` para este dispositivo.
`String`	`getLanguage()` Devuelve el idioma del usuario.
`String`	`getMountPoint(String name)` Devuelve un punto de activación.
`String`	`getName()` Devuelve un nombre (humanizado) para este dispositivo.
	`getProperties()` Este método dejó de estar disponible. utiliza `getSystemProperty(String)` en su lugar.
`String`	`getProperty(String name)` Método de conveniencia que intenta recuperar una propiedad a través de `IShellEnabledDevice.getSystemProperty(String)` con un tiempo de espera muy corto y omite las excepciones.
`String`	`getPropertyCacheOrSync(String name)` Este método dejó de estar disponible. utiliza `getProperty(String)` en su lugar.
`int`	`getPropertyCount()` Este método dejó de estar disponible. obsoleto en ddmlib con "detalle de implementación" como motivo.
`String`	`getPropertySync(String name)` Este método dejó de estar disponible. utiliza `getProperty(String)` en su lugar.
`String`	`getRegion()` Devuelve la región del usuario.
`RawImage`	`getScreenshot()` Toma una captura de pantalla del dispositivo y la devuelve como un objeto `RawImage`.
`RawImage`	`getScreenshot(long timeout, TimeUnit unit)`
`String`	`getSerialNumber()` Devuelve el número de serie del dispositivo.
`IDevice.DeviceState`	`getState()` Devuelve el estado del dispositivo.
`SyncService`	`getSyncService()` Devuelve un objeto `SyncService` para transferir archivos al dispositivo y desde este.
`ListenableFuture<String>`	`getSystemProperty(String name)` Realiza una posible consulta asíncrona para una propiedad del sistema.
`boolean`	`hasClients()` Devuelve si el `IDevice` tiene `Client`s.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` Instala una aplicación para Android en el dispositivo.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Instala una aplicación para Android en el dispositivo.
`void`	`installPackage(String packageFilePath, boolean reinstall, String... extraArgs)` Instala una aplicación para Android en el dispositivo.
`void`	`installPackages( apkFilePaths, boolean reinstall, extraArgs, long timeOutInMs, TimeUnit timeunit)` Instala una aplicación para Android compuesta por varios archivos APK (uno principal y de 0 a n paquetes divididos).
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Instala el paquete de aplicación que se envió a una ubicación temporal en el dispositivo.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, String... extraArgs)` Instala el paquete de aplicación que se envió a una ubicación temporal en el dispositivo.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` Instala el paquete de aplicación que se envió a una ubicación temporal en el dispositivo.
`boolean`	`isBootLoader()` Devuelve si el dispositivo está en modo de bootloader.
`boolean`	`isEmulator()` Devuelve `true` si el dispositivo es un emulador.
`boolean`	`isOffline()` Devuelve si el dispositivo no tiene conexión.
`boolean`	`isOnline()` Devuelve si el dispositivo está listo.
`boolean`	`isRoot()` Consulta el estado de raíz actual del dispositivo.
`void`	`pullFile(String remote, String local)` Extrae un solo archivo.
`void`	`pushFile(String local, String remote)` Envía un solo archivo.
`void`	`reboot(String into)` Reinicia el dispositivo.
`void`	`removeForward(int localPort)` Quita un reenvío de puerto entre un puerto local y uno remoto.
`void`	`removeForward(int localPort, int remotePort)`
`void`	`removeForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)`
`void`	`removeRemotePackage(String remoteFilePath)` Quita un archivo del dispositivo.
`void`	`removeReverse(int remotePort)` Quita la inversión de puertos entre un puerto remoto y uno local.
`boolean`	`root()` Solicita al daemon de adb que se convierta en raíz en el dispositivo.
`void`	`setSerial(String serial)`
`void`	`startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` Inicia la grabación de pantalla en el dispositivo si este admite `IDevice.Feature.SCREEN_RECORD`.
`boolean`	`supportsFeature(IDevice.HardwareFeature arg0)` Devuelve si este dispositivo admite la función de hardware determinada.
`boolean`	`supportsFeature(IDevice.Feature feature)` Devuelve un valor que indica si este dispositivo admite la función de software determinada.
`String`	`syncPackageToDevice(String localFilePath)` Envía un archivo al dispositivo
`String`	`uninstallApp(String applicationID, String... extraArgs)` Desinstala una app del dispositivo.
`String`	`uninstallPackage(String packageName)` Desinstala un paquete del dispositivo.

Constructores públicos

StubDevice

public StubDevice (String serial)

Parámetros
`serial`	`String`

StubDevice

public StubDevice (String serial, 
                boolean isEmulator)

Parámetros
`serial`	`String`
`isEmulator`	`boolean`

Métodos públicos

arePropertiesSet

public boolean arePropertiesSet ()

Devuelve true si las propiedades se almacenaron en caché.

Muestra
`boolean`

createForward

public void createForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

Crea un reenvío de puertos entre un puerto TCP local y un socket de dominio Unix remoto.

Parámetros
`localPort`	`int`: Es el puerto local que se reenvía.
`remoteSocketName`	`String`: Nombre del socket de dominio de Unix creado en el dispositivo
`namespace`	`IDevice.DeviceUnixSocketNamespace`: Es el espacio de nombres en el que se creó el socket de dominio de Unix.

Arroja
`AdbCommandRejectedException`
`TimeoutException`

createForward

public void createForward (int localPort, 
                int remotePort)

Crea un reenvío de puertos entre un puerto local y uno remoto.

Parámetros
`localPort`	`int`: Es el puerto local que se reenvía.
`remotePort`	`int`: Es el puerto remoto.

Arroja
`AdbCommandRejectedException`
`TimeoutException`

createReverse

public void createReverse (int remotePort, 
                int localPort)

Crea una inversión de puertos entre un puerto remoto y uno local.

Parámetros
`remotePort`	`int`: Es el puerto remoto que se debe invertir.
`localPort`	`int`: el puerto local

Arroja
`AdbCommandRejectedException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Ejecuta un comando shell en el dispositivo y envía el resultado a un receiver.

maxTimeToOutputResponse se usa como tiempo de espera máximo cuando se espera el resultado del comando del dispositivo.
En cualquier momento, si el comando de shell no genera ningún resultado durante un período superior a maxTimeToOutputResponse, el método arrojará ShellCommandUnresponsiveException.

Para comandos como la salida de registro, se debe usar un valor de maxTimeToOutputResponse de 0, lo que significa que el método nunca arrojará una excepción y se bloqueará hasta que el IShellOutputReceiver.isCancelled() del receptor devuelva true.

Parámetros
`command`	`String`: Es el comando de shell que se ejecutará.
`receiver`	`IShellOutputReceiver`: Es el `IShellOutputReceiver` que recibirá el resultado del comando de shell.
`maxTimeToOutputResponse`	`long`: Es la cantidad máxima de tiempo durante la cual el comando puede no generar ninguna respuesta. Un valor de 0 significa que el método esperará indefinidamente (hasta que `receiver` cancele la ejecución) la salida del comando y nunca arrojará una excepción.
`maxTimeUnits`	`TimeUnit`: Son las unidades para los valores de `maxTimeToOutputResponse` distintos de cero.

Arroja
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Ejecuta un comando shell en el dispositivo y envía el resultado a un receiver

Esto es similar a llamar a executeShellCommand(command, receiver, DdmPreferences.getTimeOut()).

Parámetros
`command`	`String`: Es el comando de shell que se ejecutará.
`receiver`	`IShellOutputReceiver`: Es el `IShellOutputReceiver` que recibirá el resultado del comando de shell.

Arroja
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                int maxTimeToOutputResponse)

Este método dejó de estar disponible.
use executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit).

Parámetros
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`int`

Arroja
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Ejecuta un comando shell en el dispositivo y envía el resultado a un receiver.

Parámetros
`command`	`String`: Es el comando de shell que se ejecutará.
`receiver`	`IShellOutputReceiver`: Es el `IShellOutputReceiver` que recibirá el resultado del comando de shell.
`maxTimeout`	`long`: Es el tiempo de espera máximo para que se muestre el comando. Un valor de 0 significa que no se aplicará un tiempo de espera máximo.
`maxTimeToOutputResponse`	`long`: Es la cantidad máxima de tiempo durante la cual el comando puede no generar ninguna respuesta. Un valor de 0 significa que el método esperará indefinidamente (hasta que `receiver` cancele la ejecución) la salida del comando y nunca arrojará una excepción.
`maxTimeUnits`	`TimeUnit`: Unidades para los valores `maxTimeout` y `maxTimeToOutputResponse` distintos de cero.

Arroja
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getAbis

public  getAbis ()

Devuelve las ABI que admite este dispositivo. Los ABIs se ordenan según la preferencia, y el primer ABI es el más preferido.

Muestra
	La lista de ABIs.

getAvdName

public String getAvdName ()

Devuelve el nombre del AVD en el que se ejecuta el emulador.

Esto solo es válido si isEmulator() devuelve verdadero.

Si el emulador no ejecuta ningún AVD (por ejemplo, si se ejecuta desde una compilación de árbol de código fuente de Android), este método devolverá "<build>".

Nota: Se recomienda usar getAvdData() si deseas controlar el tiempo de espera.

Muestra
`String`	El nombre del AVD o `null` si no hay ninguno.

getAvdPath

public String getAvdPath ()

Devuelve la ruta de acceso absoluta al dispositivo virtual en el sistema de archivos. La ruta depende del sistema operativo; tendrá separadores de nombre / en Linux y separadores \ en Windows.

Nota: Se recomienda usar getAvdData() si deseas controlar el tiempo de espera.

Muestra
`String`	La ruta de acceso del AVD o null si se trata de un dispositivo físico, si falló el subcomando de la consola del emulador o si la versión del emulador es anterior a la 30.0.18

getBattery

public  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

Devuelve el nivel de batería del dispositivo, de 0 a 100 por ciento.

Es posible que el nivel de batería se almacene en caché. Solo consulta el nivel de batería del dispositivo si freshnessTime venció desde la última consulta exitosa.

Parámetros
`freshnessTime`	`long`: Es la antigüedad deseada del nivel de batería.
`timeUnit`	`TimeUnit`: Es el `ERROR(/TimeUnit)` de freshnessTime.

Muestra
	Un `ERROR(/Future)` que se puede usar para consultar el nivel de batería. El objeto Future devolverá un `ERROR(/ExecutionException)` si no se pudo recuperar el nivel de batería.

getBattery

public  getBattery ()

Devuelve el nivel de batería del dispositivo, de 0 a 100 por ciento.

Es posible que el nivel de batería se almacene en caché. Solo consulta el nivel de batería del dispositivo si transcurrieron 5 minutos desde la última consulta exitosa.

Muestra
	Un `ERROR(/Future)` que se puede usar para consultar el nivel de batería. El objeto Future devolverá un `ERROR(/ExecutionException)` si no se pudo recuperar el nivel de batería.

getBatteryLevel

public Integer getBatteryLevel (long freshnessMs)

Este método dejó de estar disponible.
En su lugar, usa getBattery(long, TimeUnit).

Devuelve el nivel de batería del dispositivo, de 0 a 100 por ciento.

Es posible que el nivel de batería se almacene en caché. Solo consulta el nivel de batería del dispositivo si transcurrieron freshnessMs ms desde la última consulta exitosa.

Muestra
`Integer`	El nivel de batería o `null` si no se pudo recuperar

Arroja
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getBatteryLevel

public Integer getBatteryLevel ()

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

Devuelve el nivel de batería del dispositivo, de 0 a 100 por ciento.

Es posible que el nivel de batería se almacene en caché. Solo consulta el nivel de batería del dispositivo si transcurrieron 5 minutos desde la última consulta exitosa.

Muestra
`Integer`	El nivel de batería o `null` si no se pudo recuperar

Arroja
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getClient

public Client getClient (String applicationName)

Devuelve un Client por el nombre de la aplicación.

Parámetros
`applicationName`	`String`: El nombre de la aplicación

Muestra
`Client`	El objeto `Client` o `null` si no se encontró ninguna coincidencia.

getClientName

public String getClientName (int pid)

Devuelve el nombre del cliente por PID o null si el PID es desconocido.

Parámetros
`pid`	`int`: Es el PID del cliente.

Muestra
`String`

getClients

public Client[] getClients ()

Devuelve el array de clientes.

Muestra
`Client[]`

getDensity

public int getDensity ()

Devuelve el bucket de densidad de la pantalla del dispositivo leyendo el valor de la propiedad del sistema PROP_DEVICE_DENSITY.

Muestra
`int`	La densidad, o -1 si no se puede determinar.

getFileListingService

public FileListingService getFileListingService ()

Devuelve un FileListingService para este dispositivo.

Muestra
`FileListingService`

getLanguage

public String getLanguage ()

Devuelve el idioma del usuario.

Muestra
`String`	Idioma del usuario o nulo si se desconoce

getMountPoint

public String getMountPoint (String name)

Devuelve un punto de activación.

Parámetros
`name`	`String`: Es el nombre del punto de montaje que se devolverá.

Muestra
`String`

getName

public String getName ()

Devuelve un nombre (humanizado) para este dispositivo. Por lo general, este es el nombre del AVD para los AVD y una combinación del nombre del fabricante, el nombre del modelo y el número de serie para los dispositivos.

Muestra
`String`

getProperties

public  getProperties ()

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

Devuelve las propiedades del dispositivo almacenadas en caché. Contiene toda la salida de "getprop".

Muestra

getProperty

public String getProperty (String name)

Método de conveniencia que intenta recuperar una propiedad a través de IShellEnabledDevice.getSystemProperty(String) con un tiempo de espera muy corto y omite las excepciones.

Nota: Se recomienda usar IShellEnabledDevice.getSystemProperty(String) si deseas controlar el tiempo de espera.

Parámetros
`name`	`String`: Es el nombre del valor que se devolverá.

Muestra
`String`	El valor o `null` si el valor de la propiedad no estaba disponible de inmediato

getPropertyCacheOrSync

public String getPropertyCacheOrSync (String name)

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

Combinación de getProperty(String) y getPropertySync(String) que intentará recuperar la propiedad de la caché. Si no se encuentra, intentará de forma síncrona consultar el dispositivo directamente y volverá a completar la caché si tiene éxito.

Parámetros
`name`	`String`: Es el nombre del valor que se devolverá.

Muestra
`String`	El valor o `null` si la propiedad no existe

Arroja
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getPropertyCount

public int getPropertyCount ()

Este método dejó de estar disponible.
obsoleto en ddmlib con "detalle de implementación" como motivo.

Devuelve la cantidad de propiedades de este dispositivo.

Muestra
`int`

getPropertySync

public String getPropertySync (String name)

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

Es una variante de getProperty(String) que intentará recuperar la propiedad determinada directamente del dispositivo, sin usar la caché. Este método solo se debe usar para las propiedades volátiles.

Parámetros
`name`	`String`: Es el nombre del valor que se devolverá.

Muestra
`String`	El valor o `null` si la propiedad no existe

Arroja
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getRegion

public String getRegion ()

Devuelve la región del usuario.

Muestra
`String`	La región del usuario o null si se desconoce

getScreenshot

public RawImage getScreenshot ()

Toma una captura de pantalla del dispositivo y la devuelve como un objeto RawImage.

Muestra
`RawImage`	La captura de pantalla como `RawImage` o `null` si algo salió mal

Arroja
`AdbCommandRejectedException`
`TimeoutException`

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Parámetros
`timeout`	`long`
`unit`	`TimeUnit`

Muestra
`RawImage`

Arroja
`AdbCommandRejectedException`
`TimeoutException`

getSerialNumber

public String getSerialNumber ()

Devuelve el número de serie del dispositivo.

Muestra
`String`

getState

public IDevice.DeviceState getState ()

Devuelve el estado del dispositivo.

Muestra
`IDevice.DeviceState`

getSyncService

public SyncService getSyncService ()

Devuelve un objeto SyncService para transferir archivos al dispositivo y desde este.

Muestra
`SyncService`	`null` si no se pudo crear el SyncService. Esto puede ocurrir si adb se niega a abrir la conexión porque `IDevice` no es válido (o se desconectó).

Arroja
`AdbCommandRejectedException`
`TimeoutException`

getSystemProperty

public ListenableFuture<String> getSystemProperty (String name)

Realiza una posible consulta asíncrona para una propiedad del sistema.

Parámetros
`name`	`String`: Es el nombre del valor que se devolverá.

Muestra
`ListenableFuture<String>`	un `ListenableFuture.` `ERROR(get/Future#get() get)` puede devolver un valor nulo.

hasClients

public boolean hasClients ()

Devuelve si el IDevice tiene Clients.

Muestra
`boolean`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

Instala una aplicación para Android en el dispositivo. Este es un método auxiliar que combina los pasos de syncPackageToDevice, installRemotePackage y removePackage.

Parámetros
`packageFilePath`	`String`: Es la ruta de acceso absoluta del sistema de archivos al archivo del host local que se instalará.
`reinstall`	`boolean`: Se establece en `true` si se debe reinstalar la app.
`receiver`	`InstallReceiver`: Es el `InstallReceiver` que se usará para supervisar la instalación y obtener el estado final.
`maxTimeout`	`long`: Es el tiempo de espera máximo para que se muestre el comando. Un valor de 0 significa que no se aplicará un tiempo de espera máximo.
`maxTimeToOutputResponse`	`long`: Es la cantidad máxima de tiempo durante la cual el comando puede no generar ninguna respuesta. Un valor de 0 significa que el método esperará indefinidamente (hasta que `receiver` cancele la ejecución) la salida del comando y nunca arrojará una excepción.
`maxTimeUnits`	`TimeUnit`: Unidades para los valores `maxTimeout` y `maxTimeToOutputResponse` distintos de cero.
`extraArgs`	`String`: Son argumentos adicionales opcionales que se pueden pasar. Consulta "adb shell pm install --help" para ver las opciones disponibles.

Arroja
`InstallException`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

Instala una aplicación para Android en el dispositivo. Este es un método auxiliar que combina los pasos de syncPackageToDevice, installRemotePackage y removePackage.

Parámetros
`packageFilePath`	`String`: Es la ruta de acceso absoluta del sistema de archivos al archivo del host local que se instalará.
`reinstall`	`boolean`: Se establece en `true` si se debe reinstalar la app.
`receiver`	`InstallReceiver`: Es el `InstallReceiver` que se usará para supervisar la instalación y obtener el estado final.
`extraArgs`	`String`: Son argumentos adicionales opcionales que se pueden pasar. Consulta "adb shell pm install --help" para ver las opciones disponibles.

Arroja
`InstallException`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                String... extraArgs)

Instala una aplicación para Android en el dispositivo. Este es un método auxiliar que combina los pasos de syncPackageToDevice, installRemotePackage y removePackage.

Parámetros
`packageFilePath`	`String`: Es la ruta de acceso absoluta del sistema de archivos al archivo del host local que se instalará.
`reinstall`	`boolean`: Se establece en `true` si se debe reinstalar la app.
`extraArgs`	`String`: Son argumentos adicionales opcionales que se pueden pasar. Consulta "adb shell pm install --help" para ver las opciones disponibles.

Arroja
`InstallException`

installPackages

public void installPackages ( apkFilePaths, 
                boolean reinstall, 
                 extraArgs, 
                long timeOutInMs, 
                TimeUnit timeunit)

Instala una aplicación para Android compuesta por varios archivos APK (uno principal y de 0 a n paquetes divididos).

Parámetros
`apkFilePaths`	: Lista de APKs para instalar (1 APK principal y de 0 a n APKs divididos)
`reinstall`	`boolean`: Se establece en `true` si se debe reinstalar la app.
`extraArgs`	: Son argumentos adicionales opcionales que se pueden pasar. Consulta "adb shell pm install --help" para ver las opciones disponibles.
`timeOutInMs`	`long`: Se agotó el tiempo de espera de la instalación
`timeunit`	`TimeUnit`: `ERROR(/TimeUnit)` correspondiente al parámetro de tiempo de espera

Arroja
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

Instala el paquete de aplicación que se envió a una ubicación temporal en el dispositivo.

Parámetros
`remoteFilePath`	`String`: Ruta de acceso absoluta al archivo del paquete en el dispositivo
`reinstall`	`boolean`: Se establece en `true` si se debe reinstalar la app.
`receiver`	`InstallReceiver`: Es el `InstallReceiver` que se usará para supervisar la instalación y obtener el estado final.
`extraArgs`	`String`: Son argumentos adicionales opcionales que se pueden pasar. Consulta "adb shell pm install --help" para ver las opciones disponibles.

Arroja
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                String... extraArgs)

Instala el paquete de aplicación que se envió a una ubicación temporal en el dispositivo.

Parámetros
`remoteFilePath`	`String`: Ruta de acceso absoluta al archivo del paquete en el dispositivo
`reinstall`	`boolean`: Se establece en `true` si se debe reinstalar la app.
`extraArgs`	`String`: Son argumentos adicionales opcionales que se pueden pasar. Consulta "adb shell pm install --help" para ver las opciones disponibles.

Arroja
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

Instala el paquete de aplicación que se envió a una ubicación temporal en el dispositivo.

Parámetros
`remoteFilePath`	`String`: Ruta de acceso absoluta al archivo del paquete en el dispositivo
`reinstall`	`boolean`: Se establece en `true` si se debe reinstalar la app.
`receiver`	`InstallReceiver`: Es el `InstallReceiver` que se usará para supervisar la instalación y obtener el estado final.
`maxTimeout`	`long`: Es el tiempo de espera máximo para que se muestre el comando. Un valor de 0 significa que no se aplicará un tiempo de espera máximo.
`maxTimeToOutputResponse`	`long`: Es la cantidad máxima de tiempo durante la cual el comando puede no generar ninguna respuesta. Un valor de 0 significa que el método esperará indefinidamente (hasta que `receiver` cancele la ejecución) la salida del comando y nunca arrojará una excepción.
`maxTimeUnits`	`TimeUnit`: Unidades para los valores `maxTimeout` y `maxTimeToOutputResponse` distintos de cero.
`extraArgs`	`String`: Son argumentos adicionales opcionales que se pueden pasar. Consulta "adb shell pm install --help" para ver las opciones disponibles.

Arroja
`InstallException`

isBootLoader

public boolean isBootLoader ()

Devuelve si el dispositivo está en modo de bootloader.

Muestra
`boolean`	`true` si `getState()` devuelve `DeviceState.BOOTLOADER`.

isEmulator

public boolean isEmulator ()

Devuelve true si el dispositivo es un emulador.

Muestra
`boolean`

isOffline

public boolean isOffline ()

Devuelve si el dispositivo no tiene conexión.

Muestra
`boolean`	`true` si `getState()` devuelve `DeviceState.OFFLINE`.

isOnline

public boolean isOnline ()

Devuelve si el dispositivo está listo.

Muestra
`boolean`	`true` si `getState()` devuelve `DeviceState.ONLINE`.

isRoot

public boolean isRoot ()

Consulta el estado de raíz actual del dispositivo. Consulta "adb root" para obtener más información.

Muestra
`boolean`	Es verdadero si el daemon de adb se ejecuta como administrador; de lo contrario, es falso.

Arroja
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

pullFile

public void pullFile (String remote, 
                String local)

Extrae un solo archivo.

Parámetros
`remote`	`String`: Es la ruta de acceso completa al archivo remoto.
`local`	`String`: Es el destino local.

Arroja
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

pushFile

public void pushFile (String local, 
                String remote)

Envía un solo archivo.

Parámetros
`local`	`String`: Es la ruta de acceso del archivo local.
`remote`	`String`: la ruta de acceso remota

Arroja
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

reiniciar

public void reboot (String into)

Reinicia el dispositivo.

Parámetros
`into`	`String`: Es el nombre del cargador de arranque en el que se reiniciará el dispositivo o un valor nulo para reiniciarlo.

Arroja
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort)

Quita un reenvío de puerto entre un puerto local y uno remoto.

Parámetros
`localPort`	`int`: Es el puerto local que se reenvía.

Arroja
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort, 
                int remotePort)

Parámetros
`localPort`	`int`
`remotePort`	`int`

Arroja
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

Parámetros
`localPort`	`int`
`remoteSocketName`	`String`
`namespace`	`IDevice.DeviceUnixSocketNamespace`

Arroja
`AdbCommandRejectedException`
`TimeoutException`

removeRemotePackage

public void removeRemotePackage (String remoteFilePath)

Quita un archivo del dispositivo.

Parámetros
`remoteFilePath`	`String`: Ruta de acceso en el dispositivo del archivo que se quitará

Arroja
`InstallException`

removeReverse

public void removeReverse (int remotePort)

Quita la inversión de puertos entre un puerto remoto y uno local.

Parámetros
`remotePort`	`int`: Es el puerto remoto.

Arroja
`AdbCommandRejectedException`
`TimeoutException`

root

public boolean root ()

Solicita al daemon de adb que se convierta en raíz en el dispositivo. Es posible que esta operación falle de forma silenciosa y solo se complete correctamente en compilaciones para desarrolladores. Consulta "adb root" para obtener más información.

Muestra
`boolean`	Es verdadero si el daemon de adb se ejecuta como administrador; de lo contrario, es falso.

Arroja
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

setSerial

public void setSerial (String serial)

Parámetros
`serial`	`String`

startScreenRecorder

public void startScreenRecorder (String remoteFilePath, 
                ScreenRecorderOptions options, 
                IShellOutputReceiver receiver)

Inicia la grabación de pantalla en el dispositivo si este admite IDevice.Feature.SCREEN_RECORD.

Parámetros
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`
`receiver`	`IShellOutputReceiver`

Arroja
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

supportsFeature

public boolean supportsFeature (IDevice.HardwareFeature arg0)

Devuelve si este dispositivo admite la función de hardware determinada.

Parámetros
`arg0`	`IDevice.HardwareFeature`

Muestra
`boolean`

supportsFeature

public boolean supportsFeature (IDevice.Feature feature)

Devuelve un valor que indica si este dispositivo admite la función de software determinada.

Parámetros
`feature`	`IDevice.Feature`

Muestra
`boolean`

syncPackageToDevice

public String syncPackageToDevice (String localFilePath)

Envía un archivo al dispositivo

Parámetros
`localFilePath`	`String`: Es la ruta de acceso absoluta al archivo en el host local.

Muestra
`String`	Ruta de acceso de destino `String` en el dispositivo para el archivo

Arroja
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

uninstallApp

public String uninstallApp (String applicationID, 
                String... extraArgs)

Desinstala una app del dispositivo.

Parámetros
`applicationID`	`String`: ID de la aplicación para Android que se desinstalará
`extraArgs`	`String`: Son argumentos adicionales opcionales que se pueden pasar. Consulta "adb shell pm install --help" para ver las opciones disponibles.

Muestra
`String`	Un `String` con un código de error o `null` si la operación se realizó correctamente

Arroja
`InstallException`

uninstallPackage

public String uninstallPackage (String packageName)

Desinstala un paquete del dispositivo.

Parámetros
`packageName`	`String`: ID de la aplicación para Android que se desinstalará

Muestra
`String`	Un `String` con un código de error o `null` si la operación se realizó correctamente

Arroja
`InstallException`