Kunde

public interface Client

com.android.tradefed.device.server.Client

Dies entspricht einem einzelnen Client, in der Regel einem Dalvik VM-Prozess.

Diese Klasse bietet Zugriff auf grundlegende Clientinformationen sowie Methoden zum Ausführen von Aktionen auf dem Client.

Detailliertere Informationen, die in der Regel in Echtzeit aktualisiert werden, sind über die Klasse ClientData verfügbar. Jedes Client-Objekt hat einen eigenen ClientData, auf den über getClientData() zugegriffen wird.

Zusammenfassung

Konstanten

int CHANGE_DEBUGGER_STATUS

Client-Änderungsbitmaske: Debugger-Statusänderung

int CHANGE_HEAP_ALLOCATIONS

Client-Änderungsbitmaske: Zuweisungsinformationen aktualisiert

int CHANGE_HEAP_ALLOCATION_STATUS

Client-Änderungsbitmaske: Zuweisungsinformationen aktualisiert

int CHANGE_HEAP_DATA

Bitmaske für Clientänderungen: Kopfdaten aktualisiert

int CHANGE_HEAP_MODE

Bitmaske für Clientänderungen: Änderung des Flags für Heap-Aktualisierung

int CHANGE_HPROF

Client-Änderungsbitmaske: hprof-Daten aktualisiert

int CHANGE_INFO

Bitmaske für Clientänderungen: Kombination aus Client.CHANGE_NAME, CHANGE_DEBUGGER_STATUS und Client.CHANGE_PORT.

int CHANGE_METHOD_PROFILING_STATUS

Client-Änderungsbitmaske: Zuweisungsinformationen aktualisiert

int CHANGE_NAME

Bitmaske für Clientänderungen: Änderung des Anwendungsnamens

int CHANGE_NATIVE_HEAP_DATA

Client-Änderungsbitmaske: Native Heap-Daten aktualisiert

int CHANGE_PORT

Bitmaske für Clientänderungen: Änderung des Debugger-Ports

int CHANGE_THREAD_DATA

Bitmaske für Clientänderungen: Thread-Daten aktualisiert

int CHANGE_THREAD_MODE

Bitmaske für Clientänderungen: Änderung des Thread-Aktualisierungsflags

int CHANGE_THREAD_STACKTRACE

Client-Änderungsbitmaske: Thread-Stacktrace aktualisiert

int SERVER_PROTOCOL_VERSION

Öffentliche Methoden

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)

Aktiviert oder deaktiviert den Zuweisungs-Tracker für diesen Kunden.

abstract void executeGarbageCollector()

Erzwingt die Ausführung der Speicherbereinigung auf dem Client.

abstract ClientData getClientData()

Gibt das ClientData-Objekt mit diesen Clientinformationen zurück.

abstract int getDebuggerListenPort()

Gibt den Debugger-Port für diesen Client zurück.

abstract IDevice getDevice()

Gibt das IDevice zurück, auf dem dieser Client ausgeführt wird.

abstract boolean isDdmAware()

Gibt true zurück, wenn die Client-VM DDM-fähig ist.

abstract boolean isDebuggerAttached()

Gibt true zurück, wenn derzeit ein Debugger an den Client angehängt ist.

abstract boolean isValid()

Gibt zurück, ob diese ClientImpl eine gültige Verbindung zur Anwendungs-VM hat.

abstract void kill()

Sendet eine Kill-Nachricht an die VM.

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

Debugger-VM-Mirrors können ohne Wissen von DDMLib beendet werden, was zu verschiedenen Race- oder Permanent-Client-Verlustbedingungen führen kann.

abstract void requestAllocationDetails()

Sendet eine Anfrage an die VM, um Informationen zu allen Zuweisungen zu senden, die seit dem Aufruf von enableAllocationTracker(boolean) mit enable auf null erfolgt sind.

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

Konstanten

CHANGE_DEBUGGER_STATUS

public static final int CHANGE_DEBUGGER_STATUS

Client-Änderungsbitmaske: Debugger-Statusänderung

Konstanter Wert: 2 (0x00000002)

CHANGE_HEAP_ALLOCATIONS

public static final int CHANGE_HEAP_ALLOCATIONS

Client-Änderungsbitmaske: Zuweisungsinformationen aktualisiert

Konstanter Wert: 512 (0x00000200)

CHANGE_HEAP_ALLOCATION_STATUS

public static final int CHANGE_HEAP_ALLOCATION_STATUS

Client-Änderungsbitmaske: Zuweisungsinformationen aktualisiert

Konstanter Wert: 1024 (0x00000400)

CHANGE_HEAP_DATA

public static final int CHANGE_HEAP_DATA

Bitmaske für Clientänderungen: Kopfdaten aktualisiert

Konstanter Wert: 64 (0x00000040)

CHANGE_HEAP_MODE

public static final int CHANGE_HEAP_MODE

Bitmaske für Clientänderungen: Änderung des Heap-Aktualisierungs-Flags

Konstanter Wert: 32 (0x00000020)

CHANGE_HPROF

public static final int CHANGE_HPROF

Client-Änderungsbitmaske: hprof-Daten aktualisiert

Konstanter Wert: 4096 (0x00001000)

CHANGE_INFO

public static final int CHANGE_INFO

Bitmaske für Clientänderungen: Kombination aus Client.CHANGE_NAME, CHANGE_DEBUGGER_STATUS und Client.CHANGE_PORT.

Konstanter Wert: 7 (0x00000007)

CHANGE_METHOD_PROFILING_STATUS

public static final int CHANGE_METHOD_PROFILING_STATUS

Client-Änderungsbitmaske: Zuweisungsinformationen aktualisiert

Konstanter Wert: 2048 (0x00000800)

CHANGE_NAME

public static final int CHANGE_NAME

Bitmaske für Clientänderungen: Änderung des Anwendungsnamens

Konstanter Wert: 1 (0x00000001)

CHANGE_NATIVE_HEAP_DATA

public static final int CHANGE_NATIVE_HEAP_DATA

Client-Änderungsbitmaske: Native Heap-Daten aktualisiert

Konstanter Wert: 128 (0x00000080)

CHANGE_PORT

public static final int CHANGE_PORT

Bitmaske für Clientänderungen: Änderung des Debugger-Ports

Konstanter Wert: 4 (0x00000004)

CHANGE_THREAD_DATA

public static final int CHANGE_THREAD_DATA

Bitmaske für Clientänderungen: Thread-Daten aktualisiert

Konstanter Wert: 16 (0x00000010)

CHANGE_THREAD_MODE

public static final int CHANGE_THREAD_MODE

Bitmaske für Clientänderungen: Änderung des Thread-Aktualisierungsflags

Konstanter Wert: 8 (0x00000008)

CHANGE_THREAD_STACKTRACE

public static final int CHANGE_THREAD_STACKTRACE

Client-Änderungsbitmaske: Thread-Stacktrace aktualisiert

Konstanter Wert: 256 (0x00000100)

SERVER_PROTOCOL_VERSION

public static final int SERVER_PROTOCOL_VERSION

Konstanter Wert: 1 (0x00000001)

Öffentliche Methoden

captureView

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

Parameter
viewRoot String

view String

handler DebugViewDumpHandler

dumpDisplayList

public abstract void dumpDisplayList (String viewRoot, 
                String view)

Parameter
viewRoot String

view String

dumpViewHierarchy

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

Parameter
viewRoot String

skipChildren boolean

includeProperties boolean

useV2 boolean

handler DebugViewDumpHandler

enableAllocationTracker

public abstract void enableAllocationTracker (boolean enabled)

Aktiviert oder deaktiviert den Zuweisungs-Tracker für diesen Kunden.

Wenn diese Option aktiviert ist, werden für die VM Zuweisungsinformationen erfasst. Bei einem Aufruf von requestAllocationDetails() sendet die VM die Informationen zu allen Zuweisungen, die zwischen der Aktivierung und der Anfrage erfolgt sind.

Parameter
enabled boolean

Weitere Informationen

executeGarbageCollector

public abstract void executeGarbageCollector ()

Erzwingt die Ausführung der Speicherbereinigung auf dem Client.

getClientData

public abstract ClientData getClientData ()

Gibt das ClientData-Objekt mit diesen Clientinformationen zurück.

Returns
ClientData

getDebuggerListenPort

public abstract int getDebuggerListenPort ()

Gibt den Debugger-Port für diesen Client zurück.

Returns
int

getDevice

public abstract IDevice getDevice ()

Gibt das IDevice zurück, auf dem dieser Client ausgeführt wird.

Returns
IDevice

isDdmAware

public abstract boolean isDdmAware ()

Gibt true zurück, wenn die Client-VM DDM-fähig ist.

Anrufe sind hier erst nach dem Herstellen der Verbindung möglich.

Returns
boolean

isDebuggerAttached

public abstract boolean isDebuggerAttached ()

Gibt true zurück, wenn derzeit ein Debugger an den Client angehängt ist.

Returns
boolean

isValid

public abstract boolean isValid ()

Gibt zurück, ob diese ClientImpl eine gültige Verbindung zur Anwendungs-VM hat.

Returns
boolean

aufhören

public abstract void kill ()

Sendet eine Kill-Nachricht an die VM. Das funktioniert nicht unbedingt, wenn sich die VM in einem abgestürzten Zustand befindet.

listViewRoots

public abstract void listViewRoots (DebugViewDumpHandler replyHandler)

Parameter
replyHandler DebugViewDumpHandler

notifyVmMirrorExited

public abstract void notifyVmMirrorExited ()

Debugger-VM-Mirrors können ohne Wissen von DDMLib beendet werden, was zu verschiedenen Race- oder Permanent-Client-Verlustbedingungen führen kann. Wir müssen DDMLib darüber informieren, dass der aktuell angehängte Debugger beendet wird und die VM-Spiegelverbindung beendet.

requestAllocationDetails

public abstract void requestAllocationDetails ()

Sendet eine Anfrage an die VM, um Informationen zu allen Zuweisungen zu senden, die seit dem Aufruf von enableAllocationTracker(boolean) mit enable auf null erfolgt sind. Dieser Vorgang ist asynchron.

Die Zuweisungsinformationen sind über ClientData.getAllocations() verfügbar. Die Benachrichtigung, dass die neuen Daten verfügbar sind, wird über AndroidDebugBridge.clientChanged(com.android.tradefed.device.server.ClientImpl, int) mit einem changeMask mit der Maske CHANGE_HEAP_ALLOCATIONS empfangen.

startMethodTracer

public abstract void startMethodTracer ()

startSamplingProfiler

public abstract void startSamplingProfiler (int samplingInterval, 
                TimeUnit timeUnit)

Parameter
samplingInterval int

timeUnit TimeUnit

stopMethodTracer

public abstract void stopMethodTracer ()

stopSamplingProfiler

public abstract void stopSamplingProfiler ()