ClientData

public class ClientData
extends Object

java.lang.Object
   ↳ com.android.tradefed.device.server.ClientData

Enthält die Daten eines ClientImpl.

Zusammenfassung

Verschachtelte Klassen

class ClientData.HeapData

Heap-Informationen 

class ClientData.HeapInfo

 

class ClientData.HprofData

 

interface ClientData.IAllocationTrackingHandler

 

interface ClientData.IHprofDumpHandler

Handler, die auf HPROF-Dumps reagieren können. 

interface ClientData.IMethodProfilingHandler

Handler, die auf Informationen zur Methodenprofilerstellung reagieren können 

class ClientData.Names

 

Konstanten

String FEATURE_HPROF

String für das Feature, mit dem HPROF-Dateien gedumpt werden können

String FEATURE_HPROF_STREAMING

String für die Funktion, die das direkte Streamen von hprof-Dumps ermöglicht

String FEATURE_OPENGL_TRACING

String für das Feature, das die Unterstützung für das Tracing von OpenGL-Aufrufen angibt.

String FEATURE_PROFILING

String zum Aktivieren/Deaktivieren der Profilerstellung für Start-/Stoppmethoden

String FEATURE_PROFILING_STREAMING

String zum Aktivieren des direkten Streamings von Daten zur Methodenprofilerstellung

String FEATURE_SAMPLING_PROFILER

String zum Aktivieren des Sampling-Profilers.

String FEATURE_VIEW_HIERARCHY

String für das Feature, das die Unterstützung für die Bereitstellung der Ansichtshierarchie angibt.

String PRE_INITIALIZED

Temporärer Name der VM, die ignoriert werden soll.

Öffentliche Konstruktoren

ClientData(ClientImpl client, int pid)

Generischer Konstruktor.

Öffentliche Methoden

void addFeature(String feature)
void addNativeAllocation(NativeAllocationInfo allocInfo)

fügt dem ClientImpl ein neues NativeAllocationInfo hinzu

void addNativeLibraryMapInfo(long startAddr, long endAddr, String library)
void addThread(int threadId, String threadName)

Fügt der Liste einen neuen Thread hinzu.

void clearHprofData()
void clearNativeAllocationInfo()

Löscht die aktuellen malloc-Informationen.

void clearThreads()
String getAbi()

Gibt die ABI-Variante (32-Bit oder 64-Bit) der Anwendung zurück, „null“, wenn sie unbekannt oder nicht festgelegt ist.

ClientData.AllocationTrackingStatus getAllocationStatus()

Gibt den Status des Zuweisungs-Trackings zurück.

static ClientData.IAllocationTrackingHandler getAllocationTrackingHandler()
AllocationInfo[] getAllocations()

Gibt die Liste der erfassten Zuweisungen zurück.

byte[] getAllocationsData()

Gibt die Rohdaten für erfasste Zuweisungen zurück.

String getClientDescription()

Gibt die Clientbeschreibung zurück.

String getDataDir()

Gibt das Datenverzeichnis der Anwendung zurück.

ClientData.DebuggerStatus getDebuggerConnectionStatus()

Gibt den Status der Debugger-Verbindung zurück.

ClientData.HprofData getHprofData()
static ClientData.IHprofDumpHandler getHprofDumpHandler()
String getJvmFlags()

Gibt die verwendeten VM-Flags oder „null“ zurück, wenn sie unbekannt sind.

getMappedNativeLibraries()

Gibt die Liste der nativen Bibliotheken zurück, die für diesen Client im Speicher zugeordnet sind.

static ClientData.IMethodProfilingHandler getMethodProfilingHandler()
ClientData.MethodProfilingStatus getMethodProfilingStatus()

Gibt den Status der Methodenprofilerstellung zurück.

getNativeAllocationList()

Gibt die Liste der NativeAllocationInfo zurück.

ClientData.HeapData getNativeHeapData()

Gibt das HeapData-Objekt für den nativen Code zurück.

String getPackageName()

Gibt den tatsächlichen Paketnamen der Anwendung zurück, wenn Protokollunterstützung vorhanden ist.

String getPendingHprofDump()

Gibt den Pfad zur HPROF-Datei auf dem Gerät zurück, die geschrieben wird.

String getPendingMethodProfiling()

Gibt den Pfad zur Profiling-Datei der geräteseitigen Methode zurück, die geschrieben wird.

int getPid()

Gibt die Prozess-ID zurück.

ThreadInfo getThread(int threadId)

Gibt die ThreadInfo nach Thread-ID zurück.

ThreadInfo[] getThreads()

Gibt die Liste der Threads als ThreadInfo-Objekte zurück.

int getTotalNativeMemory()

Gibt den gesamten nativen Arbeitsspeicher zurück.

int getUserId()

Gibt die Nutzer-ID des Clients zurück.

ClientData.HeapData getVmHeapData()

Gibt das HeapData-Objekt für die VM zurück.

getVmHeapIds()

Gibt einen Iterator über die Liste der bekannten VM-Heap-IDs zurück.

ClientData.HeapInfo getVmHeapInfo(int heapId)

Gibt die aktuellen Informationswerte für den angegebenen VM-Heap zurück.

String getVmIdentifier()

Gibt die VM-Kennung des Clients zurück.

boolean hasFeature(String feature)

Gibt „true“ zurück, wenn die ClientImpl die angegebene feature unterstützt.

boolean hasPendingHprofDump()
boolean isNativeDebuggable()
boolean isValidUserId()

Gibt „true“ zurück, wenn die Nutzer-ID dieses Clients festgelegt wurde.

void removeThread(int threadId)

Entfernt einen Thread aus der Liste.

void setAbi(String abi)
void setAllocationStatus(ClientData.AllocationTrackingStatus status)
static void setAllocationTrackingHandler(ClientData.IAllocationTrackingHandler handler)

Diese Methode ist veraltet.

void setAllocationsData(byte[] data)
void setDebuggerConnectionStatus(ClientData.DebuggerStatus status)

Legt den Status der Debuggerverbindung fest.

void setHeapInfo(int heapId, long maxSizeInBytes, long sizeInBytes, long bytesAllocated, long objectsAllocated, long timeStamp, byte reason)

Legt die aktuellen Heap-Infowerte für den angegebenen Heap fest.

void setHprofData(String filename)
void setHprofData(byte[] data)
static void setHprofDumpHandler(ClientData.IHprofDumpHandler handler)

Legt den Handler fest, der Benachrichtigungen empfängt, wenn ein HPROF-Dump erfolgreich war oder fehlgeschlagen ist.

void setJvmFlags(String jvmFlags)
static void setMethodProfilingHandler(ClientData.IMethodProfilingHandler handler)

Legt den Handler fest, der Benachrichtigungen empfängt, wenn ein HPROF-Dump erfolgreich war oder fehlgeschlagen ist.

void setMethodProfilingStatus(ClientData.MethodProfilingStatus status)
void setNames(ClientData.Names names)

Legt die Prozess- und Nutzer-ID fest (z.B.

void setNativeDebuggable(boolean nativeDebuggable)
void setPendingHprofDump(String pendingHprofDump)

Legt den geräteseitigen Pfad zur geschriebenen HPROF-Datei fest.

void setPendingMethodProfiling(String pendingMethodProfiling)

Legt den geräteseitigen Pfad zur Methodeprofil-Datei fest, die geschrieben wird.

void setTotalNativeMemory(int totalMemory)
void setVmIdentifier(String ident)

Legt die VM-Kennung fest.

Konstanten

FEATURE_HPROF

public static final String FEATURE_HPROF

String für das Feature, mit dem HPROF-Dateien gedumpt werden können

Weitere Informationen

Konstanter Wert: "hprof-heap-dump"

FEATURE_HPROF_STREAMING

public static final String FEATURE_HPROF_STREAMING

String für die Funktion, die das direkte Streamen von hprof-Dumps ermöglicht

Weitere Informationen

Konstanter Wert: "hprof-heap-dump-streaming"

FEATURE_OPENGL_TRACING

public static final String FEATURE_OPENGL_TRACING

String für das Feature, das die Unterstützung für das Tracing von OpenGL-Aufrufen angibt.

Weitere Informationen

Konstanter Wert: "opengl-tracing"

FEATURE_PROFILING

public static final String FEATURE_PROFILING

String zum Aktivieren/Deaktivieren der Profilerstellung für Start-/Stoppmethoden

Weitere Informationen

Konstanter Wert: "method-trace-profiling"

FEATURE_PROFILING_STREAMING

public static final String FEATURE_PROFILING_STREAMING

String zum Aktivieren des direkten Streamings von Daten zur Methodenprofilerstellung

Weitere Informationen

Constant Value: "method-trace-profiling-streaming"

FEATURE_SAMPLING_PROFILER

public static final String FEATURE_SAMPLING_PROFILER

String zum Aktivieren des Sampling-Profilers.

Weitere Informationen

Konstanter Wert: "method-sample-profiling"

FEATURE_VIEW_HIERARCHY

public static final String FEATURE_VIEW_HIERARCHY

String für das Feature, das die Unterstützung für die Bereitstellung der Ansichtshierarchie angibt.

Weitere Informationen

Konstanter Wert: "view-hierarchy"

PRE_INITIALIZED

public static final String PRE_INITIALIZED

Temporärer Name der VM, die ignoriert werden soll.

Konstanter Wert: "

"

Öffentliche Konstruktoren

ClientData

public ClientData (ClientImpl client, 
                int pid)

Generischer Konstruktor.

Parameter
client ClientImpl

pid int

Öffentliche Methoden

addFeature

public void addFeature (String feature)

Parameter
feature String

addNativeAllocation

public void addNativeAllocation (NativeAllocationInfo allocInfo)

fügt dem ClientImpl ein neues NativeAllocationInfo hinzu

Parameter
allocInfo NativeAllocationInfo: Die hinzuzufügende NativeAllocationInfo.

addNativeLibraryMapInfo

public void addNativeLibraryMapInfo (long startAddr, 
                long endAddr, 
                String library)

Parameter
startAddr long

endAddr long

library String

addThread

public void addThread (int threadId, 
                String threadName)

Fügt der Liste einen neuen Thread hinzu.

Parameter
threadId int

threadName String

clearHprofData

public void clearHprofData ()

clearNativeAllocationInfo

public void clearNativeAllocationInfo ()

Löscht die aktuellen malloc-Informationen.

clearThreads

public void clearThreads ()

getAbi

public String getAbi ()

Gibt die ABI-Variante (32-Bit oder 64-Bit) der Anwendung zurück, „null“, wenn sie unbekannt oder nicht festgelegt ist.

Returns
String

getAllocationStatus

public ClientData.AllocationTrackingStatus getAllocationStatus ()

Gibt den Status des Zuweisungs-Trackings zurück.

Returns
ClientData.AllocationTrackingStatus

Weitere Informationen

getAllocationTrackingHandler

public static ClientData.IAllocationTrackingHandler getAllocationTrackingHandler ()

Returns
ClientData.IAllocationTrackingHandler

getAllocations

public AllocationInfo[] getAllocations ()

Gibt die Liste der erfassten Zuweisungen zurück.

Returns
AllocationInfo[]

getAllocationsData

public byte[] getAllocationsData ()

Gibt die Rohdaten für erfasste Zuweisungen zurück.

Returns
byte[]

getClientDescription

public String getClientDescription ()

Gibt die Clientbeschreibung zurück.

In der Regel ist dies der Name des im AndroidManifest.xml definierten Pakets.

Returns
String die Clientbeschreibung oder null, wenn die Beschreibung noch nicht vom Client gesendet wurde.

getDataDir

public String getDataDir ()

Gibt das Datenverzeichnis der Anwendung zurück.

Returns
String

getDebuggerConnectionStatus

public ClientData.DebuggerStatus getDebuggerConnectionStatus ()

Gibt den Status der Debugger-Verbindung zurück.

Returns
ClientData.DebuggerStatus

getHprofData

public ClientData.HprofData getHprofData ()

Returns
ClientData.HprofData

getHprofDumpHandler

public static ClientData.IHprofDumpHandler getHprofDumpHandler ()

Returns
ClientData.IHprofDumpHandler

getJvmFlags

public String getJvmFlags ()

Gibt die verwendeten VM-Flags oder „null“ zurück, wenn sie unbekannt sind.

Returns
String

getMappedNativeLibraries

public  getMappedNativeLibraries ()

Gibt die Liste der nativen Bibliotheken zurück, die für diesen Client im Speicher zugeordnet sind.

Returns

getMethodProfilingHandler

public static ClientData.IMethodProfilingHandler getMethodProfilingHandler ()

Returns
ClientData.IMethodProfilingHandler

getMethodProfilingStatus

public ClientData.MethodProfilingStatus getMethodProfilingStatus ()

Gibt den Status der Methodenprofilerstellung zurück.

Returns
ClientData.MethodProfilingStatus

getNativeAllocationList

public  getNativeAllocationList ()

Gibt die Liste der NativeAllocationInfo zurück.

Returns

getNativeHeapData

public ClientData.HeapData getNativeHeapData ()

Gibt das HeapData-Objekt für den nativen Code zurück.

Returns
ClientData.HeapData

getPackageName

public String getPackageName ()

Gibt den tatsächlichen Paketnamen der Anwendung zurück, wenn Protokollunterstützung vorhanden ist. Wenn keine Protokollunterstützung vorhanden ist, wird der Versuch zurückgegeben, den Paketnamen aus dem App-Namen abzuleiten (um die Abwärtskompatibilität aufrechtzuerhalten), oder der App-Name, wenn dies nicht gelingt.

Returns
String

getPendingHprofDump

public String getPendingHprofDump ()

Gibt den Pfad zur HPROF-Datei auf dem Gerät zurück, die geschrieben wird.

Returns
String

getPendingMethodProfiling

public String getPendingMethodProfiling ()

Gibt den Pfad zur Profiling-Datei der geräteseitigen Methode zurück, die geschrieben wird.

Returns
String

getPid

public int getPid ()

Gibt die Prozess-ID zurück.

Returns
int

getThread

public ThreadInfo getThread (int threadId)

Gibt die ThreadInfo nach Thread-ID zurück.

Parameter
threadId int

Returns
ThreadInfo

getThreads

public ThreadInfo[] getThreads ()

Gibt die Liste der Threads als ThreadInfo-Objekte zurück.

Die Liste ist leer, bis eine Thread-Aktualisierung mit ClientImpl.requestThreadUpdate() angefordert wurde.

Returns
ThreadInfo[]

getTotalNativeMemory

public int getTotalNativeMemory ()

Gibt den gesamten nativen Arbeitsspeicher zurück.

Returns
int

getUserId

public int getUserId ()

Gibt die Nutzer-ID des Clients zurück.

Returns
int User-ID, falls festgelegt, andernfalls -1

getVmHeapData

public ClientData.HeapData getVmHeapData ()

Gibt das HeapData-Objekt für die VM zurück.

Returns
ClientData.HeapData

getVmHeapIds

public  getVmHeapIds ()

Gibt einen Iterator über die Liste der bekannten VM-Heap-IDs zurück.

Der Aufrufer muss beim Durchlaufen des ClientData-Objekts synchronisieren.

Returns
Ein Iterator über die Liste der Heap-IDs.

getVmHeapInfo

public ClientData.HeapInfo getVmHeapInfo (int heapId)

Gibt die aktuellen Informationswerte für den angegebenen VM-Heap zurück.

Parameter
heapId int: Der Heap, dessen Informationen zurückgegeben werden sollen.
Returns
ClientData.HeapInfo Eine Map mit den Informationswerten für den angegebenen Heap. Gibt null zurück, wenn die Heap-ID unbekannt ist.

getVmIdentifier

public String getVmIdentifier ()

Gibt die VM-ID des Clients zurück.

Returns
String

hasFeature

public boolean hasFeature (String feature)

Gibt „true“ zurück, wenn die ClientImpl die angegebene feature unterstützt.

Parameter
feature String: Das zu testende Feature.
Returns
boolean „true“, wenn die Funktion unterstützt wird

Weitere Informationen

hasPendingHprofDump

public boolean hasPendingHprofDump ()

Returns
boolean

isNativeDebuggable

public boolean isNativeDebuggable ()

Returns
boolean

isValidUserId

public boolean isValidUserId ()

Gibt „true“ zurück, wenn die Nutzer-ID dieses Clients festgelegt wurde. Nur Geräte, die mehrere Nutzer unterstützen, geben die Nutzer-ID an DDMS zurück. Bei anderen/älteren Geräten wird dies nicht festgelegt.

Returns
boolean

removeThread

public void removeThread (int threadId)

Entfernt einen Thread aus der Liste.

Parameter
threadId int

setAbi

public void setAbi (String abi)

Parameter
abi String

setAllocationStatus

public void setAllocationStatus (ClientData.AllocationTrackingStatus status)

Parameter
status ClientData.AllocationTrackingStatus

setAllocationTrackingHandler

public static void setAllocationTrackingHandler (ClientData.IAllocationTrackingHandler handler)

Diese Methode ist veraltet. Bitte registrieren Sie ein AndroidDebugBridge.IClientChangeListener bei AndroidDebugBridge.addClientChangeListener(com.android.tradefed.device.server.AndroidDebugBridge.IClientChangeListener).

Parameter
handler ClientData.IAllocationTrackingHandler

setAllocationsData

public void setAllocationsData (byte[] data)

Parameter
data byte

setDebuggerConnectionStatus

public void setDebuggerConnectionStatus (ClientData.DebuggerStatus status)

Legt den Status der Debuggerverbindung fest.

Parameter
status ClientData.DebuggerStatus

setHeapInfo

public void setHeapInfo (int heapId, 
                long maxSizeInBytes, 
                long sizeInBytes, 
                long bytesAllocated, 
                long objectsAllocated, 
                long timeStamp, 
                byte reason)

Legt die aktuellen Heap-Infowerte für den angegebenen Heap fest.

Parameter
heapId int: Der Heap, dessen Informationen aktualisiert werden sollen
maxSizeInBytes long

sizeInBytes long: Die Größe des Heaps in Byte
bytesAllocated long: Die Anzahl der Byte, die derzeit im Heap zugewiesen sind.
objectsAllocated long: Die Anzahl der Objekte, die derzeit in

setHprofData

public void setHprofData (String filename)

Parameter
filename String

setHprofData

public void setHprofData (byte[] data)

Parameter
data byte

setHprofDumpHandler

public static void setHprofDumpHandler (ClientData.IHprofDumpHandler handler)

Legt den Handler fest, der Benachrichtigungen empfängt, wenn ein HPROF-Dump erfolgreich war oder fehlgeschlagen ist. Diese Methode ist veraltet. Registrieren Sie einen Client-Listener und warten Sie auf CHANGE_HPROF.

Parameter
handler ClientData.IHprofDumpHandler

setJvmFlags

public void setJvmFlags (String jvmFlags)

Parameter
jvmFlags String

setMethodProfilingHandler

public static void setMethodProfilingHandler (ClientData.IMethodProfilingHandler handler)

Legt den Handler fest, der Benachrichtigungen empfängt, wenn ein HPROF-Dump erfolgreich war oder fehlgeschlagen ist. Diese Methode ist veraltet. Registrieren Sie einen Client-Listener und warten Sie auf CHANGE_HPROF.

Parameter
handler ClientData.IMethodProfilingHandler

setMethodProfilingStatus

public void setMethodProfilingStatus (ClientData.MethodProfilingStatus status)

Parameter
status ClientData.MethodProfilingStatus

setNames

public void setNames (ClientData.Names names)

Legt den Prozess, die Nutzer-ID (d.h. privates oder Arbeitsprofil) und die Paketnamen fest.

Es kann zu einem Wettlauf zwischen HELO und APNM kommen. Anstatt die Reihenfolge auf dem Gerät zu erzwingen, lassen wir einfach nicht zu, dass der vorinitialisierte Name einen angegebenen Namen ersetzt.

Parameter
names ClientData.Names

setNativeDebuggable

public void setNativeDebuggable (boolean nativeDebuggable)

Parameter
nativeDebuggable boolean

setPendingHprofDump

public void setPendingHprofDump (String pendingHprofDump)

Legt den geräteseitigen Pfad zur geschriebenen HPROF-Datei fest.

Parameter
pendingHprofDump String: die Datei zur hprof-Datei

setPendingMethodProfiling

public void setPendingMethodProfiling (String pendingMethodProfiling)

Legt den geräteseitigen Pfad zur Methodeprofil-Datei fest, die geschrieben wird.

Parameter
pendingMethodProfiling String: die Datei, in die geschrieben wird

setTotalNativeMemory

public void setTotalNativeMemory (int totalMemory)

Parameter
totalMemory int

setVmIdentifier

public void setVmIdentifier (String ident)

Legt die VM-Kennung fest.

Parameter
ident String