A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

DeviceImpl

public final class DeviceImpl
extends Object implements IDevice

java.lang.Object
↳	com.android.tradefed.device.server.DeviceImpl

Um dispositivo. Pode ser um dispositivo físico ou um emulador.

Resumo

Construtores públicos
`DeviceImpl(ClientTracker clientTracer, String serialNumber, IDevice.DeviceState deviceState)`

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`	`executeBinderCommand(String[] parameters, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)` Executa um comando do Binder no dispositivo e envia o resultado para um `receiver`. Isso usa a chamada exec:cmd ou abb_exec: mais rápida se o SO do dispositivo e o servidor ADB host forem compatíveis com o recurso de execução do Android Binder Bridge.
`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, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)` Uma versão do comando executeShell que pode receber um fluxo de entrada para enviar pelo stdin.
`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)`
`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`.
`void`	`forceStop(String applicationName)` Forçar o fechamento de um aplicativo pelo nome dele.
	`getAbis()` Retorna as ABIs compatíveis com este dispositivo.
`ListenableFuture<AvdData>`	`getAvdData()` Retorna informações sobre o AVD em que o emulador está sendo executado.
`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)` Retorna o nível da bateria do dispositivo, de 0 a 100%.
`Integer`	`getBatteryLevel()` Retorna o nível da bateria do dispositivo, de 0 a 100%.
`ClientImpl`	`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.
`ClientTracker`	`getClientTracker()`
`ClientImpl[]`	`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.
`InstallMetrics`	`getLastInstallMetrics()` Recebe informações sobre a instalação mais recente neste dispositivo.
`String`	`getMountPoint(String name)` Retorna um ponto de montagem.
`String`	`getName()` Retorna um nome (humanizado) para este dispositivo.
`ClientImpl[]`	`getNativeClients()`
`ClientImpl`	`getNativeClients(String applicationName)`
`ProfileableClientImpl[]`	`getProfileableClients()` Retorna a matriz de clientes que podem ser criados em perfil.
	`getProperties()` Retorna as propriedades armazenadas em cache do dispositivo.
`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)` Uma combinação de `getProperty(String)` e `getPropertySync(String)` que tentará recuperar a propriedade do cache.
`int`	`getPropertyCount()` Retorna o número de propriedades para este dispositivo.
`String`	`getPropertySync(String name)` Uma variante de `getProperty(String)` que tenta recuperar a propriedade especificada diretamente do dispositivo, sem usar o cache.
`String`	`getRegion()` Retorna a região do usuário.
`static String`	`getScreenRecorderCommand(String remoteFilePath, ScreenRecorderOptions options)`
`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( apks, boolean reinstall, installOptions)` Instala um aplicativo Android feito de vários arquivos APK (um principal e 0..n pacotes divididos) com tempo limite padrão.
`void`	`installPackages( apks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)` 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.
`void`	`installRemotePackages( remoteApks, boolean reinstall, installOptions)` Instala um aplicativo Android feito de vários arquivos APK armazenados localmente no dispositivo com tempo limite padrão.
`void`	`installRemotePackages( remoteApks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)` Instala um aplicativo Android feito de vários arquivos APK armazenados localmente 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`	`kill(String applicationName)` Encerra um aplicativo pelo nome.
`void`	`pullFile(String remote, String local)` Extrai um único arquivo.
`void`	`push(String[] local, String remote)` Envia vários arquivos ou diretórios.
`void`	`pushFile(String local, String remote)` Envia um único arquivo.
`SocketChannel`	`rawBinder(String service, String[] parameters)` Invocar o serviço Android Binder Bridge em um dispositivo remoto.
`SocketChannel`	`rawExec(String executable, String[] parameters)` Invoca o serviço host:exec em um dispositivo remoto.
`void`	`reboot(String into)` Reinicialize o dispositivo.
`void`	`removeForward(int localPort)` Remove um encaminhamento de porta entre uma porta local e uma remota.
`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`	`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 feature)` 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`	`toString()`
`String`	`uninstallApp(String applicationID, String... extraArgs)` Desinstala um app do dispositivo.
`String`	`uninstallPackage(String packageName)` Desinstala um pacote do dispositivo.

Construtores públicos

DeviceImpl

public DeviceImpl (ClientTracker clientTracer, 
                String serialNumber, 
                IDevice.DeviceState deviceState)

Parâmetros
`clientTracer`	`ClientTracker`
`serialNumber`	`String`
`deviceState`	`IDevice.DeviceState`

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`

executeBinderCommand

public void executeBinderCommand (String[] parameters, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

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

Isso usa a chamada exec:cmd ou abb_exec: mais rápida se o SO do dispositivo e o servidor ADB host forem compatíveis com o recurso de execução do Android Binder Bridge.

Parâmetros
`parameters`	`String`: o comando do binder a ser executado
`receiver`	`IShellOutputReceiver`: o `IShellOutputReceiver` que vai receber a saída do comando binder
`maxTimeToOutputResponse`	`long`
`maxTimeUnits`	`TimeUnit`
`is`	`InputStream`: fluxo de entrada opcional para enviar pelo stdin

Gera
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`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, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

Uma versão do comando executeShell que pode receber um fluxo de entrada para enviar pelo stdin.

Parâmetros
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`long`
`maxTimeUnits`	`TimeUnit`
`is`	`InputStream`

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)

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`

forceStop

public void forceStop (String applicationName)

Forçar o fechamento de um aplicativo pelo nome dele. Isso remove todos os alarmes pendentes e os cálculos enfileirados.

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

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.

getAvdData

public ListenableFuture<AvdData> getAvdData ()

Retorna informações sobre o AVD em que o emulador está sendo executado.

AvdData.getName é o nome do AVD ou null se não houver nenhum.

AvdData.getPath é o caminho do AVD ou nulo se for um dispositivo físico, se o subcomando do console do emulador falhar ou se a versão do emulador for anterior a 30.0.18.

Retorna
`ListenableFuture<AvdData>`	o `AvdData` do dispositivo.

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)

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

getBatteryLevel

public Integer getBatteryLevel ()

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

getClient

public ClientImpl getClient (String applicationName)

Retorna um Client pelo nome do aplicativo.

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

Retorna
`ClientImpl`	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`

getClientTracker

public ClientTracker getClientTracker ()

Retorna
`ClientTracker`

getClients

public ClientImpl[] getClients ()

Retorna a matriz de clientes.

Retorna
`ClientImpl[]`

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

Recebe informações sobre a instalação mais recente neste dispositivo.

Retorna
`InstallMetrics`	`InstallMetrics` métricas que descrevem a instalação.

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`

getNativeClients

public ClientImpl[] getNativeClients ()

Retorna
`ClientImpl[]`

getNativeClients

public ClientImpl getNativeClients (String applicationName)

Parâmetros
`applicationName`	`String`

Retorna
`ClientImpl`

getProfileableClients

public ProfileableClientImpl[] getProfileableClients ()

Retorna a matriz de clientes que podem ser criados em perfil.

Retorna
`ProfileableClientImpl[]`

getProperties

public  getProperties ()

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)

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

getPropertyCount

public int getPropertyCount ()

Retorna o número de propriedades para este dispositivo.

Retorna
`int`

getPropertySync

public String getPropertySync (String name)

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

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

getScreenRecorderCommand

public static String getScreenRecorderCommand (String remoteFilePath, 
                ScreenRecorderOptions options)

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

Retorna
`String`

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 ( apks, 
                boolean reinstall, 
                 installOptions)

Instala um aplicativo Android feito de vários arquivos APK (um principal e 0..n pacotes divididos) com tempo limite padrão.

Parâmetros
`apks`	: 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.
`installOptions`	: 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 ( apks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

Parâmetros
`apks`	: 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.
`installOptions`	: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm install --help" para ver as opções disponíveis.
`timeout`	`long`: tempo limite de instalação
`timeoutUnit`	`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`

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions)

Instala um aplicativo Android feito de vários arquivos APK armazenados localmente no dispositivo com tempo limite padrão.

Parâmetros
`remoteApks`	: lista de caminhos de arquivos APK no dispositivo para instalação
`reinstall`	`boolean`: defina como `true` se a reinstalação do app precisar ser feita.
`installOptions`	: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm install --help" para ver as opções disponíveis.

Gera
`InstallException`

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

Instala um aplicativo Android feito de vários arquivos APK armazenados localmente no dispositivo.

Parâmetros
`remoteApks`	: lista de caminhos de arquivos APK no dispositivo para instalação
`reinstall`	`boolean`: defina como `true` se a reinstalação do app precisar ser feita.
`installOptions`	: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm install --help" para ver as opções disponíveis.
`timeout`	`long`: tempo limite de instalação
`timeoutUnit`	`TimeUnit`: `ERROR(/TimeUnit)` correspondente ao parâmetro de tempo limite

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`

matar

public void kill (String applicationName)

Encerra um aplicativo pelo nome. Isso só destrói as atividades, deixando o estado delas apenas no sistema Android.

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

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`

push

public void push (String[] local, 
                String remote)

Envia vários arquivos ou diretórios.

Parâmetros
`local`	`String`: os arquivos locais a serem enviados
`remote`	`String`: o caminho remoto que representa um diretório

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`

rawBinder

public SocketChannel rawBinder (String service, 
                String[] parameters)

Invocar o serviço Android Binder Bridge em um dispositivo remoto. Retorna um canal de soquete conectado ao comando do binder do dispositivo.

A propriedade do SocketChannel é transferida para o caller, e ele precisa ser fechado explicitamente após o uso.

Parâmetros
`service`	`String`: o nome do serviço do Android a ser conectado
`parameters`	`String`: os parâmetros do comando do binder

Retorna
`SocketChannel`	Um SocketChannel conectado ao processo em execução no dispositivo. após o uso.

Gera
`AdbCommandRejectedException`
`TimeoutException`

rawExec

public SocketChannel rawExec (String executable, 
                String[] parameters)

Invoca o serviço host:exec em um dispositivo remoto. Retorna um canal de soquete conectado ao processo em execução. O serviço de execução não diferencia stdout e stderr. Portanto, o que é lido do soquete pode vir de qualquer saída e ser intercalado.

A propriedade do SocketChannel é transferida para o caller, e ele precisa ser fechado explicitamente após o uso.

Parâmetros
`executable`	`String`
`parameters`	`String`

Retorna
`SocketChannel`	Um SocketChannel conectado ao processo em execução no dispositivo. após o uso.

Gera
`AdbCommandRejectedException`
`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`

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`

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

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

Parâmetros
`feature`	`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`

toString

public String toString ()

Retorna
`String`

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`