ClientData

public class ClientData
extends Object

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

מכיל את הנתונים של ClientImpl.

סיכום

כיתות במבנה היררכי

class ClientData.HeapData

מידע על הערימה. 

class ClientData.HeapInfo

 

class ClientData.HprofData

 

interface ClientData.IAllocationTrackingHandler

 

interface ClientData.IHprofDumpHandler

מטפלים שיכולים לפעול על קובצי dump של HPROF. 

interface ClientData.IMethodProfilingHandler

מטפלים שיכולים לפעול על סמך מידע על פרופיל השיטה 

class ClientData.Names

 

ערכים קבועים

String FEATURE_HPROF

מחרוזת לתכונה שמאפשרת ליצור קובצי hprof

String FEATURE_HPROF_STREAMING

מחרוזת לתכונה שמאפשרת סטרימינג ישיר של קובצי hprof

String FEATURE_OPENGL_TRACING

מחרוזת לתכונה שמציינת תמיכה במעקב אחר קריאות OpenGL.

String FEATURE_PROFILING

מחרוזת להפעלת תכונה של יצירת פרופילים של שיטות הפעלה/הפסקה

String FEATURE_PROFILING_STREAMING

מחרוזת להפעלת סטרימינג ישיר של נתוני פרופיל של שיטות

String FEATURE_SAMPLING_PROFILER

מחרוזת להפעלת תכונת הדגימה של פרופיל הביצועים.

String FEATURE_VIEW_HIERARCHY

מחרוזת של תכונה שמציינת תמיכה באספקת היררכיית תצוגה.

String PRE_INITIALIZED

שם זמני של מכונת ה-VM שצריך להתעלם ממנה.

Constructors ציבוריים

ClientData(ClientImpl client, int pid)

‫Constructor גנרי.

‫methods ציבוריים

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

הוספת NativeAllocationInfo חדש ל-ClientImpl

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

הוספת שרשור חדש לרשימה.

void clearHprofData()
void clearNativeAllocationInfo()

ניקוי פרטי ה-malloc הנוכחיים.

void clearThreads()
String getAbi()

הפונקציה מחזירה את סוג ה-ABI (32 ביט או 64 ביט) של האפליקציה, או null אם הסוג לא ידוע או לא מוגדר.

ClientData.AllocationTrackingStatus getAllocationStatus()

הפונקציה מחזירה את סטטוס המעקב של הקצאת המשאבים.

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

מחזירה את רשימת ההקצאות שמתבצע אחריהן מעקב.

byte[] getAllocationsData()

מחזירה את הנתונים הגולמיים של הקצאות שעוקבים אחריהן.

String getClientDescription()

הפונקציה מחזירה את תיאור הלקוח.

String getDataDir()

מחזירה את ספריית הנתונים של האפליקציה.

ClientData.DebuggerStatus getDebuggerConnectionStatus()

הפונקציה מחזירה את סטטוס החיבור של ה-Debugger.

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

הפונקציה מחזירה את הדגלים של המכונה הווירטואלית שנמצאים בשימוש, או null אם לא ידוע.

getMappedNativeLibraries()

מחזירה את רשימת הספריות המקוריות שמופו בזיכרון עבור הלקוח הזה.

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

מחזירה את סטטוס פרופיל השיטה.

getNativeAllocationList()

הפונקציה מחזירה את רשימת NativeAllocationInfo.

ClientData.HeapData getNativeHeapData()

הפונקציה מחזירה את אובייקט HeapData של הקוד המקורי.

String getPackageName()

הפונקציה מחזירה את שם החבילה האמיתי של האפליקציה אם יש תמיכה בפרוטוקול.

String getPendingHprofDump()

מחזירה את הנתיב לקובץ hprof בצד המכשיר שנכתב.

String getPendingMethodProfiling()

הפונקציה מחזירה את הנתיב לקובץ פרופיל השיטה בצד המכשיר שנכתב.

int getPid()

הפונקציה מחזירה את מזהה התהליך.

ThreadInfo getThread(int threadId)

מחזירה את ThreadInfo לפי מזהה השרשור.

ThreadInfo[] getThreads()

מחזירה את רשימת השרשורים כאובייקטים מסוג ThreadInfo.

int getTotalNativeMemory()

מחזירה את הזיכרון המקורי הכולל.

int getUserId()

הפונקציה מחזירה את מזהה המשתמש של הלקוח.

ClientData.HeapData getVmHeapData()

מחזירה את אובייקט HeapData של מכונת ה-VM.

getVmHeapIds()

מחזירה איטרטור על רשימת מזהי הערימה של מכונות וירטואליות ידועות.

ClientData.HeapInfo getVmHeapInfo(int heapId)

הפונקציה מחזירה את ערכי המידע העדכניים ביותר עבור ה-VM heap שצוין.

String getVmIdentifier()

הפונקציה מחזירה את מזהה מכונת ה-VM של הלקוח.

boolean hasFeature(String feature)

הפונקציה מחזירה את הערך true אם ClientImpl תומך ב-feature שצוין

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

מחזירה true אם מזהה המשתמש של הלקוח הזה הוגדר.

void removeThread(int threadId)

הסרת השרשור מהרשימה.

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

השיטה הזו הוצאה משימוש.

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

הפרמטר הזה מגדיר את סטטוס החיבור של מאתר הבאגים.

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

מגדיר את הערכים הנוכחיים של פרטי הערימה עבור הערימה שצוינה.

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

מגדיר את ה-handler לקבלת התראות כש-HPROF dump מצליח או נכשל.

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

הפונקציה מגדירה את ה-handler לקבלת התראות כש-HPROF dump מצליח או נכשל.

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

מגדיר את התהליך, מזהה המשתמש (כלומר

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

ההגדרה מציינת את הנתיב בצד המכשיר לקובץ hprof שנכתב

void setPendingMethodProfiling(String pendingMethodProfiling)

הגדרת הנתיב בצד המכשיר לקובץ פרופיל השיטה שנכתב

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

הגדרת מזהה של מכונה וירטואלית.

ערכים קבועים

FEATURE_HPROF

public static final String FEATURE_HPROF

מחרוזת לתכונה שמאפשרת ליצור קובצי hprof

מידע נוסף:

ערך קבוע: "hprof-heap-dump"

FEATURE_HPROF_STREAMING

public static final String FEATURE_HPROF_STREAMING

מחרוזת לתכונה שמאפשרת סטרימינג ישיר של קובצי hprof

מידע נוסף:

ערך קבוע: "hprof-heap-dump-streaming"

FEATURE_OPENGL_TRACING

public static final String FEATURE_OPENGL_TRACING

מחרוזת לתכונה שמציינת תמיכה במעקב אחר קריאות OpenGL.

מידע נוסף:

ערך קבוע: "opengl-tracing"

FEATURE_PROFILING

public static final String FEATURE_PROFILING

מחרוזת להפעלת תכונה של יצירת פרופילים של שיטות הפעלה/הפסקה

מידע נוסף:

ערך קבוע: "method-trace-profiling"

FEATURE_PROFILING_STREAMING

public static final String FEATURE_PROFILING_STREAMING

מחרוזת להפעלת סטרימינג ישיר של נתוני פרופיל של שיטות

מידע נוסף:

ערך קבוע: "method-trace-profiling-streaming"

FEATURE_SAMPLING_PROFILER

public static final String FEATURE_SAMPLING_PROFILER

מחרוזת להפעלת תכונת הדגימה של פרופיל הביצועים.

מידע נוסף:

ערך קבוע: "method-sample-profiling"

FEATURE_VIEW_HIERARCHY

public static final String FEATURE_VIEW_HIERARCHY

מחרוזת של תכונה שמציינת תמיכה באספקת היררכיית תצוגה.

מידע נוסף:

ערך קבוע: "view-hierarchy"

PRE_INITIALIZED

public static final String PRE_INITIALIZED

שם זמני של מכונת ה-VM שצריך להתעלם ממנה.

ערך קבוע: "

"

Constructors ציבוריים

ClientData

public ClientData (ClientImpl client, 
                int pid)

‫Constructor גנרי.

פרמטרים
client ClientImpl

pid int

‫methods ציבוריים

addFeature

public void addFeature (String feature)

פרמטרים
feature String

addNativeAllocation

public void addNativeAllocation (NativeAllocationInfo allocInfo)

הוספת NativeAllocationInfo חדש ל-ClientImpl

פרמטרים
allocInfo ‫NativeAllocationInfo: NativeAllocationInfo שרוצים להוסיף.

addNativeLibraryMapInfo

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

פרמטרים
startAddr long

endAddr long

library String

addThread

public void addThread (int threadId, 
                String threadName)

הוספת שרשור חדש לרשימה.

פרמטרים
threadId int

threadName String

clearHprofData

public void clearHprofData ()

clearNativeAllocationInfo

public void clearNativeAllocationInfo ()

ניקוי פרטי ה-malloc הנוכחיים.

clearThreads

public void clearThreads ()

getAbi

public String getAbi ()

הפונקציה מחזירה את סוג ה-ABI (32 ביט או 64 ביט) של האפליקציה, או null אם הסוג לא ידוע או לא מוגדר.

החזרות
String

getAllocationStatus

public ClientData.AllocationTrackingStatus getAllocationStatus ()

הפונקציה מחזירה את סטטוס המעקב אחר הקצאת נפח תנועה.

החזרות
ClientData.AllocationTrackingStatus

getAllocationTrackingHandler

public static ClientData.IAllocationTrackingHandler getAllocationTrackingHandler ()

החזרות
ClientData.IAllocationTrackingHandler

getAllocations

public AllocationInfo[] getAllocations ()

מחזירה את רשימת ההקצאות שמתבצע אחריהן מעקב.

החזרות
AllocationInfo[]

getAllocationsData

public byte[] getAllocationsData ()

מחזירה את הנתונים הגולמיים של הקצאות שעוקבים אחריהן.

החזרות
byte[]

getClientDescription

public String getClientDescription ()

הפונקציה מחזירה את תיאור הלקוח.

בדרך כלל זה השם של החבילה שמוגדרת ב-AndroidManifest.xml.

החזרות
String תיאור הלקוח או null אם התיאור עדיין לא נשלח על ידי הלקוח.

getDataDir

public String getDataDir ()

מחזירה את ספריית הנתונים של האפליקציה.

החזרות
String

getDebuggerConnectionStatus

public ClientData.DebuggerStatus getDebuggerConnectionStatus ()

הפונקציה מחזירה את סטטוס החיבור של ה-Debugger.

החזרות
ClientData.DebuggerStatus

getHprofData

public ClientData.HprofData getHprofData ()

החזרות
ClientData.HprofData

getHprofDumpHandler

public static ClientData.IHprofDumpHandler getHprofDumpHandler ()

החזרות
ClientData.IHprofDumpHandler

getJvmFlags

public String getJvmFlags ()

הפונקציה מחזירה את הדגלים של המכונה הווירטואלית שנמצאים בשימוש, או null אם לא ידוע.

החזרות
String

getMappedNativeLibraries

public  getMappedNativeLibraries ()

מחזירה את רשימת הספריות המקוריות שמופו בזיכרון עבור הלקוח הזה.

החזרות

getMethodProfilingHandler

public static ClientData.IMethodProfilingHandler getMethodProfilingHandler ()

החזרות
ClientData.IMethodProfilingHandler

getMethodProfilingStatus

public ClientData.MethodProfilingStatus getMethodProfilingStatus ()

מחזירה את סטטוס פרופיל השיטה.

החזרות
ClientData.MethodProfilingStatus

getNativeAllocationList

public  getNativeAllocationList ()

הפונקציה מחזירה את רשימת NativeAllocationInfo.

החזרות

getNativeHeapData

public ClientData.HeapData getNativeHeapData ()

הפונקציה מחזירה את אובייקט HeapData של הקוד המקורי.

החזרות
ClientData.HeapData

getPackageName

public String getPackageName ()

הפונקציה מחזירה את שם החבילה האמיתי של האפליקציה אם יש תמיכה בפרוטוקול. אם אין תמיכה בפרוטוקול, הפונקציה מחזירה את הניסיון לגזור את שם החבילה משם האפליקציה (כדי לשמור על תאימות לאחור), או את שם האפליקציה אם הניסיון לא הצליח.

החזרות
String

getPendingHprofDump

public String getPendingHprofDump ()

מחזירה את הנתיב לקובץ hprof בצד המכשיר שנכתב.

החזרות
String

getPendingMethodProfiling

public String getPendingMethodProfiling ()

הפונקציה מחזירה את הנתיב לקובץ פרופיל השיטה בצד המכשיר שנכתב.

החזרות
String

getPid

public int getPid ()

הפונקציה מחזירה את מזהה התהליך.

החזרות
int

getThread

public ThreadInfo getThread (int threadId)

מחזירה את ThreadInfo לפי מזהה השרשור.

פרמטרים
threadId int

החזרות
ThreadInfo

getThreads

public ThreadInfo[] getThreads ()

מחזירה את רשימת השרשורים כאובייקטים מסוג ThreadInfo.

הרשימה ריקה עד שמבקשים לעדכן את השרשור באמצעות ClientImpl.requestThreadUpdate().

החזרות
ThreadInfo[]

getTotalNativeMemory

public int getTotalNativeMemory ()

מחזירה את הזיכרון המקורי הכולל.

החזרות
int

getUserId

public int getUserId ()

הפונקציה מחזירה את מזהה המשתמש של הלקוח.

החזרות
int מזהה משתמש אם הוא מוגדר, אחרת -1

getVmHeapData

public ClientData.HeapData getVmHeapData ()

מחזירה את אובייקט HeapData של מכונת ה-VM.

החזרות
ClientData.HeapData

getVmHeapIds

public  getVmHeapIds ()

מחזירה איטרטור על רשימת מזהי הערימה של מכונות וירטואליות ידועות.

המבצע צריך לבצע סנכרון באובייקט ClientData במהלך האיטרציה.

החזרות
איטרטור על רשימת מזהי הערימה

getVmHeapInfo

public ClientData.HeapInfo getVmHeapInfo (int heapId)

הפונקציה מחזירה את ערכי המידע העדכניים ביותר עבור ה-VM heap שצוין.

פרמטרים
heapId ‫int: הערימה (heap) שאת המידע שלה רוצים להחזיר
החזרות
ClientData.HeapInfo מפה שמכילה את ערכי המידע עבור הערימה שצוינה. הפונקציה מחזירה את הערך null אם מזהה הערימה לא ידוע.

getVmIdentifier

public String getVmIdentifier ()

הפונקציה מחזירה את מזהה ה-VM של הלקוח.

החזרות
String

hasFeature

public boolean hasFeature (String feature)

הפונקציה מחזירה את הערך true אם ClientImpl תומך ב-feature שצוין

פרמטרים
feature ‫String: התכונה שרוצים לבדוק.
החזרות
boolean true אם התכונה נתמכת

מידע נוסף:

hasPendingHprofDump

public boolean hasPendingHprofDump ()

החזרות
boolean

isNativeDebuggable

public boolean isNativeDebuggable ()

החזרות
boolean

isValidUserId

public boolean isValidUserId ()

מחזירה true אם מזהה המשתמש של הלקוח הזה הוגדר. רק מכשירים שתומכים במספר משתמשים יחזירו בפועל את מזהה המשתמש ל-ddms. במכשירים אחרים או ישנים יותר, ההגדרה הזו לא תוגדר.

החזרות
boolean

removeThread

public void removeThread (int threadId)

הסרת השרשור מהרשימה.

פרמטרים
threadId int

setAbi

public void setAbi (String abi)

פרמטרים
abi String

setAllocationStatus

public void setAllocationStatus (ClientData.AllocationTrackingStatus status)

פרמטרים
status ClientData.AllocationTrackingStatus

setAllocationTrackingHandler

public static void setAllocationTrackingHandler (ClientData.IAllocationTrackingHandler handler)

השיטה הזו הוצאה משימוש. עליך לרשום חשבון AndroidDebugBridge.IClientChangeListener ב-AndroidDebugBridge.addClientChangeListener(com.android.tradefed.device.server.AndroidDebugBridge.IClientChangeListener)

פרמטרים
handler ClientData.IAllocationTrackingHandler

setAllocationsData

public void setAllocationsData (byte[] data)

פרמטרים
data byte

setDebuggerConnectionStatus

public void setDebuggerConnectionStatus (ClientData.DebuggerStatus status)

הפרמטר הזה מגדיר את סטטוס החיבור של מאתר הבאגים.

פרמטרים
status ClientData.DebuggerStatus

setHeapInfo

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

מגדיר את הערכים הנוכחיים של פרטי הערימה עבור הערימה שצוינה.

פרמטרים
heapId ‫int: הערימה שרוצים לעדכן את המידע שלה
maxSizeInBytes long

sizeInBytes ‫long: גודל הערימה בבייטים
bytesAllocated ‫long: מספר הבייטים שהוקצו כרגע ב-heap
objectsAllocated ‫long: מספר האובייקטים שהוקצו כרגע ב

setHprofData

public void setHprofData (String filename)

פרמטרים
filename String

setHprofData

public void setHprofData (byte[] data)

פרמטרים
data byte

setHprofDumpHandler

public static void setHprofDumpHandler (ClientData.IHprofDumpHandler handler)

מגדיר את ה-handler לקבלת התראות כש-HPROF dump מצליח או נכשל. השיטה הזו הוצאה משימוש. צריך לרשום מאזין לקוח ולהאזין ל-CHANGE_HPROF.

פרמטרים
handler ClientData.IHprofDumpHandler

setJvmFlags

public void setJvmFlags (String jvmFlags)

פרמטרים
jvmFlags String

setMethodProfilingHandler

public static void setMethodProfilingHandler (ClientData.IMethodProfilingHandler handler)

מגדיר את ה-handler לקבלת התראות כש-HPROF dump מצליח או נכשל. השיטה הזו הוצאה משימוש. צריך לרשום מאזין לקוח ולהאזין ל-CHANGE_HPROF.

פרמטרים
handler ClientData.IMethodProfilingHandler

setMethodProfilingStatus

public void setMethodProfilingStatus (ClientData.MethodProfilingStatus status)

פרמטרים
status ClientData.MethodProfilingStatus

setNames

public void setNames (ClientData.Names names)

ההגדרה קובעת את התהליך, מזהה המשתמש (כלומר, פרופיל אישי לעומת פרופיל עבודה) ושמות החבילות.

יכול להיות שיהיה מירוץ בין HELO לבין APNM. במקום לנסות לאכוף את הסדר במכשיר, אנחנו פשוט לא מאפשרים לשם שמוגדר מראש להחליף שם שצוין.

פרמטרים
names ClientData.Names

setNativeDebuggable

public void setNativeDebuggable (boolean nativeDebuggable)

פרמטרים
nativeDebuggable boolean

setPendingHprofDump

public void setPendingHprofDump (String pendingHprofDump)

ההגדרה מציינת את הנתיב בצד המכשיר לקובץ hprof שנכתב

פרמטרים
pendingHprofDump String: הקובץ לקובץ hprof

setPendingMethodProfiling

public void setPendingMethodProfiling (String pendingMethodProfiling)

הגדרה של הנתיב בצד המכשיר לקובץ פרופיל השיטה שנכתב

פרמטרים
pendingMethodProfiling ‫String: הקובץ שנכתב

setTotalNativeMemory

public void setTotalNativeMemory (int totalMemory)

פרמטרים
totalMemory int

setVmIdentifier

public void setVmIdentifier (String ident)

הגדרת מזהה של מכונה וירטואלית.

פרמטרים
ident String