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

المعالِجات القادرة على التعامل مع عمليات تفريغ 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

الاسم المؤقت للجهاز الظاهري الذي سيتم تجاهله

الإنشاءات العامة

ClientData(ClientImpl client, int pid)

دالة إنشاء عامة.

الطُرق العامة

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()

تعرض هذه السمة نوع واجهة التطبيق الثنائية (32 بت أو 64 بت)، وتعرض القيمة null إذا كان النوع غير معروف أو لم يتم ضبطه.

ClientData.AllocationTrackingStatus getAllocationStatus()

تعرِض هذه السمة حالة تتبُّع عملية التخصيص.

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

تعرض هذه الطريقة قائمة بالمخصصات التي يتم تتبّعها.

byte[] getAllocationsData()

تعرض هذه السمة البيانات الأولية لعمليات التخصيص التي يتم تتبّعها.

String getClientDescription()

تعرض هذه السمة وصف البرنامج.

String getDataDir()

تعرض هذه السمة دليل بيانات التطبيق.

ClientData.DebuggerStatus getDebuggerConnectionStatus()

تعرِض هذه السمة حالة اتصال أداة تصحيح الأخطاء.

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

تعرِض هذه السمة علامات الجهاز الافتراضي المستخدَمة، أو قيمة فارغة إذا كانت غير معروفة.

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 للجهاز الظاهري.

getVmHeapIds()

تعرض هذه الدالة مكرّرًا لقائمة معرّفات الذاكرة المؤقتة المعروفة للجهاز الافتراضي.

ClientData.HeapInfo getVmHeapInfo(int heapId)

تعرض هذه الدالة أحدث قيم المعلومات لمساحة الذاكرة المخصّصة للجهاز الافتراضي المحدّد.

String getVmIdentifier()

تعرض هذه السمة معرّف الجهاز الافتراضي للعميل.

boolean hasFeature(String feature)

تعرض هذه الدالة القيمة "صحيح" إذا كان 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)

تضبط هذه السمة المعالج لتلقّي الإشعارات عند نجاح عملية تفريغ ملف HPROF أو تعذّرها.

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

تضبط هذه السمة المعالج لتلقّي الإشعارات عند نجاح عملية تفريغ ملف HPROF أو تعذّرها.

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

يُرجى الاطّلاع أيضًا على:

Constant Value: "hprof-heap-dump"

FEATURE_HPROF_STREAMING

public static final String FEATURE_HPROF_STREAMING

سلسلة للميزة التي تتيح البث المباشر لعمليات تفريغ hprof

يُرجى الاطّلاع أيضًا على:

Constant Value: "hprof-heap-dump-streaming"

FEATURE_OPENGL_TRACING

public static final String FEATURE_OPENGL_TRACING

سلسلة للميزة تشير إلى إمكانية تتبُّع طلبات OpenGL.

يُرجى الاطّلاع أيضًا على:

Constant Value: "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

سلسلة لتفعيل أداة أخذ العينات من الملفات الشخصية

يُرجى الاطّلاع أيضًا على:

Constant Value: "method-sample-profiling"

FEATURE_VIEW_HIERARCHY

public static final String FEATURE_VIEW_HIERARCHY

سلسلة للميزة تشير إلى إمكانية توفير التسلسل الهرمي للعرض

يُرجى الاطّلاع أيضًا على:

القيمة الثابتة: "view-hierarchy"

PRE_INITIALIZED

public static final String PRE_INITIALIZED

الاسم المؤقت للجهاز الظاهري الذي سيتم تجاهله

Constant Value: "

"

الإنشاءات العامة

ClientData

public ClientData (ClientImpl client, 
                int pid)

دالة إنشاء عامة.

المعلمات
client ClientImpl

pid int

الطُرق العامة

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 ()

تعرض هذه السمة نوع واجهة التطبيق الثنائية (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 ()

تعرِض هذه السمة حالة اتصال أداة تصحيح الأخطاء.

المرتجعات
ClientData.DebuggerStatus

getHprofData

public ClientData.HprofData getHprofData ()

المرتجعات
ClientData.HprofData

getHprofDumpHandler

public static ClientData.IHprofDumpHandler getHprofDumpHandler ()

المرتجعات
ClientData.IHprofDumpHandler

getJvmFlags

public String getJvmFlags ()

تعرِض هذه السمة علامات الجهاز الافتراضي المستخدَمة، أو قيمة فارغة إذا كانت غير معروفة.

المرتجعات
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 للجهاز الظاهري.

المرتجعات
ClientData.HeapData

getVmHeapIds

public  getVmHeapIds ()

تعرض هذه الدالة مكرّرًا لقائمة معرّفات الذاكرة المؤقتة المعروفة للجهاز الافتراضي.

يجب أن تتم المزامنة على العنصر ClientData أثناء التكرار.

المرتجعات
مكرّر على قائمة معرّفات الذاكرة المؤقتة

getVmHeapInfo

public ClientData.HeapInfo getVmHeapInfo (int heapId)

تعرض هذه الدالة أحدث قيم المعلومات لمساحة الذاكرة المخصّصة للجهاز الافتراضي المحدّد.

المعلمات
heapId ‫int: الكومة التي يجب عرض معلوماتها
المرتجعات
ClientData.HeapInfo خريطة تحتوي على قيم المعلومات الخاصة بالكومة المحدّدة تعرِض هذه السمة القيمة null إذا كان معرّف الذاكرة المؤقتة غير معروف.

getVmIdentifier

public String getVmIdentifier ()

تعرض هذه السمة معرّف الجهاز الافتراضي للعميل.

المرتجعات
String

hasFeature

public boolean hasFeature (String feature)

تعرض هذه الدالة القيمة "صحيح" إذا كان ClientImpl يتوافق مع feature المحدّد.

المعلمات
feature ‫String: الميزة التي سيتم اختبارها
المرتجعات
boolean صحيح إذا كانت الميزة متاحة

يُرجى الاطّلاع أيضًا على:

hasPendingHprofDump

public boolean hasPendingHprofDump ()

المرتجعات
boolean

isNativeDebuggable

public boolean isNativeDebuggable ()

المرتجعات
boolean

isValidUserId

public boolean isValidUserId ()

تعرِض القيمة true إذا تم ضبط رقم تعريف المستخدِم لهذا العميل. لن تعرض أرقام تعريف المستخدمين في خدمة "إدارة الأجهزة المتعددة المستخدمين" إلا الأجهزة التي تتيح إمكانية استخدام عدة مستخدمين. لن يتم ضبط هذا الخيار على الأجهزة الأخرى أو القديمة.

المرتجعات
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: عدد وحدات البايت المخصّصة حاليًا في الذاكرة المؤقتة
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)

تضبط هذه السمة المعالج لتلقّي الإشعارات عند نجاح عملية تفريغ ملف HPROF أو تعذّرها. تم إيقاف هذه الطريقة نهائيًا، يُرجى تسجيل أداة معالجة أحداث العميل والاستماع إلى CHANGE_HPROF.

المعلمات
handler ClientData.IHprofDumpHandler

setJvmFlags

public void setJvmFlags (String jvmFlags)

المعلمات
jvmFlags String

setMethodProfilingHandler

public static void setMethodProfilingHandler (ClientData.IMethodProfilingHandler handler)

تضبط هذه السمة المعالج لتلقّي الإشعارات عند نجاح عملية تفريغ ملف HPROF أو تعذّرها. تم إيقاف هذه الطريقة نهائيًا، يُرجى تسجيل أداة معالجة أحداث العميل والاستماع إلى 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