A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

StubDevice

public class StubDevice
extends Object implements IDevice

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

Subclasses diretas conhecidas

DeviceManager.FastbootDevice, NullDevice, RemoteAvdIDevice, StubLocalAndroidVirtualDevice, VmRemoteDevice

DeviceManager.FastbootDevice	Representação de um dispositivo no modo fastboot.
NullDevice	Um marcador de posição `IDevice` usado por `DeviceManager` para alocar quando `IDeviceSelection.nullDeviceRequested()` é `true`.
RemoteAvdIDevice	Um marcador de posição `IDevice` usado por `DeviceManager` para alocar quando `DeviceSelectionOptions.gceDeviceRequested()` é `true`.
StubLocalAndroidVirtualDevice	Um marcador de posição `IDevice` usado por `DeviceManager` para alocar quando `DeviceSelectionOptions.localVirtualDeviceRequested()` é `true`.
VmRemoteDevice	Um dispositivo virtual remoto que será gerenciado de dentro da máquina virtual.

Implementação de marcador de posição de stub de um IDevice.

Resumo

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

Métodos públicos
`boolean`	`arePropertiesSet()` Retorna `true` se as propriedades tiverem sido armazenadas em cache.
`void`	`createForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)` Cria um encaminhamento de porta entre uma porta TCP local e um soquete de domínio Unix remoto.
`void`	`createForward(int localPort, int remotePort)` Cria um encaminhamento de porta entre uma porta local e uma remota.
`void`	`createReverse(int remotePort, int localPort)` Cria uma inversão de porta entre uma porta remota e uma local.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Executa um comando do shell no dispositivo e envia o resultado para um `receiver`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Executa um comando do shell no dispositivo e envia o resultado para um `receiver`. Isso é semelhante a chamar `executeShellCommand(command, receiver, DdmPreferences.getTimeOut())`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)` Esse método foi descontinuado. use `executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit)`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Executa um comando do shell no dispositivo e envia o resultado para um `receiver`.
	`getAbis()` Retorna as ABIs compatíveis com este dispositivo.
`String`	`getAvdName()` Retorna o nome do AVD em que o emulador está sendo executado.
`String`	`getAvdPath()` Retorna o caminho absoluto para o dispositivo virtual no sistema de arquivos.
	`getBattery(long freshnessTime, TimeUnit timeUnit)` Retorna o nível da bateria do dispositivo, de 0 a 100%.
	`getBattery()` Retorna o nível da bateria do dispositivo, de 0 a 100%.
`Integer`	`getBatteryLevel(long freshnessMs)` Esse método foi descontinuado. use `getBattery(long, TimeUnit)`.
`Integer`	`getBatteryLevel()` Esse método foi descontinuado. use `getBattery()`.
`Client`	`getClient(String applicationName)` Retorna um `Client` pelo nome do aplicativo.
`String`	`getClientName(int pid)` Retorna o nome do cliente por PID ou `null` se o PID for desconhecido.
`Client[]`	`getClients()` Retorna a matriz de clientes.
`int`	`getDensity()` Retorna o bucket de densidade da tela do dispositivo lendo o valor da propriedade do sistema `PROP_DEVICE_DENSITY`.
`FileListingService`	`getFileListingService()` Retorna um `FileListingService` para este dispositivo.
`String`	`getLanguage()` Retorna o idioma do usuário.
`String`	`getMountPoint(String name)` Retorna um ponto de montagem.
`String`	`getName()` Retorna um nome (humanizado) para este dispositivo.
	`getProperties()` Esse método foi descontinuado. use `getSystemProperty(String)`.
`String`	`getProperty(String name)` Método de conveniência que tenta recuperar uma propriedade usando `IShellEnabledDevice.getSystemProperty(String)` com um tempo de espera muito curto e ignora exceções.
`String`	`getPropertyCacheOrSync(String name)` Esse método foi descontinuado. use `getProperty(String)`.
`int`	`getPropertyCount()` Esse método foi descontinuado. descontinuado na ddmlib com "detalhe de implementação" como motivo.
`String`	`getPropertySync(String name)` Esse método foi descontinuado. use `getProperty(String)`.
`String`	`getRegion()` Retorna a região do usuário.
`RawImage`	`getScreenshot()` Faz uma captura de tela do dispositivo e a retorna como um `RawImage`.
`RawImage`	`getScreenshot(long timeout, TimeUnit unit)`
`String`	`getSerialNumber()` Retorna o número de série do dispositivo.
`IDevice.DeviceState`	`getState()` Retorna o estado do dispositivo.
`SyncService`	`getSyncService()` Retorna um objeto `SyncService` para enviar / extrair arquivos do dispositivo.
`ListenableFuture<String>`	`getSystemProperty(String name)` Faça uma possível consulta assíncrona para uma propriedade do sistema.
`boolean`	`hasClients()` Retorna se o `IDevice` tem `Client`s.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` Instala um aplicativo Android no dispositivo.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Instala um aplicativo Android no dispositivo.
`void`	`installPackage(String packageFilePath, boolean reinstall, String... extraArgs)` Instala um aplicativo Android no dispositivo.
`void`	`installPackages( apkFilePaths, boolean reinstall, extraArgs, long timeOutInMs, TimeUnit timeunit)` Instala um aplicativo Android feito de vários arquivos APK (um principal e 0..n pacotes divididos).
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Instala o pacote de aplicativo que foi enviado para um local temporário no dispositivo.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, String... extraArgs)` Instala o pacote de aplicativo que foi enviado para um local temporário no dispositivo.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` Instala o pacote de aplicativo que foi enviado para um local temporário no dispositivo.
`boolean`	`isBootLoader()` Retorna se o dispositivo está no modo bootloader.
`boolean`	`isEmulator()` Retorna `true` se o dispositivo for um emulador.
`boolean`	`isOffline()` Retorna se o dispositivo está off-line.
`boolean`	`isOnline()` Retorna se o dispositivo está pronto.
`boolean`	`isRoot()` Consulta o status de root atual do dispositivo.
`void`	`pullFile(String remote, String local)` Extrai um único arquivo.
`void`	`pushFile(String local, String remote)` Envia um único arquivo.
`void`	`reboot(String into)` Reinicialize o dispositivo.
`void`	`removeForward(int localPort)` Remove um encaminhamento de porta entre uma porta local e uma remota.
`void`	`removeForward(int localPort, int remotePort)`
`void`	`removeForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)`
`void`	`removeRemotePackage(String remoteFilePath)` Remove um arquivo do dispositivo.
`void`	`removeReverse(int remotePort)` Remove uma inversão de porta entre uma porta remota e uma local.
`boolean`	`root()` Peça ao daemon adb para se tornar root no dispositivo.
`void`	`setSerial(String serial)`
`void`	`startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` Inicia a gravação de tela no dispositivo se ele for compatível com `IDevice.Feature.SCREEN_RECORD`.
`boolean`	`supportsFeature(IDevice.HardwareFeature arg0)` Retorna se o dispositivo é compatível com o recurso de hardware especificado.
`boolean`	`supportsFeature(IDevice.Feature feature)` Retorna se o dispositivo é compatível com o recurso de software especificado.
`String`	`syncPackageToDevice(String localFilePath)` Envia um arquivo para o dispositivo
`String`	`uninstallApp(String applicationID, String... extraArgs)` Desinstala um app do dispositivo.
`String`	`uninstallPackage(String packageName)` Desinstala um pacote do dispositivo.

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

Retorna true se as propriedades tiverem sido armazenadas em cache.

Retorna
`boolean`

createForward

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

Cria um encaminhamento de porta entre uma porta TCP local e um soquete de domínio Unix remoto.

Parâmetros
`localPort`	`int`: a porta local a ser encaminhada
`remoteSocketName`	`String`: nome do soquete de domínio Unix criado no dispositivo.
`namespace`	`IDevice.DeviceUnixSocketNamespace`: namespace em que o soquete de domínio Unix foi criado.

Gera
`AdbCommandRejectedException`
`TimeoutException`

createForward

public void createForward (int localPort, 
                int remotePort)

Cria um encaminhamento de porta entre uma porta local e uma remota.

Parâmetros
`localPort`	`int`: a porta local a ser encaminhada
`remotePort`	`int`: a porta remota.

Gera
`AdbCommandRejectedException`
`TimeoutException`

createReverse

public void createReverse (int remotePort, 
                int localPort)

Cria uma inversão de porta entre uma porta remota e uma local.

Parâmetros
`remotePort`	`int`: a porta remota a ser invertida.
`localPort`	`int`: a porta local;

Gera
`AdbCommandRejectedException`
`TimeoutException`

executeShellCommand

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

Executa um comando do shell no dispositivo e envia o resultado para um receiver.

maxTimeToOutputResponse é usado como um tempo máximo de espera ao aguardar a saída do comando do dispositivo.
A qualquer momento, se o comando do shell não gerar nada por um período maior que maxTimeToOutputResponse, o método vai gerar ShellCommandUnresponsiveException.

Para comandos como saída de registro, use um valor maxTimeToOutputResponse de 0, o que significa que o método nunca vai gerar uma exceção e vai bloquear até que o IShellOutputReceiver.isCancelled() do receptor retorne true.

Parâmetros
`command`	`String`: o comando do shell a ser executado
`receiver`	`IShellOutputReceiver`: o `IShellOutputReceiver` que vai receber a saída do comando do shell.
`maxTimeToOutputResponse`	`long`: o período máximo em que o comando pode não gerar nenhuma resposta. Um valor de 0 significa que o método vai esperar para sempre (até que o `receiver` cancele a execução) a saída do comando e nunca vai gerar uma exceção.
`maxTimeUnits`	`TimeUnit`: unidades para valores `maxTimeToOutputResponse` diferentes de zero.

Gera
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Executa um comando do shell no dispositivo e envia o resultado para um receiver.

Isso é semelhante a chamar executeShellCommand(command, receiver, DdmPreferences.getTimeOut()).

Parâmetros
`command`	`String`: o comando do shell a ser executado
`receiver`	`IShellOutputReceiver`: o `IShellOutputReceiver` que vai receber a saída do comando do shell.

Gera
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

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

Esse método foi descontinuado.
use executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit).

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

Gera
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

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

Executa um comando do shell no dispositivo e envia o resultado para um receiver.

Parâmetros
`command`	`String`: o comando do shell a ser executado
`receiver`	`IShellOutputReceiver`: o `IShellOutputReceiver` que vai receber a saída do comando do shell.
`maxTimeout`	`long`: o tempo limite máximo para o retorno do comando. Um valor de 0 significa que nenhum tempo limite máximo será aplicado.
`maxTimeToOutputResponse`	`long`: o período máximo em que o comando pode não gerar nenhuma resposta. Um valor de 0 significa que o método vai esperar para sempre (até que o `receiver` cancele a execução) a saída do comando e nunca vai gerar uma exceção.
`maxTimeUnits`	`TimeUnit`: unidades para valores `maxTimeout` e `maxTimeToOutputResponse` diferentes de zero.

Gera
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getAbis

public  getAbis ()

Retorna as ABIs compatíveis com este dispositivo. As ABIs são classificadas na ordem preferida, sendo a primeira a mais preferida.

Retorna
	a lista de ABIs.

getAvdName

public String getAvdName ()

Retorna o nome do AVD em que o emulador está sendo executado.

Isso só é válido se isEmulator() retornar "true".

Se o emulador não estiver executando nenhum AVD (por exemplo, se estiver sendo executado de um build de árvore de origem do Android), esse método vai retornar "<build>".

Observação: prefira usar getAvdData() se quiser controlar o tempo limite.

Retorna
`String`	o nome do AVD ou `null` se não houver nenhum.

getAvdPath

public String getAvdPath ()

Retorna o caminho absoluto para o dispositivo virtual no sistema de arquivos. O caminho depende do sistema operacional. Ele terá separadores / nome no Linux e \ no Windows.

Observação: prefira usar getAvdData() se quiser controlar o tempo limite.

Retorna
`String`	o caminho do AVD ou nulo se for um dispositivo físico, o subcomando do console do emulador falhou ou a versão do emulador é anterior a 30.0.18

getBattery

public  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

Retorna o nível da bateria do dispositivo, de 0 a 100%.

O nível da bateria pode estar em cache. Só consulta o nível da bateria do dispositivo se o freshnessTime tiver expirado desde a última consulta bem-sucedida.

Parâmetros
`freshnessTime`	`long`: a atualização desejada do nível da bateria
`timeUnit`	`TimeUnit`: o `ERROR(/TimeUnit)` de freshnessTime

Retorna
	um `ERROR(/Future)` que pode ser usado para consultar o nível da bateria. O Future vai retornar um `ERROR(/ExecutionException)` se o nível da bateria não puder ser recuperado.

getBattery

public  getBattery ()

Retorna o nível da bateria do dispositivo, de 0 a 100%.

O nível da bateria pode estar em cache. Só consulta o nível da bateria do dispositivo se 5 minutos tiverem expirado desde a última consulta bem-sucedida.

Retorna
	um `ERROR(/Future)` que pode ser usado para consultar o nível da bateria. O Future vai retornar um `ERROR(/ExecutionException)` se o nível da bateria não puder ser recuperado.

getBatteryLevel

public Integer getBatteryLevel (long freshnessMs)

Esse método foi descontinuado.
use getBattery(long, TimeUnit).

Retorna o nível da bateria do dispositivo, de 0 a 100%.

O nível da bateria pode estar em cache. Só consulta o nível da bateria do dispositivo se freshnessMs ms tiverem expirado desde a última consulta bem-sucedida.

Retorna
`Integer`	o nível da bateria ou `null` se não for possível recuperar

Gera
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getBatteryLevel

public Integer getBatteryLevel ()

Esse método foi descontinuado.
use getBattery().

Retorna o nível da bateria do dispositivo, de 0 a 100%.

O nível da bateria pode estar em cache. Só consulta o nível da bateria do dispositivo se 5 minutos tiverem expirado desde a última consulta bem-sucedida.

Retorna
`Integer`	o nível da bateria ou `null` se não for possível recuperar

Gera
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getClient

public Client getClient (String applicationName)

Retorna um Client pelo nome do aplicativo.

Parâmetros
`applicationName`	`String`: o nome do aplicativo

Retorna
`Client`	o objeto `Client` ou `null` se nenhuma correspondência for encontrada.

getClientName

public String getClientName (int pid)

Retorna o nome do cliente por PID ou null se o PID for desconhecido.

Parâmetros
`pid`	`int`: o PID do cliente.

Retorna
`String`

getClients

public Client[] getClients ()

Retorna a matriz de clientes.

Retorna
`Client[]`

getDensity

public int getDensity ()

Retorna o bucket de densidade da tela do dispositivo lendo o valor da propriedade do sistema PROP_DEVICE_DENSITY.

Retorna
`int`	a densidade ou -1 se não for possível determinar.

getFileListingService

public FileListingService getFileListingService ()

Retorna um FileListingService para este dispositivo.

Retorna
`FileListingService`

getLanguage

public String getLanguage ()

Retorna o idioma do usuário.

Retorna
`String`	o idioma do usuário ou nulo se for desconhecido

getMountPoint

public String getMountPoint (String name)

Retorna um ponto de montagem.

Parâmetros
`name`	`String`: o nome do ponto de montagem a ser retornado

Retorna
`String`

getName

public String getName ()

Retorna um nome (humanizado) para este dispositivo. Normalmente, esse é o nome do AVD para AVDs e uma combinação do nome do fabricante, do modelo e do número de série para dispositivos.

Retorna
`String`

getProperties

public  getProperties ()

Esse método foi descontinuado.
use getSystemProperty(String).

Retorna as propriedades armazenadas em cache do dispositivo. Ele contém toda a saída de "getprop".

Retorna

getProperty

public String getProperty (String name)

Método de conveniência que tenta recuperar uma propriedade usando IShellEnabledDevice.getSystemProperty(String) com um tempo de espera muito curto e ignora exceções.

Observação: prefira usar IShellEnabledDevice.getSystemProperty(String) se quiser controlar o tempo limite.

Parâmetros
`name`	`String`: o nome do valor a ser retornado.

Retorna
`String`	o valor ou `null` se o valor da propriedade não estiver disponível imediatamente

getPropertyCacheOrSync

public String getPropertyCacheOrSync (String name)

Esse método foi descontinuado.
use getProperty(String).

Uma combinação de getProperty(String) e getPropertySync(String) que tentará recuperar a propriedade do cache. Se não for encontrado, tentará de forma síncrona consultar o dispositivo diretamente e preencher novamente o cache se a consulta for bem-sucedida.

Parâmetros
`name`	`String`: o nome do valor a ser retornado.

Retorna
`String`	o valor ou `null` se a propriedade não existir

Gera
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getPropertyCount

public int getPropertyCount ()

Esse método foi descontinuado.
descontinuado na ddmlib com "detalhe de implementação" como motivo.

Retorna o número de propriedades para este dispositivo.

Retorna
`int`

getPropertySync

public String getPropertySync (String name)

Esse método foi descontinuado.
use getProperty(String).

Uma variante de getProperty(String) que tenta recuperar a propriedade especificada diretamente do dispositivo, sem usar o cache. Esse método só deve ser usado para propriedades voláteis.

Parâmetros
`name`	`String`: o nome do valor a ser retornado.

Retorna
`String`	o valor ou `null` se a propriedade não existir

Gera
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getRegion

public String getRegion ()

Retorna a região do usuário.

Retorna
`String`	a região do usuário ou nulo se ela for desconhecida

getScreenshot

public RawImage getScreenshot ()

Faz uma captura de tela do dispositivo e a retorna como um RawImage.

Retorna
`RawImage`	a captura de tela como um `RawImage` ou `null` se algo der errado.

Gera
`AdbCommandRejectedException`
`TimeoutException`

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Parâmetros
`timeout`	`long`
`unit`	`TimeUnit`

Retorna
`RawImage`

Gera
`AdbCommandRejectedException`
`TimeoutException`

getSerialNumber

public String getSerialNumber ()

Retorna o número de série do dispositivo.

Retorna
`String`

getState

public IDevice.DeviceState getState ()

Retorna o estado do dispositivo.

Retorna
`IDevice.DeviceState`

getSyncService

public SyncService getSyncService ()

Retorna um objeto SyncService para enviar / extrair arquivos do dispositivo.

Retorna
`SyncService`	`null` se não for possível criar o SyncService. Isso pode acontecer se o adb se recusar a abrir a conexão porque o `IDevice` é inválido (ou foi desconectado).

Gera
`AdbCommandRejectedException`
`TimeoutException`

getSystemProperty

public ListenableFuture<String> getSystemProperty (String name)

Faça uma possível consulta assíncrona para uma propriedade do sistema.

Parâmetros
`name`	`String`: o nome do valor a ser retornado.

Retorna
`ListenableFuture<String>`	um `ListenableFuture.` `ERROR(get/Future#get() get)` pode retornar nulo.

hasClients

public boolean hasClients ()

Retorna se o IDevice tem Clients.

Retorna
`boolean`

installPackage

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

Instala um aplicativo Android no dispositivo. Esse é um método auxiliar que combina as etapas syncPackageToDevice, installRemotePackage e removePackage.

Parâmetros
`packageFilePath`	`String`: o caminho absoluto do sistema de arquivos para o arquivo no host local a ser instalado
`reinstall`	`boolean`: defina como `true` se a reinstalação do app precisar ser feita.
`receiver`	`InstallReceiver`: o `InstallReceiver` a ser usado para monitorar a instalação e receber o status final.
`maxTimeout`	`long`: o tempo limite máximo para o retorno do comando. Um valor de 0 significa que nenhum tempo limite máximo será aplicado.
`maxTimeToOutputResponse`	`long`: o período máximo em que o comando pode não gerar nenhuma resposta. Um valor de 0 significa que o método vai esperar para sempre (até que o `receiver` cancele a execução) a saída do comando e nunca vai gerar uma exceção.
`maxTimeUnits`	`TimeUnit`: unidades para valores `maxTimeout` e `maxTimeToOutputResponse` diferentes de zero.
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm install --help" para ver as opções disponíveis.

Gera
`InstallException`

installPackage

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

Instala um aplicativo Android no dispositivo. Esse é um método auxiliar que combina as etapas syncPackageToDevice, installRemotePackage e removePackage.

Parâmetros
`packageFilePath`	`String`: o caminho absoluto do sistema de arquivos para o arquivo no host local a ser instalado
`reinstall`	`boolean`: defina como `true` se a reinstalação do app precisar ser feita.
`receiver`	`InstallReceiver`: o `InstallReceiver` a ser usado para monitorar a instalação e receber o status final.
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm install --help" para ver as opções disponíveis.

Gera
`InstallException`

installPackage

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

Instala um aplicativo Android no dispositivo. Esse é um método auxiliar que combina as etapas syncPackageToDevice, installRemotePackage e removePackage.

Parâmetros
`packageFilePath`	`String`: o caminho absoluto do sistema de arquivos para o arquivo no host local a ser instalado
`reinstall`	`boolean`: defina como `true` se a reinstalação do app precisar ser feita.
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm install --help" para ver as opções disponíveis.

Gera
`InstallException`

installPackages

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

Instala um aplicativo Android feito de vários arquivos APK (um principal e 0..n pacotes divididos).

Parâmetros
`apkFilePaths`	: lista de APKs a serem instalados (um APK principal + 0..n APKs divididos)
`reinstall`	`boolean`: defina como `true` se a reinstalação do app precisar ser feita.
`extraArgs`	: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm install --help" para ver as opções disponíveis.
`timeOutInMs`	`long`: tempo limite de instalação
`timeunit`	`TimeUnit`: `ERROR(/TimeUnit)` correspondente ao parâmetro de tempo limite

Gera
`InstallException`

installRemotePackage

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

Instala o pacote de aplicativo que foi enviado para um local temporário no dispositivo.

Parâmetros
`remoteFilePath`	`String`: caminho absoluto do arquivo do pacote no dispositivo
`reinstall`	`boolean`: defina como `true` se a reinstalação do app precisar ser feita.
`receiver`	`InstallReceiver`: o `InstallReceiver` a ser usado para monitorar a instalação e receber o status final.
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm install --help" para ver as opções disponíveis.

Gera
`InstallException`

installRemotePackage

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

Instala o pacote de aplicativo que foi enviado para um local temporário no dispositivo.

Parâmetros
`remoteFilePath`	`String`: caminho absoluto do arquivo do pacote no dispositivo
`reinstall`	`boolean`: defina como `true` se a reinstalação do app precisar ser feita.
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm install --help" para ver as opções disponíveis.

Gera
`InstallException`

installRemotePackage

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

Instala o pacote de aplicativo que foi enviado para um local temporário no dispositivo.

Parâmetros
`remoteFilePath`	`String`: caminho absoluto do arquivo do pacote no dispositivo
`reinstall`	`boolean`: defina como `true` se a reinstalação do app precisar ser feita.
`receiver`	`InstallReceiver`: o `InstallReceiver` a ser usado para monitorar a instalação e receber o status final.
`maxTimeout`	`long`: o tempo limite máximo para o retorno do comando. Um valor de 0 significa que nenhum tempo limite máximo será aplicado.
`maxTimeToOutputResponse`	`long`: o período máximo em que o comando pode não gerar nenhuma resposta. Um valor de 0 significa que o método vai esperar para sempre (até que o `receiver` cancele a execução) a saída do comando e nunca vai gerar uma exceção.
`maxTimeUnits`	`TimeUnit`: unidades para valores `maxTimeout` e `maxTimeToOutputResponse` diferentes de zero.
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm install --help" para ver as opções disponíveis.

Gera
`InstallException`

isBootLoader

public boolean isBootLoader ()

Retorna se o dispositivo está no modo bootloader.

Retorna
`boolean`	`true` se `getState()` retornar `DeviceState.BOOTLOADER`.

isEmulator

public boolean isEmulator ()

Retorna true se o dispositivo for um emulador.

Retorna
`boolean`

isOffline

public boolean isOffline ()

Retorna se o dispositivo está off-line.

Retorna
`boolean`	`true` se `getState()` retornar `DeviceState.OFFLINE`.

isOnline

public boolean isOnline ()

Retorna se o dispositivo está pronto.

Retorna
`boolean`	`true` se `getState()` retornar `DeviceState.ONLINE`.

isRoot

public boolean isRoot ()

Consulta o status de root atual do dispositivo. Consulte "adb root" para mais informações.

Retorna
`boolean`	"true" se o daemon adb estiver sendo executado como root. Caso contrário, "false".

Gera
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

pullFile

public void pullFile (String remote, 
                String local)

Extrai um único arquivo.

Parâmetros
`remote`	`String`: o caminho completo para o arquivo remoto
`local`	`String`: o destino local.

Gera
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

pushFile

public void pushFile (String local, 
                String remote)

Envia um único arquivo.

Parâmetros
`local`	`String`: o caminho do arquivo local.
`remote`	`String`: o caminho do arquivo remoto

Gera
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

reiniciar

public void reboot (String into)

Reinicialize o dispositivo.

Parâmetros
`into`	`String`: o nome do carregador de inicialização para reiniciar ou nulo para apenas reiniciar o dispositivo.

Gera
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort)

Remove um encaminhamento de porta entre uma porta local e uma remota.

Parâmetros
`localPort`	`int`: a porta local a ser encaminhada

Gera
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort, 
                int remotePort)

Parâmetros
`localPort`	`int`
`remotePort`	`int`

Gera
`AdbCommandRejectedException`
`TimeoutException`

removeForward

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

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

Gera
`AdbCommandRejectedException`
`TimeoutException`

removeRemotePackage

public void removeRemotePackage (String remoteFilePath)

Remove um arquivo do dispositivo.

Parâmetros
`remoteFilePath`	`String`: caminho no dispositivo do arquivo a ser removido

Gera
`InstallException`

removeReverse

public void removeReverse (int remotePort)

Remove uma inversão de porta entre uma porta remota e uma local.

Parâmetros
`remotePort`	`int`: a porta remota.

Gera
`AdbCommandRejectedException`
`TimeoutException`

raiz

public boolean root ()

Peça ao daemon adb para se tornar root no dispositivo. Isso pode falhar silenciosamente e só vai funcionar em builds de desenvolvedor. Consulte "adb root" para mais informações.

Retorna
`boolean`	"true" se o daemon adb estiver sendo executado como root. Caso contrário, "false".

Gera
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

setSerial

public void setSerial (String serial)

Parâmetros
`serial`	`String`

startScreenRecorder

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

Inicia a gravação de tela no dispositivo se ele for compatível com IDevice.Feature.SCREEN_RECORD.

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

Gera
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

supportsFeature

public boolean supportsFeature (IDevice.HardwareFeature arg0)

Retorna se o dispositivo é compatível com o recurso de hardware especificado.

Parâmetros
`arg0`	`IDevice.HardwareFeature`

Retorna
`boolean`

supportsFeature

public boolean supportsFeature (IDevice.Feature feature)

Retorna se o dispositivo é compatível com o recurso de software especificado.

Parâmetros
`feature`	`IDevice.Feature`

Retorna
`boolean`

syncPackageToDevice

public String syncPackageToDevice (String localFilePath)

Envia um arquivo para o dispositivo

Parâmetros
`localFilePath`	`String`: o caminho absoluto para o arquivo no host local

Retorna
`String`	Caminho de destino `String` no dispositivo para o arquivo

Gera
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

uninstallApp

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

Desinstala um app do dispositivo.

Parâmetros
`applicationID`	`String`: o ID do aplicativo Android a ser desinstalado
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm install --help" para ver as opções disponíveis.

Retorna
`String`	um `String` com um código de erro ou `null` se a operação for concluída corretamente.

Gera
`InstallException`

uninstallPackage

public String uninstallPackage (String packageName)

Desinstala um pacote do dispositivo.

Parâmetros
`packageName`	`String`: o ID do aplicativo Android a ser desinstalado

Retorna
`String`	um `String` com um código de erro ou `null` se a operação for concluída corretamente.

Gera
`InstallException`