Cliente

public interface Client

com.android.tradefed.device.server.Client

Isso representa um único cliente, geralmente um processo de VM Dalvik.

Essa classe dá acesso a informações básicas do cliente, bem como métodos para realizar ações no cliente.

Informações mais detalhadas, geralmente atualizadas em tempo real, podem ser acessadas pela classe ClientData. Cada objeto Client tem seu próprio ClientData acessado por getClientData().

Resumo

Constantes

int CHANGE_DEBUGGER_STATUS

Máscara de bits de mudança do cliente: mudança no status do depurador

int CHANGE_HEAP_ALLOCATIONS

Máscara de bits de mudança do cliente: informações de alocação atualizadas

int CHANGE_HEAP_ALLOCATION_STATUS

Máscara de bits de mudança do cliente: informações de alocação atualizadas

int CHANGE_HEAP_DATA

Máscara de bits de mudança do cliente: dados de cabeçalho atualizados

int CHANGE_HEAP_MODE

Máscara de bits de mudança do cliente: mudança de flag de atualização do heap

int CHANGE_HPROF

Máscara de bits de mudança do cliente: dados hprof atualizados

int CHANGE_INFO

Máscara de bits de mudança do cliente: combinação de Client.CHANGE_NAME, CHANGE_DEBUGGER_STATUS e Client.CHANGE_PORT.

int CHANGE_METHOD_PROFILING_STATUS

Máscara de bits de mudança do cliente: informações de alocação atualizadas

int CHANGE_NAME

Máscara de bits de mudança do cliente: mudança no nome do aplicativo

int CHANGE_NATIVE_HEAP_DATA

Máscara de bits de mudança do cliente: dados de heap nativo atualizados

int CHANGE_PORT

Máscara de bits de mudança do cliente: mudança de porta do depurador

int CHANGE_THREAD_DATA

Máscara de bits de mudança do cliente: dados da linha de execução atualizados

int CHANGE_THREAD_MODE

Máscara de bits de mudança do cliente: mudança da flag de atualização da linha de execução

int CHANGE_THREAD_STACKTRACE

Máscara de bits de mudança do cliente: rastreamento de pilha da linha de execução atualizado

int SERVER_PROTOCOL_VERSION

Métodos públicos

abstract void captureView(String viewRoot, String view, DebugViewDumpHandler handler)
abstract void dumpDisplayList(String viewRoot, String view)
abstract void dumpViewHierarchy(String viewRoot, boolean skipChildren, boolean includeProperties, boolean useV2, DebugViewDumpHandler handler)
abstract void enableAllocationTracker(boolean enabled)

Ativa ou desativa o rastreador de alocações para este cliente.

abstract void executeGarbageCollector()

Força o cliente a executar o coletor de lixo.

abstract ClientData getClientData()

Retorna o objeto ClientData que contém essas informações do cliente.

abstract int getDebuggerListenPort()

Retorna a porta do depurador para este cliente.

abstract IDevice getDevice()

Retorna o IDevice em que este cliente está sendo executado.

abstract boolean isDdmAware()

Retorna true se a VM cliente for compatível com DDM.

abstract boolean isDebuggerAttached()

Retorna true se um depurador estiver anexado ao cliente.

abstract boolean isValid()

Retorna se este ClientImpl tem uma conexão válida com a VM do aplicativo.

abstract void kill()

Envia uma mensagem de encerramento para a VM.

abstract void listViewRoots(DebugViewDumpHandler replyHandler)
abstract void notifyVmMirrorExited()

As VMs de depuração podem sair por trás da DDMLib, resultando em várias condições de perda de corrida ou permanente de Client.

abstract void requestAllocationDetails()

Envia uma solicitação à VM para enviar as informações sobre todas as alocações que ocorreram desde a chamada para enableAllocationTracker(boolean) com enable definido como null.

abstract void startMethodTracer()
abstract void startSamplingProfiler(int samplingInterval, TimeUnit timeUnit)
abstract void stopMethodTracer()
abstract void stopSamplingProfiler()

Constantes

CHANGE_DEBUGGER_STATUS

public static final int CHANGE_DEBUGGER_STATUS

Máscara de bits de mudança do cliente: mudança no status do depurador

Valor da constante: 2 (0x00000002)

CHANGE_HEAP_ALLOCATIONS

public static final int CHANGE_HEAP_ALLOCATIONS

Máscara de bits de mudança do cliente: informações de alocação atualizadas

Valor da constante: 512 (0x00000200)

CHANGE_HEAP_ALLOCATION_STATUS

public static final int CHANGE_HEAP_ALLOCATION_STATUS

Máscara de bits de mudança do cliente: informações de alocação atualizadas

Valor da constante: 1024 (0x00000400)

CHANGE_HEAP_DATA

public static final int CHANGE_HEAP_DATA

Máscara de bits de mudança do cliente: dados de cabeçalho atualizados

Valor da constante: 64 (0x00000040)

CHANGE_HEAP_MODE

public static final int CHANGE_HEAP_MODE

Máscara de bits de mudança do cliente: mudança de flag de atualização de heap

Valor da constante: 32 (0x00000020)

CHANGE_HPROF

public static final int CHANGE_HPROF

Máscara de bits de mudança do cliente: dados hprof atualizados

Valor da constante: 4096 (0x00001000)

CHANGE_INFO

public static final int CHANGE_INFO

Máscara de bits de mudança do cliente: combinação de Client.CHANGE_NAME, CHANGE_DEBUGGER_STATUS e Client.CHANGE_PORT.

Valor da constante: 7 (0x00000007)

CHANGE_METHOD_PROFILING_STATUS

public static final int CHANGE_METHOD_PROFILING_STATUS

Máscara de bits de mudança do cliente: informações de alocação atualizadas

Valor da constante: 2048 (0x00000800)

CHANGE_NAME

public static final int CHANGE_NAME

Máscara de bits de mudança do cliente: mudança no nome do aplicativo

Valor da constante: 1 (0x00000001)

CHANGE_NATIVE_HEAP_DATA

public static final int CHANGE_NATIVE_HEAP_DATA

Máscara de bits de mudança do cliente: dados de heap nativo atualizados

Valor da constante: 128 (0x00000080)

CHANGE_PORT

public static final int CHANGE_PORT

Máscara de bits de mudança do cliente: mudança de porta do depurador

Valor da constante: 4 (0x00000004)

CHANGE_THREAD_DATA

public static final int CHANGE_THREAD_DATA

Máscara de bits de mudança do cliente: dados da linha de execução atualizados

Valor da constante: 16 (0x00000010)

CHANGE_THREAD_MODE

public static final int CHANGE_THREAD_MODE

Máscara de bits de mudança do cliente: mudança da flag de atualização da linha de execução

Valor da constante: 8 (0x00000008)

CHANGE_THREAD_STACKTRACE

public static final int CHANGE_THREAD_STACKTRACE

Máscara de bits de mudança do cliente: rastreamento de pilha da linha de execução atualizado

Valor da constante: 256 (0x00000100)

SERVER_PROTOCOL_VERSION

public static final int SERVER_PROTOCOL_VERSION

Valor da constante: 1 (0x00000001)

Métodos públicos

captureView

public abstract void captureView (String viewRoot, 
                String view, 
                DebugViewDumpHandler handler)

Parâmetros
viewRoot String

view String

handler DebugViewDumpHandler

dumpDisplayList

public abstract void dumpDisplayList (String viewRoot, 
                String view)

Parâmetros
viewRoot String

view String

dumpViewHierarchy

public abstract void dumpViewHierarchy (String viewRoot, 
                boolean skipChildren, 
                boolean includeProperties, 
                boolean useV2, 
                DebugViewDumpHandler handler)

Parâmetros
viewRoot String

skipChildren boolean

includeProperties boolean

useV2 boolean

handler DebugViewDumpHandler

enableAllocationTracker

public abstract void enableAllocationTracker (boolean enabled)

Ativa ou desativa o rastreador de alocações para este cliente.

Se ativada, a VM vai começar a rastrear informações de alocação. Uma chamada para requestAllocationDetails() faz com que a VM envie as informações sobre todas as alocações que ocorreram entre a ativação e a solicitação.

Parâmetros
enabled boolean

Confira também:

executeGarbageCollector

public abstract void executeGarbageCollector ()

Força o cliente a executar o coletor de lixo.

getClientData

public abstract ClientData getClientData ()

Retorna o objeto ClientData que contém essas informações do cliente.

Retorna
ClientData

getDebuggerListenPort

public abstract int getDebuggerListenPort ()

Retorna a porta do depurador para este cliente.

Retorna
int

getDevice

public abstract IDevice getDevice ()

Retorna o IDevice em que este cliente está sendo executado.

Retorna
IDevice

isDdmAware

public abstract boolean isDdmAware ()

Retorna true se a VM cliente for compatível com DDM.

A chamada aqui só é permitida depois que a conexão é estabelecida.

Retorna
boolean

isDebuggerAttached

public abstract boolean isDebuggerAttached ()

Retorna true se um depurador estiver anexado ao cliente.

Retorna
boolean

isValid

public abstract boolean isValid ()

Retorna se este ClientImpl tem uma conexão válida com a VM do aplicativo.

Retorna
boolean

matar

public abstract void kill ()

Envia uma mensagem de encerramento para a VM. Isso não funciona necessariamente se a VM estiver em um estado de falha.

listViewRoots

public abstract void listViewRoots (DebugViewDumpHandler replyHandler)

Parâmetros
replyHandler DebugViewDumpHandler

notifyVmMirrorExited

public abstract void notifyVmMirrorExited ()

As VMs de depuração podem sair por trás da DDMLib, resultando em várias condições de perda de corrida ou permanente de Client. Precisamos notificar a DDMLib de que o depurador anexado está saindo e encerrando a conexão de espelhamento da VM.

requestAllocationDetails

public abstract void requestAllocationDetails ()

Envia uma solicitação à VM para enviar as informações sobre todas as alocações que ocorreram desde a chamada para enableAllocationTracker(boolean) com enable definido como null. Isso é assíncrono.

As informações de alocação podem ser acessadas por ClientData.getAllocations(). A notificação de que os novos dados estão disponíveis será recebida por AndroidDebugBridge.clientChanged(com.android.tradefed.device.server.ClientImpl, int) com um changeMask que contém a máscara CHANGE_HEAP_ALLOCATIONS.

startMethodTracer

public abstract void startMethodTracer ()

startSamplingProfiler

public abstract void startSamplingProfiler (int samplingInterval, 
                TimeUnit timeUnit)

Parâmetros
samplingInterval int

timeUnit TimeUnit

stopMethodTracer

public abstract void stopMethodTracer ()

stopSamplingProfiler

public abstract void stopSamplingProfiler ()