IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice

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

Resumo

Constantes

int CHANGE_BUILD_INFO

Máscara de bits de mudança do dispositivo: mudança nas informações do build.

int CHANGE_CLIENT_LIST

Máscara de bits de mudança de dispositivo: mudança na lista Client.

int CHANGE_PROFILEABLE_CLIENT_LIST

Máscara de bits de mudança de dispositivo: mudança na lista ProfileableClient.

int CHANGE_STATE

Máscara de bits de mudança de dispositivo: mudança de DeviceState.

String FIRST_EMULATOR_SN

Número de série do primeiro emulador conectado.

String MNT_DATA

String MNT_EXTERNAL_STORAGE

String MNT_ROOT

String PROP_BUILD_API_LEVEL

String PROP_BUILD_CHARACTERISTICS

String PROP_BUILD_CODENAME

String PROP_BUILD_TAGS

String PROP_BUILD_TYPE

String PROP_BUILD_VERSION

String PROP_BUILD_VERSION_NUMBER

Essa constante foi descontinuada. Use PROP_BUILD_API_LEVEL.

String PROP_DEBUGGABLE

String PROP_DEVICE_CPU_ABI

String PROP_DEVICE_CPU_ABI2

String PROP_DEVICE_CPU_ABI_LIST

String PROP_DEVICE_DENSITY

String PROP_DEVICE_EMULATOR_DENSITY

String PROP_DEVICE_LANGUAGE

String PROP_DEVICE_MANUFACTURER

String PROP_DEVICE_MODEL

String PROP_DEVICE_REGION

String RE_EMULATOR_SN

Expressão regular do número de série do emulador.

String UNKNOWN_PACKAGE

Métodos públicos

abstract boolean arePropertiesSet()

Retorna true se as propriedades tiverem sido armazenadas em cache.

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

abstract void createForward(int localPort, int remotePort)

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

default void createReverse(int remotePort, int localPort)

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

default 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.

default 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.

abstract 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()).

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

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

default void forceStop(String applicationName)

Forçar o fechamento de um aplicativo pelo nome dele.

abstract getAbis()

Retorna as ABIs compatíveis com este dispositivo.

default ListenableFuture<AvdData> getAvdData()

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

abstract String getAvdName()

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

abstract String getAvdPath()

Retorna o caminho absoluto para o dispositivo virtual no sistema de arquivos.

abstract getBattery(long freshnessTime, TimeUnit timeUnit)

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

abstract getBattery()

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

abstract Integer getBatteryLevel(long freshnessMs)

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

abstract Integer getBatteryLevel()

Esse método foi descontinuado. usar getBattery()

abstract Client getClient(String applicationName)

Retorna um Client pelo nome do aplicativo.

abstract String getClientName(int pid)

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

abstract Client[] getClients()

Retorna a matriz de clientes.

abstract int getDensity()

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

abstract FileListingService getFileListingService()

Retorna um FileListingService para este dispositivo.

default getHardwareCharacteristics()

Retorna recursos obtidos pela leitura da propriedade de características de build.

abstract String getLanguage()

Retorna o idioma do usuário.

default InstallMetrics getLastInstallMetrics()

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

abstract String getMountPoint(String name)

Retorna um ponto de montagem.

default ProfileableClient[] getProfileableClients()

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

abstract getProperties()

Esse método foi descontinuado. use IShellEnabledDevice.getSystemProperty(String) em vez disso

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

abstract String getPropertyCacheOrSync(String name)

Esse método foi descontinuado. use IShellEnabledDevice.getSystemProperty(String) em vez disso

abstract int getPropertyCount()

Esse método foi descontinuado. detalhe de implementação

abstract String getPropertySync(String name)

Esse método foi descontinuado. usar IShellEnabledDevice.getSystemProperty(String)

abstract String getRegion()

Retorna a região do usuário.

abstract RawImage getScreenshot()

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

abstract RawImage getScreenshot(long timeout, TimeUnit unit)
abstract String getSerialNumber()

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

abstract IDevice.DeviceState getState()

Retorna o estado do dispositivo.

abstract SyncService getSyncService()

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

abstract boolean hasClients()

Retorna se o IDevice tem Clients.

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

Instala um aplicativo Android no dispositivo.

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

Instala um aplicativo Android no dispositivo.

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

Instala um aplicativo Android no dispositivo.

default 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.

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

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

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

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

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

default 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.

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

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

abstract boolean isBootLoader()

Retorna se o dispositivo está no modo bootloader.

abstract boolean isEmulator()

Retorna true se o dispositivo for um emulador.

abstract boolean isOffline()

Retorna se o dispositivo está off-line.

abstract boolean isOnline()

Retorna se o dispositivo está pronto.

abstract boolean isRoot()

Consulta o status de root atual do dispositivo.

default void kill(String applicationName)

Encerra um aplicativo pelo nome.

abstract void pullFile(String remote, String local)

Extrai um único arquivo.

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

Envia vários arquivos ou diretórios.

abstract void pushFile(String local, String remote)

Envia um único arquivo.

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

Invocar o serviço Android Binder Bridge em um dispositivo remoto.

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

Invoca o serviço host:exec em um dispositivo remoto.

abstract void reboot(String into)

Reinicialize o dispositivo.

default void removeForward(int localPort)

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

default void removeForward(int localPort, int remotePort)

Esse método foi descontinuado. Use removeForward(int)

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

Esse método foi descontinuado. Use removeForward(int)

abstract void removeRemotePackage(String remoteFilePath)

Remove um arquivo do dispositivo.

default void removeReverse(int remotePort)

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

abstract boolean root()

Peça ao daemon adb para se tornar root no dispositivo.

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

abstract boolean supportsFeature(IDevice.HardwareFeature feature)

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

abstract boolean supportsFeature(IDevice.Feature feature)

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

abstract String syncPackageToDevice(String localFilePath)

Envia um arquivo para o dispositivo

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

Desinstala um app do dispositivo.

abstract String uninstallPackage(String packageName)

Desinstala um pacote do dispositivo.

Constantes

CHANGE_BUILD_INFO

public static final int CHANGE_BUILD_INFO

Máscara de bits de mudança do dispositivo: mudança nas informações do build.

Valor da constante: 4 (0x00000004)

CHANGE_CLIENT_LIST

public static final int CHANGE_CLIENT_LIST

Máscara de bits de mudança de dispositivo: mudança na lista Client.

Valor da constante: 2 (0x00000002)

CHANGE_PROFILEABLE_CLIENT_LIST

public static final int CHANGE_PROFILEABLE_CLIENT_LIST

Máscara de bits de mudança de dispositivo: mudança na lista ProfileableClient.

Valor da constante: 8 (0x00000008)

CHANGE_STATE

public static final int CHANGE_STATE

Máscara de bits de mudança de dispositivo: mudança de DeviceState.

Valor da constante: 1 (0x00000001)

FIRST_EMULATOR_SN

public static final String FIRST_EMULATOR_SN

Número de série do primeiro emulador conectado.

Valor da constante: "emulator-5554"

MNT_DATA

public static final String MNT_DATA

Valor da constante: "ANDROID_DATA"

MNT_EXTERNAL_STORAGE

public static final String MNT_EXTERNAL_STORAGE

Valor da constante: "EXTERNAL_STORAGE"

MNT_ROOT

public static final String MNT_ROOT

Valor da constante: "ANDROID_ROOT"

PROP_BUILD_API_LEVEL

public static final String PROP_BUILD_API_LEVEL

Valor da constante: "ro.build.version.sdk"

PROP_BUILD_CHARACTERISTICS

public static final String PROP_BUILD_CHARACTERISTICS

Valor da constante: "ro.build.characteristics"

PROP_BUILD_CODENAME

public static final String PROP_BUILD_CODENAME

Valor da constante: "ro.build.version.codename"

PROP_BUILD_TAGS

public static final String PROP_BUILD_TAGS

Valor da constante: "ro.build.tags"

PROP_BUILD_TYPE

public static final String PROP_BUILD_TYPE

Valor da constante: "ro.build.type"

PROP_BUILD_VERSION

public static final String PROP_BUILD_VERSION

Valor da constante: "ro.build.version.release"

PROP_BUILD_VERSION_NUMBER

public static final String PROP_BUILD_VERSION_NUMBER

Essa constante teve o uso suspenso.
Use PROP_BUILD_API_LEVEL.

Valor da constante: "ro.build.version.sdk"

PROP_DEBUGGABLE

public static final String PROP_DEBUGGABLE

Valor da constante: "ro.debuggable"

PROP_DEVICE_CPU_ABI

public static final String PROP_DEVICE_CPU_ABI

Valor da constante: "ro.product.cpu.abi"

PROP_DEVICE_CPU_ABI2

public static final String PROP_DEVICE_CPU_ABI2

Valor da constante: "ro.product.cpu.abi2"

PROP_DEVICE_CPU_ABI_LIST

public static final String PROP_DEVICE_CPU_ABI_LIST

Valor da constante: "ro.product.cpu.abilist"

PROP_DEVICE_DENSITY

public static final String PROP_DEVICE_DENSITY

Valor da constante: "ro.sf.lcd_density"

PROP_DEVICE_EMULATOR_DENSITY

public static final String PROP_DEVICE_EMULATOR_DENSITY

Valor da constante: "qemu.sf.lcd_density"

PROP_DEVICE_LANGUAGE

public static final String PROP_DEVICE_LANGUAGE

Valor da constante: "persist.sys.language"

PROP_DEVICE_MANUFACTURER

public static final String PROP_DEVICE_MANUFACTURER

Valor da constante: "ro.product.manufacturer"

PROP_DEVICE_MODEL

public static final String PROP_DEVICE_MODEL

Valor da constante: "ro.product.model"

PROP_DEVICE_REGION

public static final String PROP_DEVICE_REGION

Valor da constante: "persist.sys.country"

RE_EMULATOR_SN

public static final String RE_EMULATOR_SN

Expressão regular do número de série do emulador.

Valor da constante: "emulator-(\d+)"

UNKNOWN_PACKAGE

public static final String UNKNOWN_PACKAGE

Valor da constante: ""

Métodos públicos

arePropertiesSet

public abstract boolean arePropertiesSet ()

Retorna true se as propriedades tiverem sido armazenadas em cache.

Retorna
boolean

createForward

public abstract 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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
em caso de erro de E/S na conexão.

createForward

public abstract 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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
em caso de erro de E/S na conexão.

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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
em caso de erro de E/S na conexão.

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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
ShellCommandUnresponsiveException caso o comando do binder não envie saída por um determinado período.
em caso de erro de E/S na conexão.

Confira também:

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 abstract 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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
ShellCommandUnresponsiveException caso o comando do shell não envie saída por um determinado período.
em caso de erro de E/S na conexão.

executeShellCommand

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

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

Parâmetros
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse int

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 abstract  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 abstract 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 abstract 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 abstract  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 abstract  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 abstract 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
com.android.ddmlib.ShellCommandUnresponsiveException
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getBatteryLevel

public abstract 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 abstract 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 abstract 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 abstract Client[] getClients ()

Retorna a matriz de clientes.

Retorna
Client[]

getDensity

public abstract 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 abstract FileListingService getFileListingService ()

Retorna um FileListingService para este dispositivo.

Retorna
FileListingService

getHardwareCharacteristics

public  getHardwareCharacteristics ()

Retorna recursos obtidos pela leitura da propriedade de características de build.

Retorna

getLanguage

public abstract 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 abstract String getMountPoint (String name)

Retorna um ponto de montagem.

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

getProfileableClients

public ProfileableClient[] getProfileableClients ()

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

Retorna
ProfileableClient[]

getProperties

public abstract  getProperties ()

Esse método foi descontinuado.
use IShellEnabledDevice.getSystemProperty(String) em vez disso

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

Retorna

getProperty

public abstract 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 abstract String getPropertyCacheOrSync (String name)

Esse método foi descontinuado.
use IShellEnabledDevice.getSystemProperty(String) em vez disso

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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
ShellCommandUnresponsiveException caso o comando do shell não envie saída por um determinado período.
em caso de erro de E/S na conexão.

getPropertyCount

public abstract int getPropertyCount ()

Esse método foi descontinuado.
detalhe da implementação

Retorna o número de propriedades para este dispositivo.

Retorna
int

getPropertySync

public abstract String getPropertySync (String name)

Esse método foi descontinuado.
use IShellEnabledDevice.getSystemProperty(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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
ShellCommandUnresponsiveException caso o comando do shell não envie saída por um determinado período.
em caso de erro de E/S na conexão.

getRegion

public abstract 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 abstract 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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
em caso de erro de E/S na conexão.

getScreenshot

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Parâmetros
timeout long

unit TimeUnit

Retorna
RawImage

Gera
AdbCommandRejectedException
TimeoutException

getSerialNumber

public abstract String getSerialNumber ()

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

Retorna
String

getState

public abstract IDevice.DeviceState getState ()

Retorna o estado do dispositivo.

Retorna
IDevice.DeviceState

getSyncService

public abstract 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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
se a conexão com o adb falhar.

hasClients

public abstract boolean hasClients ()

Retorna se o IDevice tem Clients.

Retorna
boolean

installPackage

public abstract 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 se a instalação falhar.

installPackage

public abstract 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 se a instalação falhar.

installPackage

public abstract 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 se a instalação falhar.

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 se a instalação falhar.

installPackages

public abstract 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 se a instalação falhar.

installRemotePackage

public abstract 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 se a instalação falhar.

installRemotePackage

public abstract 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 se a instalação falhar.

installRemotePackage

public abstract 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 se a instalação falhar.

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 se a instalação falhar.

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 se a instalação falhar.

isBootLoader

public abstract boolean isBootLoader ()

Retorna se o dispositivo está no modo bootloader.

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

isEmulator

public abstract boolean isEmulator ()

Retorna true se o dispositivo for um emulador.

Retorna
boolean

isOffline

public abstract boolean isOffline ()

Retorna se o dispositivo está off-line.

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

isOnline

public abstract boolean isOnline ()

Retorna se o dispositivo está pronto.

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

isRoot

public abstract 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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando.
ShellCommandUnresponsiveException

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 abstract 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
em caso de uma exceção de E/S.
AdbCommandRejectedException se o adb rejeitar o comando
TimeoutException em caso de tempo limite ao ler respostas do dispositivo.
SyncException em caso de uma exceção de sincronização.

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
em caso de erro de E/S na conexão
AdbCommandRejectedException se o adb rejeitar o comando
TimeoutException em caso de tempo limite ao ler respostas do dispositivo
SyncException se alguns arquivos não puderem ser enviados por push

pushFile

public abstract 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
em caso de erro de E/S na conexão
AdbCommandRejectedException se o adb rejeitar o comando
TimeoutException em caso de tempo limite ao ler respostas do dispositivo
SyncException se não for possível enviar o arquivo

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 abstract 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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
IOException

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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
em caso de erro de E/S na conexão.

removeForward

public void removeForward (int localPort, 
                int remotePort)

Esse método foi descontinuado.
Use removeForward(int)

Parâmetros
localPort int

remotePort int

Gera
AdbCommandRejectedException
TimeoutException

removeForward

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

Esse método foi descontinuado.
Use removeForward(int)

Parâmetros
localPort int

remoteSocketName String

namespace IDevice.DeviceUnixSocketNamespace

Gera
AdbCommandRejectedException
TimeoutException

removeRemotePackage

public abstract void removeRemotePackage (String remoteFilePath)

Remove um arquivo do dispositivo.

Parâmetros
remoteFilePath String: caminho no dispositivo do arquivo a ser removido
Gera
InstallException se a instalação falhar.

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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
em caso de erro de E/S na conexão.

raiz

public abstract 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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando.
ShellCommandUnresponsiveException se não for possível consultar o status da raiz.
IOException

startScreenRecorder

public abstract 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 abstract 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 abstract 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 abstract 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
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
em caso de erro de E/S na conexão.
SyncException se ocorrer um erro durante o envio do pacote para o dispositivo.

uninstallApp

public abstract 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 se a desinstalação falhar.

uninstallPackage

public abstract 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 se a desinstalação falhar.