ลูกค้า

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 หาก VM ไคลเอ็นต์รองรับ DDM

abstract boolean isDebuggerAttached()

แสดงผล true หากดีบักเกอร์เชื่อมต่อกับไคลเอ็นต์อยู่

abstract boolean isValid()

แสดงผลว่า ClientImpl นี้มีการเชื่อมต่อที่ถูกต้องกับ VM ของแอปพลิเคชันหรือไม่

abstract void kill()

ส่งข้อความสิ้นสุดไปยัง VM

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

VM ของดีบักเกอร์สามารถออกไปอยู่เบื้องหลัง DDMLib ได้ ซึ่งอาจทำให้เกิดการแข่งขันต่างๆ หรือเงื่อนไขการสูญเสียClientแบบถาวร

abstract void requestAllocationDetails()

ส่งคำขอไปยัง VM เพื่อส่งข้อมูลเกี่ยวกับการจัดสรรทั้งหมดที่เกิดขึ้นตั้งแต่การเรียกใช้ 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)

เมธอดสาธารณะ

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)

เปิดหรือปิดใช้เครื่องมือติดตามการจัดสรรสำหรับลูกค้ารายนี้

หากเปิดใช้ VM จะเริ่มติดตามข้อมูลการจัดสรร การเรียกใช้ requestAllocationDetails() จะทำให้ VM ส่งข้อมูลเกี่ยวกับการจัดสรรทั้งหมด ที่เกิดขึ้นระหว่างการเปิดใช้กับคำขอ

พารามิเตอร์
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 หาก VM ไคลเอ็นต์รองรับ DDM

การโทรที่นี่จะทำได้หลังจากที่สร้างการเชื่อมต่อแล้วเท่านั้น

คิกรีเทิร์น
boolean

isDebuggerAttached

public abstract boolean isDebuggerAttached ()

แสดงผล true หากดีบักเกอร์เชื่อมต่อกับไคลเอ็นต์อยู่

คิกรีเทิร์น
boolean

isValid

public abstract boolean isValid ()

แสดงผลว่า ClientImpl นี้มีการเชื่อมต่อที่ถูกต้องกับ VM ของแอปพลิเคชันหรือไม่

คิกรีเทิร์น
boolean

ปิด

public abstract void kill ()

ส่งข้อความสิ้นสุดไปยัง VM วิธีนี้อาจไม่ได้ผลหาก VM อยู่ในสถานะขัดข้อง

listViewRoots

public abstract void listViewRoots (DebugViewDumpHandler replyHandler)

พารามิเตอร์
replyHandler DebugViewDumpHandler

notifyVmMirrorExited

public abstract void notifyVmMirrorExited ()

VM ของดีบักเกอร์สามารถออกไปอยู่เบื้องหลัง DDMLib ได้ ซึ่งอาจทำให้เกิดการแข่งขันต่างๆ หรือเงื่อนไขการสูญเสียClientแบบถาวร เราต้องแจ้งให้ DDMLib ทราบว่าดีบักเกอร์ที่แนบอยู่กำลังจะออกและปิดการเชื่อมต่อ VM Mirror

requestAllocationDetails

public abstract void requestAllocationDetails ()

ส่งคำขอไปยัง VM เพื่อส่งข้อมูลเกี่ยวกับการจัดสรรทั้งหมดที่เกิดขึ้นตั้งแต่การเรียกใช้ 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 ()