Khách hàng

public interface Client

com.android.tradefed.device.server.Client

Đây là một ứng dụng duy nhất, thường là một quy trình VM Dalvik.

Lớp này cho phép truy cập vào thông tin cơ bản về ứng dụng, cũng như các phương thức để thực hiện hành động trên ứng dụng.

Bạn có thể truy cập vào thông tin chi tiết hơn (thường được cập nhật theo thời gian thực) thông qua lớp ClientData. Mỗi đối tượng Client đều có ClientData riêng được truy cập thông qua getClientData().

Tóm tắt

Hằng số

int CHANGE_DEBUGGER_STATUS

Mặt nạ bit thay đổi của ứng dụng: thay đổi trạng thái trình gỡ lỗi

int CHANGE_HEAP_ALLOCATIONS

Mặt nạ thay đổi của ứng dụng: đã cập nhật thông tin phân bổ

int CHANGE_HEAP_ALLOCATION_STATUS

Mặt nạ thay đổi của ứng dụng: đã cập nhật thông tin phân bổ

int CHANGE_HEAP_DATA

Mặt nạ bit thay đổi của ứng dụng: dữ liệu tiêu đề đã được cập nhật

int CHANGE_HEAP_MODE

Mặt nạ thay đổi của ứng dụng: thay đổi cờ cập nhật vùng nhớ heap

int CHANGE_HPROF

Mặt nạ bit thay đổi của ứng dụng: dữ liệu hprof đã được cập nhật

int CHANGE_INFO

Mặt nạ bit thay đổi của ứng dụng: tổ hợp Client.CHANGE_NAME, CHANGE_DEBUGGER_STATUS và Client.CHANGE_PORT.

int CHANGE_METHOD_PROFILING_STATUS

Mặt nạ thay đổi của ứng dụng: đã cập nhật thông tin phân bổ

int CHANGE_NAME

Mặt nạ thay đổi của ứng dụng: thay đổi tên ứng dụng

int CHANGE_NATIVE_HEAP_DATA

Mặt nạ bit thay đổi của ứng dụng: dữ liệu heap gốc đã được cập nhật

int CHANGE_PORT

Mặt nạ bit thay đổi của ứng dụng: thay đổi cổng gỡ lỗi

int CHANGE_THREAD_DATA

Mặt nạ thay đổi của ứng dụng: dữ liệu luồng được cập nhật

int CHANGE_THREAD_MODE

Mặt nạ bit thay đổi của ứng dụng: thay đổi cờ cập nhật luồng

int CHANGE_THREAD_STACKTRACE

Mặt nạ bit thay đổi của ứng dụng: đã cập nhật dấu vết ngăn xếp luồng

int SERVER_PROTOCOL_VERSION

Phương thức công khai

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)

Bật hoặc tắt Allocation tracker (Trình theo dõi việc phân bổ) cho khách hàng này.

abstract void executeGarbageCollector()

Buộc ứng dụng khách thực thi trình thu gom rác.

abstract ClientData getClientData()

Trả về đối tượng ClientData chứa thông tin về ứng dụng khách này.

abstract int getDebuggerListenPort()

Trả về cổng gỡ lỗi cho ứng dụng này.

abstract IDevice getDevice()

Trả về IDevice mà Ứng dụng này đang chạy.

abstract boolean isDdmAware()

Trả về true nếu VM ứng dụng có nhận biết DDM.

abstract boolean isDebuggerAttached()

Trả về true nếu một trình gỡ lỗi hiện được đính kèm vào ứng dụng.

abstract boolean isValid()

Trả về xem ClientImpl này có kết nối hợp lệ với VM ứng dụng hay không.

abstract void kill()

Gửi thông báo tắt đến máy ảo.

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

Các bản sao VM gỡ lỗi có thể thoát ra sau DDMLib, dẫn đến nhiều điều kiện mất Client vĩnh viễn hoặc điều kiện xung đột.

abstract void requestAllocationDetails()

Gửi yêu cầu đến VM để gửi thông tin về tất cả các hoạt động phân bổ đã xảy ra kể từ khi gọi đến enableAllocationTracker(boolean) với enable được đặt thành null.

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

Hằng số

CHANGE_DEBUGGER_STATUS

public static final int CHANGE_DEBUGGER_STATUS

Mặt nạ bit thay đổi của ứng dụng: thay đổi trạng thái trình gỡ lỗi

Giá trị hằng số: 2 (0x00000002)

CHANGE_HEAP_ALLOCATIONS

public static final int CHANGE_HEAP_ALLOCATIONS

Mặt nạ thay đổi của ứng dụng: đã cập nhật thông tin phân bổ

Giá trị hằng số: 512 (0x00000200)

CHANGE_HEAP_ALLOCATION_STATUS

public static final int CHANGE_HEAP_ALLOCATION_STATUS

Mặt nạ thay đổi của ứng dụng: đã cập nhật thông tin phân bổ

Giá trị hằng số: 1024 (0x00000400)

CHANGE_HEAP_DATA

public static final int CHANGE_HEAP_DATA

Mặt nạ bit thay đổi của ứng dụng: dữ liệu tiêu đề đã được cập nhật

Giá trị hằng số: 64 (0x00000040)

CHANGE_HEAP_MODE

public static final int CHANGE_HEAP_MODE

Mặt nạ thay đổi của ứng dụng: thay đổi cờ cập nhật vùng nhớ heap

Giá trị hằng số: 32 (0x00000020)

CHANGE_HPROF

public static final int CHANGE_HPROF

Mặt nạ bit thay đổi của ứng dụng: dữ liệu hprof đã được cập nhật

Giá trị hằng số: 4096 (0x00001000)

CHANGE_INFO

public static final int CHANGE_INFO

Mặt nạ bit thay đổi của ứng dụng: tổ hợp Client.CHANGE_NAME, CHANGE_DEBUGGER_STATUS và Client.CHANGE_PORT.

Giá trị hằng số: 7 (0x00000007)

CHANGE_METHOD_PROFILING_STATUS

public static final int CHANGE_METHOD_PROFILING_STATUS

Mặt nạ thay đổi của ứng dụng: đã cập nhật thông tin phân bổ

Giá trị hằng số: 2048 (0x00000800)

CHANGE_NAME

public static final int CHANGE_NAME

Mặt nạ thay đổi của ứng dụng: thay đổi tên ứng dụng

Giá trị hằng số: 1 (0x00000001)

CHANGE_NATIVE_HEAP_DATA

public static final int CHANGE_NATIVE_HEAP_DATA

Mặt nạ bit thay đổi của ứng dụng: dữ liệu heap gốc đã được cập nhật

Giá trị hằng số: 128 (0x00000080)

CHANGE_PORT

public static final int CHANGE_PORT

Mặt nạ bit thay đổi của máy khách: thay đổi cổng trình gỡ lỗi

Giá trị hằng số: 4 (0x00000004)

CHANGE_THREAD_DATA

public static final int CHANGE_THREAD_DATA

Mặt nạ thay đổi của ứng dụng: dữ liệu luồng được cập nhật

Giá trị hằng số: 16 (0x00000010)

CHANGE_THREAD_MODE

public static final int CHANGE_THREAD_MODE

Mặt nạ bit thay đổi của ứng dụng: thay đổi cờ cập nhật luồng

Giá trị hằng số: 8 (0x00000008)

CHANGE_THREAD_STACKTRACE

public static final int CHANGE_THREAD_STACKTRACE

Mặt nạ bit thay đổi của ứng dụng: đã cập nhật dấu vết ngăn xếp luồng

Giá trị hằng số: 256 (0x00000100)

SERVER_PROTOCOL_VERSION

public static final int SERVER_PROTOCOL_VERSION

Giá trị hằng số: 1 (0x00000001)

Phương thức công khai

captureView

public abstract void captureView (String viewRoot, 
                String view, 
                DebugViewDumpHandler handler)

Tham số
viewRoot String

view String

handler DebugViewDumpHandler

dumpDisplayList

public abstract void dumpDisplayList (String viewRoot, 
                String view)

Tham số
viewRoot String

view String

dumpViewHierarchy

public abstract void dumpViewHierarchy (String viewRoot, 
                boolean skipChildren, 
                boolean includeProperties, 
                boolean useV2, 
                DebugViewDumpHandler handler)

Tham số
viewRoot String

skipChildren boolean

includeProperties boolean

useV2 boolean

handler DebugViewDumpHandler

enableAllocationTracker

public abstract void enableAllocationTracker (boolean enabled)

Bật hoặc tắt Allocation tracker (Trình theo dõi việc phân bổ) cho khách hàng này.

Nếu được bật, VM sẽ bắt đầu theo dõi thông tin phân bổ. Lệnh gọi đến requestAllocationDetails() sẽ khiến VM gửi thông tin về tất cả các hoạt động phân bổ xảy ra giữa thời điểm bật và thời điểm yêu cầu.

Tham số
enabled boolean

executeGarbageCollector

public abstract void executeGarbageCollector ()

Buộc ứng dụng khách thực thi trình thu gom rác.

getClientData

public abstract ClientData getClientData ()

Trả về đối tượng ClientData chứa thông tin về ứng dụng khách này.

Giá trị trả về
ClientData

getDebuggerListenPort

public abstract int getDebuggerListenPort ()

Trả về cổng gỡ lỗi cho ứng dụng này.

Giá trị trả về
int

getDevice

public abstract IDevice getDevice ()

Trả về IDevice mà Ứng dụng này đang chạy.

Giá trị trả về
IDevice

isDdmAware

public abstract boolean isDdmAware ()

Trả về true nếu VM ứng dụng có nhận biết DDM.

Bạn chỉ có thể gọi ở đây sau khi thiết lập kết nối.

Giá trị trả về
boolean

isDebuggerAttached

public abstract boolean isDebuggerAttached ()

Trả về true nếu một trình gỡ lỗi hiện được đính kèm vào ứng dụng.

Giá trị trả về
boolean

isValid

public abstract boolean isValid ()

Trả về xem ClientImpl này có kết nối hợp lệ với VM ứng dụng hay không.

Giá trị trả về
boolean

kill

public abstract void kill ()

Gửi thông báo tắt đến máy ảo. Cách này không nhất thiết hiệu quả nếu VM đang ở trạng thái gặp sự cố.

listViewRoots

public abstract void listViewRoots (DebugViewDumpHandler replyHandler)

Tham số
replyHandler DebugViewDumpHandler

notifyVmMirrorExited

public abstract void notifyVmMirrorExited ()

Các bản sao VM gỡ lỗi có thể thoát ra sau DDMLib, dẫn đến nhiều điều kiện mất Client vĩnh viễn hoặc điều kiện xung đột. Chúng ta cần thông báo cho DDMLib rằng trình gỡ lỗi hiện đang được đính kèm sẽ thoát và huỷ kết nối phản chiếu VM.

requestAllocationDetails

public abstract void requestAllocationDetails ()

Gửi yêu cầu đến VM để gửi thông tin về tất cả các hoạt động phân bổ đã xảy ra kể từ khi gọi đến enableAllocationTracker(boolean) với enable được đặt thành null. Đây là thao tác không đồng bộ.

Bạn có thể truy cập thông tin phân bổ bằng ClientData.getAllocations(). Thông báo cho biết dữ liệu mới đã có sẽ được nhận thông qua AndroidDebugBridge.clientChanged(com.android.tradefed.device.server.ClientImpl, int) với changeMask chứa mặt nạ CHANGE_HEAP_ALLOCATIONS.

startMethodTracer

public abstract void startMethodTracer ()

startSamplingProfiler

public abstract void startSamplingProfiler (int samplingInterval, 
                TimeUnit timeUnit)

Tham số
samplingInterval int

timeUnit TimeUnit

stopMethodTracer

public abstract void stopMethodTracer ()

stopSamplingProfiler

public abstract void stopSamplingProfiler ()