مشتری

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

کلاینت را مجبور می‌کند تا garbage collector خود را اجرا کند.

abstract ClientData getClientData ()

شیء ClientData حاوی اطلاعات این کلاینت را برمی‌گرداند.

abstract int getDebuggerListenPort ()

پورت اشکال‌زدا را برای این کلاینت برمی‌گرداند.

abstract IDevice getDevice ()

IDevice که این کلاینت روی آن در حال اجرا است را برمی‌گرداند.

abstract boolean isDdmAware ()

اگر ماشین مجازی کلاینت از DDM آگاه باشد، true را برمی‌گرداند.

abstract boolean isDebuggerAttached ()

اگر یک اشکال‌زدا در حال حاضر به کلاینت متصل باشد، true را برمی‌گرداند.

abstract boolean isValid ()

برمی‌گرداند که آیا این ClientImpl اتصال معتبری به ماشین مجازی برنامه دارد یا خیر.

abstract void kill ()

یک پیام kill به ماشین مجازی ارسال می‌کند.

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

آینه‌های ماشین مجازی اشکال‌زدا می‌توانند پشت سر DDMLib خارج شوند و منجر به شرایط مختلف از دست دادن Client رقابتی یا دائمی شوند.

abstract void requestAllocationDetails ()

درخواستی را به ماشین مجازی ارسال می‌کند تا اطلاعات مربوط به تمام تخصیص‌هایی که از زمان فراخوانی enableAllocationTracker(boolean) با مقدار null برای enable رخ داده است، ارسال شود.

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

ثابت‌ها

تغییر وضعیت اشکال‌زدا 

public static final int CHANGE_DEBUGGER_STATUS

تغییر ماسک بیت کلاینت: تغییر وضعیت اشکال‌زدا

مقدار ثابت: ۲ (۰x۰۰۰۰۰۰۲)

تغییر تخصیص‌های هیپ 

public static final int CHANGE_HEAP_ALLOCATIONS

تغییر ماسک بیت کلاینت: اطلاعات تخصیص به‌روزرسانی شد

مقدار ثابت: ۵۱۲ (۰x۰۰۰۰۰۲۰۰)

تغییر وضعیت تخصیص حافظه 

public static final int CHANGE_HEAP_ALLOCATION_STATUS

تغییر ماسک بیت کلاینت: اطلاعات تخصیص به‌روزرسانی شد

مقدار ثابت: ۱۰۲۴ (۰x۰۰۰۰۰۴۰۰)

تغییر_داده‌های_هپ 

public static final int CHANGE_HEAP_DATA

تغییر ماسک بیت کلاینت: داده‌های هد به‌روزرسانی شدند

مقدار ثابت: ۶۴ (۰x۰۰۰۰۰۴۰)

تغییر حالت حافظه 

public static final int CHANGE_HEAP_MODE

تغییر ماسک بیت کلاینت: تغییر پرچم به‌روزرسانی هیپ

مقدار ثابت: ۳۲ (۰x۰۰۰۰۰۲۰)

تغییر_HPROF 

public static final int CHANGE_HPROF

تغییر ماسک بیت کلاینت: داده‌های hprof به‌روزرسانی شد

مقدار ثابت: ۴۰۹۶ (۰x۰۰۰۰۱۰۰۰)

اطلاعات تغییر 

public static final int CHANGE_INFO

ماسک بیت تغییر کلاینت: ترکیبی از Client.CHANGE_NAME ، CHANGE_DEBUGGER_STATUS و Client.CHANGE_PORT .

مقدار ثابت: ۷ (۰x۰۰۰۰۰۰۷)

تغییر_روش_پروفایل_وضعیت 

public static final int CHANGE_METHOD_PROFILING_STATUS

تغییر ماسک بیت کلاینت: اطلاعات تخصیص به‌روزرسانی شد

مقدار ثابت: 2048 (0x00000800)

تغییر_نام 

public static final int CHANGE_NAME

تغییر ماسک بیت کلاینت: تغییر نام برنامه

مقدار ثابت: ۱ (۰x۰۰۰۰۰۰۱)

تغییر داده‌های اصلی هیپ 

public static final int CHANGE_NATIVE_HEAP_DATA

تغییر ماسک بیت کلاینت: داده‌های هیپ بومی به‌روزرسانی شدند

مقدار ثابت: ۱۲۸ (۰x۰۰۰۰۰۸۰)

تغییر_پورت 

public static final int CHANGE_PORT

تغییر ماسک بیت کلاینت: تغییر پورت دیباگر

مقدار ثابت: ۴ (۰x۰۰۰۰۰۰۴)

تغییر_داده_موضوع 

public static final int CHANGE_THREAD_DATA

ماسک بیت تغییر کلاینت: داده‌های رشته به‌روزرسانی شد

مقدار ثابت: ۱۶ (۰x۰۰۰۰۰۱۰)

تغییر حالت نخ 

public static final int CHANGE_THREAD_MODE

تغییر ماسک بیت کلاینت: تغییر پرچم به‌روزرسانی نخ

مقدار ثابت: ۸ (۰x۰۰۰۰۰۰۸)

تغییر_رشته_پشته_ردیابی 

public static final int CHANGE_THREAD_STACKTRACE

ماسک بیت تغییر کلاینت: ردیابی پشته نخ به‌روزرسانی شد

مقدار ثابت: ۲۵۶ (۰x۰۰۰۰۰۱۰۰)

نسخه پروتکل سرور 

public static final int SERVER_PROTOCOL_VERSION

مقدار ثابت: ۱ (۰x۰۰۰۰۰۰۱)

روش‌های عمومی

ضبط ویو 

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

سلسله مراتب dumpView 

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

همچنین ببینید:

اجرای GarbageCollector 

public abstract void executeGarbageCollector ()

کلاینت را مجبور می‌کند تا garbage collector خود را اجرا کند.

دریافت داده‌های کلاینت 

public abstract ClientData getClientData ()

شیء ClientData حاوی اطلاعات این کلاینت را برمی‌گرداند.

بازگشت‌ها
ClientData

اشکال‌زدا دریافت کنید 

public abstract int getDebuggerListenPort ()

پورت اشکال‌زدا را برای این کلاینت برمی‌گرداند.

بازگشت‌ها
int

دریافت دستگاه 

public abstract IDevice getDevice ()

IDevice که این کلاینت روی آن در حال اجرا است را برمی‌گرداند.

بازگشت‌ها
IDevice

isDdmAware 

public abstract boolean isDdmAware ()

اگر ماشین مجازی کلاینت از DDM آگاه باشد، true را برمی‌گرداند.

تماس در اینجا فقط پس از برقراری اتصال مجاز است.

بازگشت‌ها
boolean

isDebugger پیوست شده است 

public abstract boolean isDebuggerAttached ()

اگر یک اشکال‌زدا در حال حاضر به کلاینت متصل باشد، true را برمی‌گرداند.

بازگشت‌ها
boolean

معتبر است 

public abstract boolean isValid ()

برمی‌گرداند که آیا این ClientImpl اتصال معتبری به ماشین مجازی برنامه دارد یا خیر.

بازگشت‌ها
boolean

کشتن 

public abstract void kill ()

یک پیام kill به ماشین مجازی ارسال می‌کند. اگر ماشین مجازی در حالت crash باشد، این لزوماً کار نمی‌کند.

ریشه‌های نمایش لیست 

public abstract void listViewRoots (DebugViewDumpHandler replyHandler)

پارامترها
replyHandler DebugViewDumpHandler

notifyVmMirrorخروج 

public abstract void notifyVmMirrorExited ()

آینه‌های ماشین مجازی اشکال‌زدا می‌توانند پشت سر DDMLib خارج شوند و منجر به شرایط مختلف از دست دادن Client رقابتی یا دائمی شوند. ما باید به DDMLib اطلاع دهیم که اشکال‌زدا که در حال حاضر متصل است در حال خروج است و اتصال آینه ماشین مجازی خود را از بین می‌برد.

جزئیات درخواست تخصیص 

public abstract void requestAllocationDetails ()

درخواستی را به ماشین مجازی ارسال می‌کند تا اطلاعات مربوط به تمام تخصیص‌هایی که از زمان فراخوانی enableAllocationTracker(boolean) با مقدار null برای enable رخ داده است را ارسال کند. این کار به صورت غیرهمزمان انجام می‌شود.

اطلاعات تخصیص داده می‌تواند توسط ClientData.getAllocations() قابل دسترسی باشد. اعلان مربوط به در دسترس بودن داده‌های جدید از طریق AndroidDebugBridge.clientChanged(com.android.tradefed.device.server.ClientImpl, int) با changeMask حاوی ماسک CHANGE_HEAP_ALLOCATIONS دریافت خواهد شد.

شروعMethodTracer 

public abstract void startMethodTracer ()

شروع نمونه‌برداری پروفایلر 

public abstract void startSamplingProfiler (int samplingInterval, 
                TimeUnit timeUnit)

پارامترها
samplingInterval int

timeUnit TimeUnit

stopMethodTracer 

public abstract void stopMethodTracer ()

stopSamplingProfiler 

public abstract void stopSamplingProfiler ()