IShellEnabledDevice

public interface IShellEnabledDevice

com.android.ddmlib.IShellEnabledDevice


Um dispositivo abstrato que pode receber comandos de shell.

Resumo

Métodos públicos

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

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

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

abstract String getName()

Retorna um nome (humanizado) para este dispositivo.

abstract ListenableFuture<String> getSystemProperty(String name)

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

Métodos públicos

executeShellCommand

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

Confira também:

executeShellCommand

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

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.

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

Confira também:

getName

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

getSystemProperty

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