クライアント

public interface Client

com.android.tradefed.device.server.Client

これは単一のクライアント（通常は Dalvik VM プロセス）を表します。

このクラスは、基本的なクライアント情報と、クライアントに対してアクションを実行するメソッドへのアクセスを提供します。

通常はリアルタイムで更新される詳細情報には、ClientData クラスからアクセスできます。各 Client オブジェクトには、getClientData() を介してアクセスされる独自の ClientData があります。

概要

定数

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

この Client が実行されている IDevice を返します。
abstract boolean isDdmAware()

クライアント VM が DDM 対応の場合は true を返します。
abstract boolean isDebuggerAttached()

デバッガが現在クライアントにアタッチされている場合は true を返します。
abstract boolean isValid()

この ClientImpl がアプリケーション VM への有効な接続を持っているかどうかを返します。
abstract void kill()

VM に kill メッセージを送信します。
abstract void listViewRoots(DebugViewDumpHandler replyHandler)
abstract void notifyVmMirrorExited()

デバッガ VM ミラーが DDMLib の背後で終了し、さまざまな競合状態や永続的な Client 損失状態につながる可能性があります。
abstract void requestAllocationDetails()

enable が null に設定された enableAllocationTracker(boolean) の呼び出し以降に発生したすべての割り当てに関する情報を送信するよう VM にリクエストを送信します。
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 ()

この Client が実行されている IDevice を返します。

戻り値
IDevice

isDdmAware

public abstract boolean isDdmAware ()

クライアント VM が DDM 対応の場合、true を返します。

ここで呼び出すことができるのは、接続が確立された後のみです。

戻り値
boolean

isDebuggerAttached

public abstract boolean isDebuggerAttached ()

デバッガが現在クライアントにアタッチされている場合は true を返します。

戻り値
boolean

isValid

public abstract boolean isValid ()

この ClientImpl がアプリケーション VM への有効な接続を持っているかどうかを返します。

戻り値
boolean

中断 中止 止めて

public abstract void kill ()

VM に kill メッセージを送信します。VM がクラッシュ状態の場合、必ずしも機能するとは限りません。

listViewRoots

public abstract void listViewRoots (DebugViewDumpHandler replyHandler)

パラメータ
replyHandler DebugViewDumpHandler

notifyVmMirrorExited

public abstract void notifyVmMirrorExited ()

デバッガ VM ミラーは DDMLib の背後で終了することがあり、さまざまな競合状態や永続的な Client 損失状態につながります。現在アタッチされているデバッガが終了し、VM ミラー接続を終了することを DDMLib に通知する必要があります。

requestAllocationDetails

public abstract void requestAllocationDetails ()

VM にリクエストを送信して、enable が null に設定された enableAllocationTracker(boolean) の呼び出し以降に発生したすべての割り当てに関する情報を送信します。これは非同期です。

割り当て情報には ClientData.getAllocations() でアクセスできます。新しいデータが利用可能になったことを示す通知は、マスク CHANGE_HEAP_ALLOCATIONS を含む changeMask を伴って AndroidDebugBridge.clientChanged(com.android.tradefed.device.server.ClientImpl, int) を通じて受信されます。

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