Cliente

public interface Client

com.android.tradefed.device.server.Client

Rappresenta un singolo client, in genere un processo VM Dalvik.

Questa classe consente di accedere alle informazioni di base del client, nonché ai metodi per eseguire azioni sul client.

Informazioni più dettagliate, generalmente aggiornate in tempo reale, sono accessibili tramite la classe ClientData. Ogni oggetto Client ha il proprio ClientData a cui si accede tramite getClientData().

Riepilogo

Costanti

int CHANGE_DEBUGGER_STATUS

Maschera di bit di modifica del client: modifica dello stato del debugger

int CHANGE_HEAP_ALLOCATIONS

Maschera di bit di modifica del client: informazioni sull'allocazione aggiornate

int CHANGE_HEAP_ALLOCATION_STATUS

Maschera di bit di modifica del client: informazioni sull'allocazione aggiornate

int CHANGE_HEAP_DATA

Maschera di bit di modifica del client: dati di intestazione aggiornati

int CHANGE_HEAP_MODE

Maschera di bit di modifica del client: modifica del flag di aggiornamento dell'heap

int CHANGE_HPROF

Maschera di bit di modifica del client: dati hprof aggiornati

int CHANGE_INFO

Maschera di bit di modifica del client: combinazione di Client.CHANGE_NAME, CHANGE_DEBUGGER_STATUS e Client.CHANGE_PORT.

int CHANGE_METHOD_PROFILING_STATUS

Maschera di bit di modifica del client: informazioni sull'allocazione aggiornate

int CHANGE_NAME

Maschera di bit di modifica del client: modifica del nome dell'applicazione

int CHANGE_NATIVE_HEAP_DATA

Maschera di bit di modifica del client: dati dell'heap nativo aggiornati

int CHANGE_PORT

Maschera di bit di modifica del client: modifica della porta del debugger

int CHANGE_THREAD_DATA

Maschera di bit di modifica del client: dati del thread aggiornati

int CHANGE_THREAD_MODE

Maschera di bit di modifica del client: modifica del flag di aggiornamento del thread

int CHANGE_THREAD_STACKTRACE

Maschera di bit di modifica del client: stack trace del thread aggiornato

int SERVER_PROTOCOL_VERSION

Metodi pubblici

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)

Attiva o disattiva lo strumento di monitoraggio dell'allocazione per questo cliente.

abstract void executeGarbageCollector()

Forza il client a eseguire il garbage collector.

abstract ClientData getClientData()

Restituisce l'oggetto ClientData contenente queste informazioni sul cliente.

abstract int getDebuggerListenPort()

Restituisce la porta del debugger per questo client.

abstract IDevice getDevice()

Restituisce il IDevice su cui è in esecuzione questo client.

abstract boolean isDdmAware()

Restituisce true se la VM client è compatibile con DDM.

abstract boolean isDebuggerAttached()

Restituisce true se è attualmente collegato un debugger al client.

abstract boolean isValid()

Restituisce un valore che indica se questo ClientImpl ha una connessione valida alla VM dell'applicazione.

abstract void kill()

Invia un messaggio di interruzione alla VM.

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

I mirror delle VM di debug possono uscire da DDMLib, causando varie condizioni di perdita di perma-Client o di competizione.

abstract void requestAllocationDetails()

Invia una richiesta alla VM per inviare le informazioni su tutte le allocazioni avvenute dalla chiamata a enableAllocationTracker(boolean) con enable impostato su null.

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

Costanti

CHANGE_DEBUGGER_STATUS

public static final int CHANGE_DEBUGGER_STATUS

Maschera di bit di modifica del client: modifica dello stato del debugger

Constant Value: 2 (0x00000002)

CHANGE_HEAP_ALLOCATIONS

public static final int CHANGE_HEAP_ALLOCATIONS

Maschera di bit di modifica del client: informazioni sull'allocazione aggiornate

Valore costante: 512 (0x00000200)

CHANGE_HEAP_ALLOCATION_STATUS

public static final int CHANGE_HEAP_ALLOCATION_STATUS

Maschera di bit di modifica del client: informazioni sull'allocazione aggiornate

Constant Value: 1024 (0x00000400)

CHANGE_HEAP_DATA

public static final int CHANGE_HEAP_DATA

Maschera di bit di modifica del client: dati di intestazione aggiornati

Valore costante: 64 (0x00000040)

CHANGE_HEAP_MODE

public static final int CHANGE_HEAP_MODE

Maschera di bit di modifica del client: modifica del flag di aggiornamento dell'heap

Constant Value: 32 (0x00000020)

CHANGE_HPROF

public static final int CHANGE_HPROF

Maschera di bit di modifica del client: dati hprof aggiornati

Valore costante: 4096 (0x00001000)

CHANGE_INFO

public static final int CHANGE_INFO

Maschera di bit di modifica del client: combinazione di Client.CHANGE_NAME, CHANGE_DEBUGGER_STATUS e Client.CHANGE_PORT.

Constant Value: 7 (0x00000007)

CHANGE_METHOD_PROFILING_STATUS

public static final int CHANGE_METHOD_PROFILING_STATUS

Maschera di bit di modifica del client: informazioni sull'allocazione aggiornate

Constant Value: 2048 (0x00000800)

CHANGE_NAME

public static final int CHANGE_NAME

Maschera di bit di modifica del client: modifica del nome dell'applicazione

Constant Value: 1 (0x00000001)

CHANGE_NATIVE_HEAP_DATA

public static final int CHANGE_NATIVE_HEAP_DATA

Maschera di bit di modifica del client: dati dell'heap nativo aggiornati

Constant Value: 128 (0x00000080)

CHANGE_PORT

public static final int CHANGE_PORT

Maschera di bit di modifica del client: modifica della porta del debugger

Valore costante: 4 (0x00000004)

CHANGE_THREAD_DATA

public static final int CHANGE_THREAD_DATA

Maschera di bit di modifica del client: dati del thread aggiornati

Valore costante: 16 (0x00000010)

CHANGE_THREAD_MODE

public static final int CHANGE_THREAD_MODE

Maschera di bit di modifica del client: modifica del flag di aggiornamento del thread

Valore costante: 8 (0x00000008)

CHANGE_THREAD_STACKTRACE

public static final int CHANGE_THREAD_STACKTRACE

Maschera di bit di modifica del client: stack trace del thread aggiornato

Valore costante: 256 (0x00000100)

SERVER_PROTOCOL_VERSION

public static final int SERVER_PROTOCOL_VERSION

Constant Value: 1 (0x00000001)

Metodi pubblici

captureView

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

Parametri
viewRoot String

view String

handler DebugViewDumpHandler

dumpDisplayList

public abstract void dumpDisplayList (String viewRoot, 
                String view)

Parametri
viewRoot String

view String

dumpViewHierarchy

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

Parametri
viewRoot String

skipChildren boolean

includeProperties boolean

useV2 boolean

handler DebugViewDumpHandler

enableAllocationTracker

public abstract void enableAllocationTracker (boolean enabled)

Attiva o disattiva il monitoraggio dell'allocazione per questo cliente.

Se attivata, la VM inizierà a monitorare le informazioni di allocazione. Una chiamata a requestAllocationDetails() farà in modo che la VM invii le informazioni su tutte le allocazioni avvenute tra l'attivazione e la richiesta.

Parametri
enabled boolean

executeGarbageCollector

public abstract void executeGarbageCollector ()

Forza il client a eseguire il garbage collector.

getClientData

public abstract ClientData getClientData ()

Restituisce l'oggetto ClientData contenente queste informazioni sul cliente.

Ritorni
ClientData

getDebuggerListenPort

public abstract int getDebuggerListenPort ()

Restituisce la porta del debugger per questo client.

Ritorni
int

getDevice

public abstract IDevice getDevice ()

Restituisce il IDevice su cui è in esecuzione questo client.

Ritorni
IDevice

isDdmAware

public abstract boolean isDdmAware ()

Restituisce true se la VM client è compatibile con DDM.

Le chiamate qui sono consentite solo dopo che la connessione è stata stabilita.

Ritorni
boolean

isDebuggerAttached

public abstract boolean isDebuggerAttached ()

Restituisce true se è attualmente collegato un debugger al client.

Ritorni
boolean

isValid

public abstract boolean isValid ()

Restituisce un valore che indica se questo ClientImpl ha una connessione valida alla VM dell'applicazione.

Ritorni
boolean

uccidere

public abstract void kill ()

Invia un messaggio di interruzione alla VM. Questa operazione non funziona necessariamente se la VM è in stato di arresto anomalo.

listViewRoots

public abstract void listViewRoots (DebugViewDumpHandler replyHandler)

Parametri
replyHandler DebugViewDumpHandler

notifyVmMirrorExited

public abstract void notifyVmMirrorExited ()

I mirror delle VM di debug possono uscire da DDMLib, causando varie condizioni di perdita di perma-Client o di competizione. Dobbiamo notificare a DDMLib che il debugger attualmente collegato sta uscendo e interrompendo la connessione mirror della VM.

requestAllocationDetails

public abstract void requestAllocationDetails ()

Invia una richiesta alla VM per inviare le informazioni su tutte le allocazioni avvenute dalla chiamata a enableAllocationTracker(boolean) con enable impostato su null. Questa operazione è asincrona.

Le informazioni sull'assegnazione sono accessibili da ClientData.getAllocations(). La notifica della disponibilità dei nuovi dati verrà ricevuta tramite AndroidDebugBridge.clientChanged(com.android.tradefed.device.server.ClientImpl, int) con un changeMask contenente la maschera CHANGE_HEAP_ALLOCATIONS.

startMethodTracer

public abstract void startMethodTracer ()

startSamplingProfiler

public abstract void startSamplingProfiler (int samplingInterval, 
                TimeUnit timeUnit)

Parametri
samplingInterval int

timeUnit TimeUnit

stopMethodTracer

public abstract void stopMethodTracer ()

stopSamplingProfiler

public abstract void stopSamplingProfiler ()