العميل

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

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

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

تعرض هذه السمة منفذ برنامج تصحيح الأخطاء لهذا العميل.

abstract IDevice getDevice()

تعرِض هذه السمة IDevice الذي يتم تشغيل هذا العميل عليه.

abstract boolean isDdmAware()

تعرض القيمة true إذا كان الجهاز الافتراضي للعميل متوافقًا مع "إدارة الأجهزة الديناميكية".

abstract boolean isDebuggerAttached()

تعرض الدالة القيمة true إذا كان هناك مصحّح أخطاء متصل حاليًا بالعميل.

abstract boolean isValid()

تعرض هذه السمة ما إذا كان ClientImpl لديه اتصال صالح بالجهاز الافتراضي للتطبيق.

abstract void kill()

يرسل رسالة إنهاء إلى الجهاز الظاهري.

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

يمكن أن تتوقف عمليات محاكاة الجهاز الافتراضي للمصحّح بدون علم 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

قناع بت لتغيير العميل: تغيير حالة أداة تصحيح الأخطاء

Constant Value: 2 (0x00000002)

CHANGE_HEAP_ALLOCATIONS

public static final int CHANGE_HEAP_ALLOCATIONS

قناع بت لتغيير العميل: تم تعديل معلومات التخصيص

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

قناع بت لتغيير العميل: تغيير علامة تعديل الذاكرة المؤقتة

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

قناع بت لتغيير العميل: تغيير علامة تعديل سلسلة المحادثات

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

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

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

تعرض هذه السمة منفذ برنامج تصحيح الأخطاء لهذا العميل.

المرتجعات
int

getDevice

public abstract IDevice getDevice ()

تعرِض هذه السمة IDevice الذي يتم تشغيل هذا العميل عليه.

المرتجعات
IDevice

isDdmAware

public abstract boolean isDdmAware ()

تعرض القيمة true إذا كان الجهاز الافتراضي للعميل متوافقًا مع "إدارة الأجهزة الديناميكية".

لا يُسمح بإجراء مكالمات هنا إلا بعد إنشاء الاتصال.

المرتجعات
boolean

isDebuggerAttached

public abstract boolean isDebuggerAttached ()

تعرض الدالة القيمة true إذا كان هناك مصحّح أخطاء متصل حاليًا بالعميل.

المرتجعات
boolean

isValid

public abstract boolean isValid ()

تعرض هذه السمة ما إذا كان ClientImpl لديه اتصال صالح بالجهاز الافتراضي للتطبيق.

المرتجعات
boolean

قتل

public abstract void kill ()

يرسل رسالة إنهاء إلى الجهاز الظاهري. قد لا تنجح هذه الطريقة إذا كانت الآلة الافتراضية في حالة تعذُّر التشغيل.

listViewRoots

public abstract void listViewRoots (DebugViewDumpHandler replyHandler)

المعلمات
replyHandler DebugViewDumpHandler

notifyVmMirrorExited

public abstract void notifyVmMirrorExited ()

يمكن أن تتوقف عمليات محاكاة الجهاز الافتراضي للمصحّح بدون علم 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 ()