Klient

public interface Client

com.android.tradefed.device.server.Client

Reprezentuje to pojedynczego klienta, zwykle proces maszyny wirtualnej Dalvik.

Ta klasa zapewnia dostęp do podstawowych informacji o kliencie, a także do metod wykonywania działań na kliencie.

Bardziej szczegółowe informacje, zwykle aktualizowane w czasie rzeczywistym, są dostępne w klasie ClientData. Każdy obiekt Client ma własny obiekt ClientData, do którego dostęp uzyskuje się za pomocą getClientData().

Podsumowanie

Stałe

int CHANGE_DEBUGGER_STATUS

Maska bitowa zmiany klienta: zmiana stanu debugera

int CHANGE_HEAP_ALLOCATIONS

Maska bitowa zmiany klienta: zaktualizowano informacje o przydziale

int CHANGE_HEAP_ALLOCATION_STATUS

Maska bitowa zmiany klienta: zaktualizowano informacje o przydziale

int CHANGE_HEAP_DATA

Maska bitowa zmiany klienta: zaktualizowano dane nagłówka

int CHANGE_HEAP_MODE

Maska bitowa zmiany klienta: zmiana flagi aktualizacji sterty

int CHANGE_HPROF

Maska bitowa zmian klienta: zaktualizowano dane hprof

int CHANGE_INFO

Maska bitowa zmiany klienta: kombinacja wartości Client.CHANGE_NAME, CHANGE_DEBUGGER_STATUS i Client.CHANGE_PORT.

int CHANGE_METHOD_PROFILING_STATUS

Maska bitowa zmiany klienta: zaktualizowano informacje o przydziale

int CHANGE_NAME

Maska bitowa zmiany klienta: zmiana nazwy aplikacji

int CHANGE_NATIVE_HEAP_DATA

Maska bitowa zmiany klienta: zaktualizowano dane sterty natywnej

int CHANGE_PORT

Maska bitowa zmiany klienta: zmiana portu debugera

int CHANGE_THREAD_DATA

Maska bitowa zmiany klienta: zaktualizowano dane wątku

int CHANGE_THREAD_MODE

Maska bitowa zmiany klienta: zmiana flagi aktualizacji wątku

int CHANGE_THREAD_STACKTRACE

Maska bitowa zmiany klienta: zaktualizowano ślad stosu wątku

int SERVER_PROTOCOL_VERSION

Metody publiczne

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)

Włącza lub wyłącza narzędzie do śledzenia alokacji w przypadku tego klienta.

abstract void executeGarbageCollector()

Wymusza na kliencie uruchomienie modułu odśmiecania pamięci.

abstract ClientData getClientData()

Zwraca obiekt ClientData zawierający informacje o tym kliencie.

abstract int getDebuggerListenPort()

Zwraca port debugera dla tego klienta.

abstract IDevice getDevice()

Zwraca IDevice, na którym działa ten klient.

abstract boolean isDdmAware()

Zwraca true, jeśli maszyna wirtualna klienta obsługuje DDM.

abstract boolean isDebuggerAttached()

Zwraca wartość true, jeśli do klienta jest obecnie podłączony debugger.

abstract boolean isValid()

Zwraca informację, czy ten ClientImpl ma prawidłowe połączenie z maszyną wirtualną aplikacji.

abstract void kill()

Wysyła do maszyny wirtualnej komunikat o zakończeniu działania.

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

Kopie maszyn wirtualnych debuggera mogą kończyć działanie bez wiedzy DDMLib, co prowadzi do różnych warunków wyścigu lub trwałych Client utraty danych.

abstract void requestAllocationDetails()

Wysyła do maszyny wirtualnej prośbę o przesłanie informacji o wszystkich przydziałach, które miały miejsce od czasu wywołania funkcji enableAllocationTracker(boolean) z parametrem enable ustawionym na null.

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

Stałe

CHANGE_DEBUGGER_STATUS

public static final int CHANGE_DEBUGGER_STATUS

Maska bitowa zmiany klienta: zmiana stanu debugera

Wartość stała: 2 (0x00000002)

CHANGE_HEAP_ALLOCATIONS

public static final int CHANGE_HEAP_ALLOCATIONS

Maska bitowa zmiany klienta: zaktualizowano informacje o przydziale

Constant Value: 512 (0x00000200)

CHANGE_HEAP_ALLOCATION_STATUS

public static final int CHANGE_HEAP_ALLOCATION_STATUS

Maska bitowa zmiany klienta: zaktualizowano informacje o przydziale

Wartość stała: 1024 (0x00000400)

CHANGE_HEAP_DATA

public static final int CHANGE_HEAP_DATA

Maska bitowa zmiany klienta: zaktualizowano dane nagłówka

Wartość stała: 64 (0x00000040)

CHANGE_HEAP_MODE

public static final int CHANGE_HEAP_MODE

Maska bitowa zmiany klienta: zmiana flagi aktualizacji sterty

Wartość stała: 32 (0x00000020)

CHANGE_HPROF

public static final int CHANGE_HPROF

Maska bitowa zmian klienta: zaktualizowano dane hprof

Wartość stała: 4096 (0x00001000)

CHANGE_INFO

public static final int CHANGE_INFO

Maska bitowa zmiany klienta: kombinacja wartości Client.CHANGE_NAME, CHANGE_DEBUGGER_STATUS i Client.CHANGE_PORT.

Wartość stała: 7 (0x00000007)

CHANGE_METHOD_PROFILING_STATUS

public static final int CHANGE_METHOD_PROFILING_STATUS

Maska bitowa zmiany klienta: zaktualizowano informacje o przydziale

Wartość stała: 2048 (0x00000800)

CHANGE_NAME

public static final int CHANGE_NAME

Maska bitowa zmiany klienta: zmiana nazwy aplikacji

Wartość stała: 1 (0x00000001)

CHANGE_NATIVE_HEAP_DATA

public static final int CHANGE_NATIVE_HEAP_DATA

Maska bitowa zmiany klienta: zaktualizowano dane sterty natywnej

Wartość stała: 128 (0x00000080)

CHANGE_PORT

public static final int CHANGE_PORT

Maska bitowa zmiany klienta: zmiana portu debugera

Wartość stała: 4 (0x00000004)

CHANGE_THREAD_DATA

public static final int CHANGE_THREAD_DATA

Maska bitowa zmiany klienta: zaktualizowano dane wątku

Wartość stała: 16 (0x00000010)

CHANGE_THREAD_MODE

public static final int CHANGE_THREAD_MODE

Maska bitowa zmiany klienta: zmiana flagi aktualizacji wątku

Wartość stała: 8 (0x00000008)

CHANGE_THREAD_STACKTRACE

public static final int CHANGE_THREAD_STACKTRACE

Maska bitowa zmiany klienta: zaktualizowano ślad stosu wątku

Wartość stała: 256 (0x00000100)

SERVER_PROTOCOL_VERSION

public static final int SERVER_PROTOCOL_VERSION

Wartość stała: 1 (0x00000001)

Metody publiczne

captureView

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

Parametry
viewRoot String

view String

handler DebugViewDumpHandler

dumpDisplayList

public abstract void dumpDisplayList (String viewRoot, 
                String view)

Parametry
viewRoot String

view String

dumpViewHierarchy

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

Parametry
viewRoot String

skipChildren boolean

includeProperties boolean

useV2 boolean

handler DebugViewDumpHandler

enableAllocationTracker

public abstract void enableAllocationTracker (boolean enabled)

Włącza lub wyłącza narzędzie do śledzenia alokacji w przypadku tego klienta.

Jeśli ta opcja jest włączona, maszyna wirtualna zacznie śledzić informacje o przydziale. Wywołanie funkcji requestAllocationDetails() spowoduje, że maszyna wirtualna wyśle informacje o wszystkich przydziałach, które miały miejsce między włączeniem a żądaniem.

Parametry
enabled boolean

executeGarbageCollector

public abstract void executeGarbageCollector ()

Wymusza na kliencie uruchomienie modułu odśmiecania pamięci.

getClientData

public abstract ClientData getClientData ()

Zwraca obiekt ClientData zawierający informacje o tym kliencie.

Zwroty
ClientData

getDebuggerListenPort

public abstract int getDebuggerListenPort ()

Zwraca port debugera dla tego klienta.

Zwroty
int

getDevice

public abstract IDevice getDevice ()

Zwraca IDevice, na którym działa ten klient.

Zwroty
IDevice

isDdmAware

public abstract boolean isDdmAware ()

Zwraca true, jeśli maszyna wirtualna klienta obsługuje DDM.

Połączenia są tu dozwolone tylko po nawiązaniu połączenia.

Zwroty
boolean

isDebuggerAttached

public abstract boolean isDebuggerAttached ()

Zwraca wartość true, jeśli do klienta jest obecnie podłączony debugger.

Zwroty
boolean

isValid

public abstract boolean isValid ()

Zwraca informację, czy ten ClientImpl ma prawidłowe połączenie z maszyną wirtualną aplikacji.

Zwroty
boolean

zabijać,

public abstract void kill ()

Wysyła do maszyny wirtualnej komunikat o zakończeniu działania. Nie musi to działać, jeśli maszyna wirtualna jest w stanie awarii.

listViewRoots

public abstract void listViewRoots (DebugViewDumpHandler replyHandler)

Parametry
replyHandler DebugViewDumpHandler

notifyVmMirrorExited

public abstract void notifyVmMirrorExited ()

Kopie maszyn wirtualnych debuggera mogą kończyć działanie bez wiedzy DDMLib, co prowadzi do różnych warunków wyścigu lub trwałych Client utraty danych. Musimy powiadomić DDMLib, że dołączony obecnie debuger kończy działanie i zamyka połączenie z kopią maszyny wirtualnej.

requestAllocationDetails

public abstract void requestAllocationDetails ()

Wysyła do maszyny wirtualnej prośbę o przesłanie informacji o wszystkich przydziałach, które miały miejsce od czasu wywołania funkcji enableAllocationTracker(boolean) z parametrem enable ustawionym na null. Jest to działanie asynchroniczne.

Informacje o przydziale są dostępne pod adresem ClientData.getAllocations(). Powiadomienie o dostępności nowych danych otrzymasz za pomocą usługi AndroidDebugBridge.clientChanged(com.android.tradefed.device.server.ClientImpl, int) z  changeMask zawierającym maskę CHANGE_HEAP_ALLOCATIONS.

startMethodTracer

public abstract void startMethodTracer ()

startSamplingProfiler

public abstract void startSamplingProfiler (int samplingInterval, 
                TimeUnit timeUnit)

Parametry
samplingInterval int

timeUnit TimeUnit

stopMethodTracer

public abstract void stopMethodTracer ()

stopSamplingProfiler

public abstract void stopSamplingProfiler ()