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

public class ClientData
extends 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 dumps را فراهم می‌کند.

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

نوع معماری برنامه (۳۲ بیتی یا ۶۴ بیتی) را برمی‌گرداند، در صورت عدم شناسایی یا تنظیم نشدن، 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 ()

پرچم‌های ماشین مجازی مورد استفاده را برمی‌گرداند، یا در صورت ناشناخته بودن، 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 را برای ماشین مجازی برمی‌گرداند.

getVmHeapIds ()

یک تکرارکننده (iterator) را بر روی لیست شناسه‌های شناخته‌شده‌ی پشته‌های ماشین مجازی برمی‌گرداند.

ClientData.HeapInfo getVmHeapInfo (int heapId)

جدیدترین مقادیر اطلاعات را برای هیپ ماشین مجازی مشخص شده برمی‌گرداند.

String getVmIdentifier ()

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

boolean hasFeature (String feature)

اگر ClientImpl از feature داده شده پشتیبانی کند، مقدار true را برمی‌گرداند.

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)

شناسه ماشین مجازی را تنظیم می‌کند.

ثابت‌ها

ویژگی_HPROF 

public static final String FEATURE_HPROF

رشته‌ای برای ویژگی که امکان کپی کردن فایل‌های hprof را فراهم می‌کند

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

مقدار ثابت: "hprof-heap-dump"

پخش زنده ویژه HPROF 

public static final String FEATURE_HPROF_STREAMING

رشته‌ای برای ویژگی که امکان پخش مستقیم فایل‌های hprof dumps را فراهم می‌کند.

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

مقدار ثابت: "hprof-heap-dump-streaming"

ردیابی ویژگی باز 

public static final String FEATURE_OPENGL_TRACING

رشته‌ای برای ویژگی که نشان‌دهنده‌ی پشتیبانی از ردیابی فراخوانی‌های OpenGL است.

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

مقدار ثابت: "opengl-tracing"

نمایه‌سازی ویژگی‌ها 

public static final String FEATURE_PROFILING

رشته‌ای برای ویژگی فعال‌سازی شروع/توقف پروفایلینگ متد

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

مقدار ثابت: "method-trace-profiling"

پخش زنده با پروفایل ویژه 

public static final String FEATURE_PROFILING_STREAMING

رشته‌ای برای ویژگی که امکان پخش مستقیم داده‌های پروفایلینگ متد را فراهم می‌کند.

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

مقدار ثابت: "method-trace-profiling-streaming"

نمایه‌ساز نمونه‌برداری ویژگی 

public static final String FEATURE_SAMPLING_PROFILER

رشته‌ای برای ابزار نمونه‌برداری که امکان نمونه‌برداری را فراهم می‌کند.

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

مقدار ثابت: "روش-نمونه-پروفایلینگ"

نمای_ویژگی_سلسله مراتب 

public static final String FEATURE_VIEW_HIERARCHY

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

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

مقدار ثابت: "سلسله مراتب نما"

از پیش مقداردهی اولیه شده 

public static final String PRE_INITIALIZED

نام موقت ماشین مجازی نادیده گرفته می‌شود.

مقدار ثابت: "

«

سازندگان عمومی

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

public ClientData (ClientImpl client, 
                int pid)

سازنده عمومی.

پارامترها
client ClientImpl

pid int

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

ویژگی اضافه کنید 

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

اضافه کردن موضوع 

public void addThread (int threadId, 
                String threadName)

یک رشته جدید به لیست اضافه می‌کند.

پارامترها
threadId int

threadName String

clearHprofData 

public void clearHprofData ()

clearNativeAllocationInfo 

public void clearNativeAllocationInfo ()

اطلاعات malloc فعلی را پاک کنید.

clearThreads 

public void clearThreads ()

دریافت ابی 

public String getAbi ()

نوع معماری برنامه (۳۲ بیتی یا ۶۴ بیتی) را برمی‌گرداند، در صورت عدم شناسایی یا تنظیم نشدن، null برمی‌گرداند.

بازگشت‌ها
String

وضعیت تخصیص را دریافت کنید 

public ClientData.AllocationTrackingStatus getAllocationStatus ()

وضعیت ردیابی تخصیص را برمی‌گرداند.

بازگشت‌ها
ClientData.AllocationTrackingStatus

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

getAllocationTrackingHandler 

public static ClientData.IAllocationTrackingHandler getAllocationTrackingHandler ()

بازگشت‌ها
ClientData.IAllocationTrackingHandler

دریافت تخصیص‌ها 

public AllocationInfo[] getAllocations ()

لیست تخصیص‌های ردیابی‌شده را برمی‌گرداند.

بازگشت‌ها
AllocationInfo[]

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

دریافت داده‌های تخصیصی 

public byte[] getAllocationsData ()

داده‌های خام مربوط به تخصیص‌های ردیابی‌شده را برمی‌گرداند.

بازگشت‌ها
byte[]

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

دریافت توضیحات مشتری 

public String getClientDescription ()

توضیحات کلاینت را برمی‌گرداند.

این معمولاً نام پکیجی است که در AndroidManifest.xml تعریف شده است.

بازگشت‌ها
String توضیحات کلاینت یا اگر نه null ، یعنی هنوز توضیحات توسط کلاینت ارسال نشده است.

دریافت داده 

public String getDataDir ()

دایرکتوری داده‌های برنامه را برمی‌گرداند.

بازگشت‌ها
String

وضعیت اتصال getDebugger 

public ClientData.DebuggerStatus getDebuggerConnectionStatus ()

وضعیت اتصال دیباگر را برمی‌گرداند.

بازگشت‌ها
ClientData.DebuggerStatus

دریافتHprofData 

public ClientData.HprofData getHprofData ()

بازگشت‌ها
ClientData.HprofData

getHprofDumpHandler 

public static ClientData.IHprofDumpHandler getHprofDumpHandler ()

بازگشت‌ها
ClientData.IHprofDumpHandler

پرچم‌های دریافت‌شده 

public String getJvmFlags ()

پرچم‌های ماشین مجازی مورد استفاده را برمی‌گرداند، یا در صورت ناشناخته بودن، null را برمی‌گرداند.

بازگشت‌ها
String

کتابخانه‌های بومیِ دریافت‌شده 

public  getMappedNativeLibraries ()

لیستی از کتابخانه‌های بومی نگاشت شده در حافظه برای این کلاینت را برمی‌گرداند.

بازگشت‌ها

getMethodProfilingHandler 

public static ClientData.IMethodProfilingHandler getMethodProfilingHandler ()

بازگشت‌ها
ClientData.IMethodProfilingHandler

دریافتمتدپروفایلینگوضعیت 

public ClientData.MethodProfilingStatus getMethodProfilingStatus ()

وضعیت پروفایلینگ متد را برمی‌گرداند.

بازگشت‌ها
ClientData.MethodProfilingStatus

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

getNativeAllocationList 

public  getNativeAllocationList ()

لیست NativeAllocationInfo را برمی‌گرداند.

بازگشت‌ها

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

دریافت داده‌های بومی HeapData 

public ClientData.HeapData getNativeHeapData ()

شیء HeapData را برای کد اصلی برمی‌گرداند.

بازگشت‌ها
ClientData.HeapData

دریافت نام بسته 

public String getPackageName ()

در صورت وجود پشتیبانی پروتکل، نام بسته‌ی واقعی برنامه را برمی‌گرداند. در صورت عدم پشتیبانی پروتکل، تلاش برای مشتق کردن نام بسته از نام برنامه (برای حفظ سازگاری معکوس) یا در صورت عدم موفقیت، نام برنامه را برمی‌گرداند.

بازگشت‌ها
String

دریافت در انتظار HprofDump 

public String getPendingHprofDump ()

مسیر فایل hprof سمت دستگاه که در حال نوشته شدن است را برمی‌گرداند.

بازگشت‌ها
String

پروفایلینگ getPendingMethod 

public String getPendingMethodProfiling ()

مسیر فایل پروفایلینگ متد سمت دستگاه که در حال نوشته شدن است را برمی‌گرداند.

بازگشت‌ها
String

دریافت پید 

public int getPid ()

شناسه فرآیند را برمی‌گرداند.

بازگشت‌ها
int

دریافت موضوع 

public ThreadInfo getThread (int threadId)

ThreadInfo را بر اساس شناسه‌ی رشته برمی‌گرداند.

پارامترها
threadId int

بازگشت‌ها
ThreadInfo

دریافت رشته‌ها 

public ThreadInfo[] getThreads ()

لیست رشته‌ها را به عنوان اشیاء ThreadInfo برمی‌گرداند.

این لیست تا زمانی که به‌روزرسانی نخ با ClientImpl.requestThreadUpdate() درخواست نشده باشد، خالی است.

بازگشت‌ها
ThreadInfo[]

دریافت TotalNativeMemory 

public int getTotalNativeMemory ()

کل حافظه اصلی را برمی‌گرداند.

بازگشت‌ها
int

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

دریافت شناسه کاربری 

public int getUserId ()

شناسه کاربری کلاینت را برمی‌گرداند.

بازگشت‌ها
int شناسه کاربر در صورت تنظیم، -1 در غیر این صورت

دریافت VmHeapData 

public ClientData.HeapData getVmHeapData ()

شیء HeapData را برای ماشین مجازی برمی‌گرداند.

بازگشت‌ها
ClientData.HeapData

دریافت VmHeapIds 

public  getVmHeapIds ()

یک تکرارکننده (iterator) را بر روی لیست شناسه‌های شناخته‌شده‌ی پشته‌های ماشین مجازی برمی‌گرداند.

فراخواننده باید هنگام تکرار، شیء ClientData را همگام‌سازی کند.

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

اطلاعات مربوط به VmHeap 

public ClientData.HeapInfo getVmHeapInfo (int heapId)

جدیدترین مقادیر اطلاعات را برای هیپ ماشین مجازی مشخص شده برمی‌گرداند.

پارامترها
heapId int : هیپی که اطلاعات آن باید برگردانده شود

بازگشت‌ها
ClientData.HeapInfo یک نقشه حاوی مقادیر اطلاعات برای هیپ مشخص شده. اگر شناسه هیپ ناشناخته باشد، null را برمی‌گرداند.

دریافت شناسه Vm 

public String getVmIdentifier ()

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

بازگشت‌ها
String

دارایویژگی 

public boolean hasFeature (String feature)

اگر ClientImpl از feature داده شده پشتیبانی کند، مقدار true را برمی‌گرداند.

پارامترها
feature String : ویژگی مورد نظر برای آزمایش.

بازگشت‌ها
boolean اگر ویژگی پشتیبانی شود، درست است

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

hasPendingHprofDump 

public boolean hasPendingHprofDump ()

بازگشت‌ها
boolean

اشکال‌زدایی بومی 

public boolean isNativeDebuggable ()

بازگشت‌ها
boolean

شناسه کاربری معتبر است 

public boolean isValidUserId ()

اگر شناسه‌ی کاربر این کلاینت تنظیم شده باشد، مقدار true را برمی‌گرداند. فقط دستگاه‌هایی که از چندین کاربر پشتیبانی می‌کنند، شناسه‌ی کاربر را به ddms برمی‌گردانند. برای سایر دستگاه‌ها/دستگاه‌های قدیمی‌تر، این مقدار تنظیم نخواهد شد.

بازگشت‌ها
boolean

removeThread 

public void removeThread (int threadId)

یک رشته را از لیست حذف می‌کند.

پارامترها
threadId int

ست ابی 

public void setAbi (String abi)

پارامترها
abi String

وضعیت تخصیص تنظیم‌شده 

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

وضعیت اتصال setDebugger 

public void setDebuggerConnectionStatus (ClientData.DebuggerStatus status)

وضعیت اتصال اشکال‌زدا را تنظیم می‌کند.

پارامترها
status ClientData.DebuggerStatus

اطلاعات مجموعه هیپ 

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 : تعداد اشیاء تخصیص‌یافته‌ی فعلی در

مجموعهHprofData 

public void setHprofData (String filename)

پارامترها
filename String

مجموعهHprofData 

public void setHprofData (byte[] data)

پارامترها
data byte

setHprofDumpHandler 

public static void setHprofDumpHandler (ClientData.IHprofDumpHandler handler)

تنظیم می‌کند که در صورت موفقیت‌آمیز یا ناموفق بودن عملیات dump در HPROF، هندلر اعلان دریافت کند. این متد منسوخ شده است، لطفاً یک شنونده کلاینت ثبت کنید و به CHANGE_HPROF گوش دهید.

پارامترها
handler ClientData.IHprofDumpHandler

پرچم‌های تنظیم‌شده 

public void setJvmFlags (String jvmFlags)

پارامترها
jvmFlags String

setMethodProfilingHandler 

public static void setMethodProfilingHandler (ClientData.IMethodProfilingHandler handler)

تنظیم می‌کند که در صورت موفقیت‌آمیز یا ناموفق بودن عملیات dump در HPROF، هندلر اعلان دریافت کند. این متد منسوخ شده است، لطفاً یک شنونده کلاینت ثبت کنید و به CHANGE_HPROF گوش دهید.

پارامترها
handler ClientData.IMethodProfilingHandler

setMethodProfilingStatus 

public void setMethodProfilingStatus (ClientData.MethodProfilingStatus status)

پارامترها
status ClientData.MethodProfilingStatus

نام‌های مجموعه 

public void setNames (ClientData.Names names)

فرآیند، شناسه کاربری (یعنی شخصی در مقابل نمایه کاری) و نام بسته‌ها را تنظیم می‌کند.

ممکن است رقابتی بین HELO و APNM وجود داشته باشد. به جای تلاش برای اعمال ترتیب در دستگاه، ما اجازه نمی‌دهیم نام از پیش تعیین‌شده جایگزین نام مشخص‌شده شود.

پارامترها
names ClientData.Names

اشکال‌زدایی setNative 

public void setNativeDebuggable (boolean nativeDebuggable)

پارامترها
nativeDebuggable boolean

setPendingHprofDump 

public void setPendingHprofDump (String pendingHprofDump)

مسیر سمت دستگاه را برای نوشتن فایل hprof تنظیم می‌کند.

پارامترها
pendingHprofDump String : فایل مربوط به فایل hprof

پروفایلینگ setPendingMethod 

public void setPendingMethodProfiling (String pendingMethodProfiling)

مسیر سمت دستگاه را برای فایل پروفایل متدی که قرار است نوشته شود، تنظیم می‌کند.

پارامترها
pendingMethodProfiling String : فایلی که نوشته می‌شود

setTotalNativeMemory 

public void setTotalNativeMemory (int totalMemory)

پارامترها
totalMemory int

شناسه‌ی setVm 

public void setVmIdentifier (String ident)

شناسه ماشین مجازی را تنظیم می‌کند.

پارامترها
ident String