לקוח

public interface Client

com.android.tradefed.device.server.Client

הערך הזה מייצג לקוח יחיד, בדרך כלל תהליך של Dalvik VM.

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

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

סיכום

ערכים קבועים

int CHANGE_DEBUGGER_STATUS

מסכת סיביות של שינוי לקוח: שינוי בסטטוס של מאתר הבאגים

int CHANGE_HEAP_ALLOCATIONS

מסכת סיבי שינוי של לקוח: פרטי ההקצאה עודכנו

int CHANGE_HEAP_ALLOCATION_STATUS

מסכת סיבי שינוי של לקוח: פרטי ההקצאה עודכנו

int CHANGE_HEAP_DATA

מיסוך סיביות של שינוי לקוח: נתוני הכותרת עודכנו

int CHANGE_HEAP_MODE

מסכת סיביות של שינוי לקוח: שינוי בדגל עדכון הערימה

int CHANGE_HPROF

מיסוך סיביות של שינוי לקוח: נתוני hprof עודכנו

int CHANGE_INFO

מיסוך סיביות של שינוי לקוח: שילוב של Client.CHANGE_NAME, CHANGE_DEBUGGER_STATUS ו-Client.CHANGE_PORT.

int CHANGE_METHOD_PROFILING_STATUS

מסכת סיבי שינוי של לקוח: פרטי ההקצאה עודכנו

int CHANGE_NAME

מסכת סיביות לשינוי לקוח: שינוי שם האפליקציה

int CHANGE_NATIVE_HEAP_DATA

מיסוך סיביות של שינוי לקוח: נתוני ערימה מקוריים עודכנו

int CHANGE_PORT

מיסוך סיביות של שינוי לקוח: שינוי יציאת מאתר הבאגים

int CHANGE_THREAD_DATA

מסכת סיביות של שינוי לקוח: נתוני השרשור עודכנו

int CHANGE_THREAD_MODE

מסכת סיבי שינוי של הלקוח: שינוי בדגל עדכון השרשור

int CHANGE_THREAD_STACKTRACE

מסכת סיביות של שינוי לקוח: מעקב אחר מחסנית השרשור עודכן

int SERVER_PROTOCOL_VERSION

‫methods ציבוריים

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)

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

abstract void executeGarbageCollector()

הפקודה מאלצת את הלקוח להפעיל את איסוף האשפה שלו.

abstract ClientData getClientData()

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

abstract int getDebuggerListenPort()

מחזירה את יציאת ה-Debugger של הלקוח הזה.

abstract IDevice getDevice()

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

abstract boolean isDdmAware()

הפונקציה מחזירה את הערך true אם מכונת ה-VM של הלקוח מודעת ל-DDM.

abstract boolean isDebuggerAttached()

הפונקציה מחזירה true אם מאתר הבאגים מחובר כרגע ללקוח.

abstract boolean isValid()

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

abstract void kill()

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

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

מכונות וירטואליות של Debugger יכולות לצאת בלי ידיעת DDMLib, מה שמוביל למצבים שונים של תחרות או אובדן קבוע.Client

abstract void requestAllocationDetails()

שולח בקשה למכונה הווירטואלית לשלוח את המידע על כל ההקצאות שבוצעו מאז הקריאה אל enableAllocationTracker(boolean) עם הערך enable שמוגדר כ-null.

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

ערכים קבועים

CHANGE_DEBUGGER_STATUS

public static final int CHANGE_DEBUGGER_STATUS

מסכת סיביות של שינוי לקוח: שינוי בסטטוס של מאתר הבאגים

ערך קבוע: 2 (0x00000002)

CHANGE_HEAP_ALLOCATIONS

public static final int CHANGE_HEAP_ALLOCATIONS

מסכת סיבי שינוי של לקוח: פרטי ההקצאה עודכנו

ערך קבוע: 512 (0x00000200)

CHANGE_HEAP_ALLOCATION_STATUS

public static final int CHANGE_HEAP_ALLOCATION_STATUS

מסכת סיבי שינוי של לקוח: פרטי ההקצאה עודכנו

ערך קבוע: 1024 (0x00000400)

CHANGE_HEAP_DATA

public static final int CHANGE_HEAP_DATA

מיסוך סיביות של שינוי לקוח: נתוני הכותרת עודכנו

ערך קבוע: 64 (0x00000040)

CHANGE_HEAP_MODE

public static final int CHANGE_HEAP_MODE

מסכת סיביות של שינוי לקוח: שינוי בדגל עדכון הערימה

ערך קבוע: 32 (0x00000020)

CHANGE_HPROF

public static final int CHANGE_HPROF

מיסוך סיביות של שינוי לקוח: נתוני hprof עודכנו

ערך קבוע: 4096 (0x00001000)

CHANGE_INFO

public static final int CHANGE_INFO

מיסוך סיביות של שינוי לקוח: שילוב של Client.CHANGE_NAME, CHANGE_DEBUGGER_STATUS ו-Client.CHANGE_PORT.

ערך קבוע: 7 (0x00000007)

CHANGE_METHOD_PROFILING_STATUS

public static final int CHANGE_METHOD_PROFILING_STATUS

מסכת סיבי שינוי של לקוח: פרטי ההקצאה עודכנו

ערך קבוע: 2048 (0x00000800)

CHANGE_NAME

public static final int CHANGE_NAME

מסכת סיביות לשינוי לקוח: שינוי שם האפליקציה

ערך קבוע: 1 (0x00000001)

CHANGE_NATIVE_HEAP_DATA

public static final int CHANGE_NATIVE_HEAP_DATA

מיסוך סיביות של שינוי לקוח: נתוני ערימה מקוריים עודכנו

ערך קבוע: 128 (0x00000080)

CHANGE_PORT

public static final int CHANGE_PORT

מיסוך סיביות של שינוי לקוח: שינוי יציאת מאתר הבאגים

ערך קבוע: 4 (0x00000004)

CHANGE_THREAD_DATA

public static final int CHANGE_THREAD_DATA

מסכת סיביות של שינוי לקוח: נתוני השרשור עודכנו

ערך קבוע: 16 (0x00000010)

CHANGE_THREAD_MODE

public static final int CHANGE_THREAD_MODE

מסכת סיבי שינוי של הלקוח: שינוי בדגל עדכון השרשור

ערך קבוע: 8 (0x00000008)

CHANGE_THREAD_STACKTRACE

public static final int CHANGE_THREAD_STACKTRACE

מסכת סיביות של שינוי לקוח: מעקב אחר מחסנית השרשור עודכן

ערך קבוע: 256 (0x00000100)

SERVER_PROTOCOL_VERSION

public static final int SERVER_PROTOCOL_VERSION

ערך קבוע: 1 (0x00000001)

‫methods ציבוריים

captureView

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

פרמטרים
viewRoot String

view String

handler DebugViewDumpHandler

dumpDisplayList

public abstract void dumpDisplayList (String viewRoot, 
                String view)

פרמטרים
viewRoot String

view String

dumpViewHierarchy

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

פרמטרים
viewRoot String

skipChildren boolean

includeProperties boolean

useV2 boolean

handler DebugViewDumpHandler

enableAllocationTracker

public abstract void enableAllocationTracker (boolean enabled)

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

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

פרמטרים
enabled boolean

מידע נוסף:

executeGarbageCollector

public abstract void executeGarbageCollector ()

הפקודה מאלצת את הלקוח להפעיל את איסוף האשפה שלו.

getClientData

public abstract ClientData getClientData ()

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

החזרות
ClientData

getDebuggerListenPort

public abstract int getDebuggerListenPort ()

מחזירה את יציאת ה-Debugger של הלקוח הזה.

החזרות
int

getDevice

public abstract IDevice getDevice ()

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

החזרות
IDevice

isDdmAware

public abstract boolean isDdmAware ()

הפונקציה מחזירה את הערך true אם מכונת ה-VM של הלקוח מודעת ל-DDM.

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

החזרות
boolean

isDebuggerAttached

public abstract boolean isDebuggerAttached ()

הפונקציה מחזירה true אם מאתר הבאגים מחובר כרגע ללקוח.

החזרות
boolean

isValid

public abstract boolean isValid ()

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

החזרות
boolean

הריגה

public abstract void kill ()

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

listViewRoots

public abstract void listViewRoots (DebugViewDumpHandler replyHandler)

פרמטרים
replyHandler DebugViewDumpHandler

notifyVmMirrorExited

public abstract void notifyVmMirrorExited ()

מכונות וירטואליות של Debugger יכולות לצאת בלי ידיעת DDMLib, מה שמוביל למצבים שונים של תחרות או אובדן קבוע.Client אנחנו צריכים להודיע ל-DDMLib שהבאג שכרגע מצורף יוצא ומפסיק את חיבור המראה של המכונה הווירטואלית.

requestAllocationDetails

public abstract void requestAllocationDetails ()

שולח בקשה למכונה הווירטואלית לשלוח את המידע על כל ההקצאות שבוצעו מאז הקריאה אל enableAllocationTracker(boolean) עם הערך enable שמוגדר כ-null. הפעולה הזו היא אסינכרונית.

המידע על ההקצאה נגיש לClientData.getAllocations(). ההתראה על כך שהנתונים החדשים זמינים תתקבל דרך AndroidDebugBridge.clientChanged(com.android.tradefed.device.server.ClientImpl, int) עם changeMask שמכיל את המסכה CHANGE_HEAP_ALLOCATIONS.

startMethodTracer

public abstract void startMethodTracer ()

startSamplingProfiler

public abstract void startSamplingProfiler (int samplingInterval, 
                TimeUnit timeUnit)

פרמטרים
samplingInterval int

timeUnit TimeUnit

stopMethodTracer

public abstract void stopMethodTracer ()

stopSamplingProfiler

public abstract void stopSamplingProfiler ()