Клиент

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 если клиентская виртуальная машина поддерживает DDM.

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

Битовая маска изменения клиента: изменение статуса отладчика

Постоянное значение: 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)

ИЗМЕНЕНИЕ_ИНФОРМАЦИИ 

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)

ИЗМЕНЕНИЕ_ИМЯ 

public static final int CHANGE_NAME

Битовая маска изменения клиента: изменение имени приложения

Постоянное значение: 1 (0x00000001)

CHANGE_NATIVE_HEAP_DATA 

public static final int CHANGE_NATIVE_HEAP_DATA

Битовая маска изменения клиента: данные собственной кучи обновлены

Постоянное значение: 128 (0x00000080)

ИЗМЕНИТЬ_ПОРТ 

public static final int CHANGE_PORT

Битовая маска изменения клиента: изменение порта отладчика

Постоянное значение: 4 (0x00000004)

ИЗМЕНЕНИЕ_ДАННЫХ_ПОТОКА 

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)

Включает или выключает средство отслеживания распределения для этого клиента.

Если эта функция включена, виртуальная машина начнёт отслеживать информацию о выделении памяти. Вызов requestAllocationDetails() заставит виртуальную машину отправить информацию обо всех выделениях, произошедших между включением и запросом.

Параметры
enabled boolean

Смотрите также:

выполнитьGarbageCollector 

public abstract void executeGarbageCollector ()

Заставляет клиента запустить свой сборщик мусора.

получитьКлиентскиеДанные 

public abstract ClientData getClientData ()

Возвращает объект ClientData , содержащий информацию о клиенте.

Возврат
ClientData

getDebuggerListenPort 

public abstract int getDebuggerListenPort ()

Возвращает порт отладчика для этого клиента.

Возврат
int

получить устройство 

public abstract IDevice getDevice ()

Возвращает IDevice , на котором работает этот клиент.

Возврат
IDevice

isDdmAware 

public abstract boolean isDdmAware ()

Возвращает true если клиентская виртуальная машина поддерживает DDM.

Звонок сюда разрешен только после установления соединения.

Возврат
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 ()