DdmPreferences

public final class DdmPreferences
extends Object

java.lang.Object
   ↳ com.android.ddmlib.DdmPreferences

ddm 程式庫的偏好設定。

這個類別不會處理偏好設定的儲存作業。這只是應用程式使用 ddmlib 覆寫預設值的中心點。

這個類別會查詢 ddmlib 查詢的各種元件，以取得值。

呼叫某些 set##() 方法會立即使用值更新元件，而呼叫其他方法則不會有任何效果 (一旦呼叫 ERROR(/AndroidDebugBridge#init(boolean)) 之後)。

請參閱各個方法的說明文件。

摘要

常數

String DEFAULT_ADBHOST_VALUE

boolean DEFAULT_INITIAL_HEAP_UPDATE

用戶端連線時，堆積更新旗標的預設值。

boolean DEFAULT_INITIAL_THREAD_UPDATE

用戶端連線時，執行緒更新旗標的預設值。

int DEFAULT_PROFILER_BUFFER_SIZE_MB

預設剖析器緩衝區大小 (MB)

int DEFAULT_TIMEOUT

adb 連線的預設逾時值 (毫秒)

boolean DEFAULT_USE_ADBHOST

使用 ADBHOST 環境變數的預設值。

欄位

public static final Log.LogLevel DEFAULT_LOG_LEVEL

logcat LogLevel 的預設值

公用方法

static void enableDdmlibCommandService(boolean enabled)

啟用 ddmlib 指令服務，允許外部程序 (例如 ICEBOX) 對 ddmlib 發出指令。

static void enableJdwpProxyService(boolean enabled)

啟用 jdwp Proxy 服務，支援同時使用多個 DDMLIB 用戶端。

static String getAdbHostValue()

傳回使用者設定的 ADBHOST 變數值。

static int getDdmCommandPort()
static boolean getInitialHeapUpdate()

傳回堆積更新的初始 ERROR(/Client) 旗標。

static boolean getInitialThreadUpdate()

傳回執行緒更新的初始 ERROR(/Client) 旗標。

static int getJdwpMaxPacketSize()

如果封包大於這個值，系統會擲回緩衝區溢位例外狀況，並中斷用戶端連線。

static int getJdwpProxyPort()
static Log.LogLevel getLogLevel()

傳回顯示的最低 LogLevel。

static int getProfilerBufferSizeMb()

傳回剖析器緩衝區大小 (MB)。

static int getTimeOut()

傳回要在 adb 連線中使用的逾時時間 (毫秒)。

static boolean getUseAdbHost()

傳回布林值，指出使用者是否使用 ADBHOST 變數。

static boolean isDdmlibCommandServiceEnabled()
static boolean isJdwpProxyEnabled()
static void setAdbHostValue(String adbHostValue)

設定 ADBHOST 變數的值。

static void setDdmCommandPort(int port)

設定 ddmlib 指令服務使用的通訊埠。

static void setInitialHeapUpdate(boolean state)

設定堆積更新的初始 ERROR(/Client) 旗標。

static void setInitialThreadUpdate(boolean state)

為執行緒更新設定初始 ERROR(/Client) 旗標。

static void setJdwpProxyPort(int port)

設定 jdwp Proxy 服務使用的通訊埠。

static void setLogLevel(String value)

設定要顯示的最低 LogLevel。

static void setProfilerBufferSizeMb(int bufferSizeMb)

設定剖析器緩衝區大小值。

static void setTimeOut(int timeOut)

設定 adb 連線的逾時值。

static void setUseAdbHost(boolean useAdbHost)

設定布林值，指出使用者是否使用 ADBHOST 變數。

static void setsJdwpMaxPacketSize(int size)

常數

DEFAULT_ADBHOST_VALUE

public static final String DEFAULT_ADBHOST_VALUE

常數值： "127.0.0.1"

DEFAULT_INITIAL_HEAP_UPDATE

public static final boolean DEFAULT_INITIAL_HEAP_UPDATE

用戶端連線時，堆積更新旗標的預設值。

常數值： false

DEFAULT_INITIAL_THREAD_UPDATE

public static final boolean DEFAULT_INITIAL_THREAD_UPDATE

用戶端連線時，執行緒更新旗標的預設值。

常數值： false

DEFAULT_PROFILER_BUFFER_SIZE_MB

public static final int DEFAULT_PROFILER_BUFFER_SIZE_MB

預設剖析器緩衝區大小 (MB)

常數值： 8 (0x00000008)

DEFAULT_TIMEOUT

public static final int DEFAULT_TIMEOUT

adb 連線的預設逾時值 (毫秒)

常數值： 5000 (0x00001388)

DEFAULT_USE_ADBHOST

public static final boolean DEFAULT_USE_ADBHOST

使用 ADBHOST 環境變數的預設值。

常數值： false

欄位

DEFAULT_LOG_LEVEL

public static final Log.LogLevel DEFAULT_LOG_LEVEL

logcat LogLevel 的預設值

公用方法

enableDdmlibCommandService

public static void enableDdmlibCommandService (boolean enabled)

啟用 ddmlib 指令服務，允許外部程序 (例如 ICEBOX) 對 ddmlib 發出指令。

參數
enabled boolean

enableJdwpProxyService

public static void enableJdwpProxyService (boolean enabled)

啟用 jdwp Proxy 服務，支援同時使用多個 DDMLIB 用戶端。

參數
enabled boolean

getAdbHostValue

public static String getAdbHostValue ()

傳回使用者設定的 ADBHOST 變數值。

傳回
String

getDdmCommandPort

public static int getDdmCommandPort ()

傳回
int

getInitialHeapUpdate

public static boolean getInitialHeapUpdate ()

傳回堆積更新的初始 ERROR(/Client) 旗標。

傳回
boolean

getInitialThreadUpdate

public static boolean getInitialThreadUpdate ()

傳回執行緒更新的初始 ERROR(/Client) 旗標。

傳回
boolean

getJdwpMaxPacketSize

public static int getJdwpMaxPacketSize ()

如果封包大於這個值，系統會擲回緩衝區溢位例外狀況，並中斷用戶端連線。

傳回
int

getJdwpProxyPort

public static int getJdwpProxyPort ()

傳回
int

getLogLevel

public static Log.LogLevel getLogLevel ()

傳回顯示的最低 LogLevel。

傳回
Log.LogLevel

getProfilerBufferSizeMb

public static int getProfilerBufferSizeMb ()

傳回剖析器緩衝區大小 (MB)。

傳回
int

getTimeOut

public static int getTimeOut ()

傳回要在 adb 連線中使用的逾時時間 (毫秒)。

傳回
int

getUseAdbHost

public static boolean getUseAdbHost ()

傳回布林值，指出使用者是否使用 ADBHOST 變數。

傳回
boolean

isDdmlibCommandServiceEnabled

public static boolean isDdmlibCommandServiceEnabled ()

傳回
boolean

isJdwpProxyEnabled

public static boolean isJdwpProxyEnabled ()

傳回
boolean

setAdbHostValue

public static void setAdbHostValue (String adbHostValue)

設定 ADBHOST 變數的值。

setDdmCommandPort

public static void setDdmCommandPort (int port)

設定 ddmlib 指令服務使用的通訊埠。這個通訊埠是固定的，因此外部服務可以將指令傳送至 ddmlib 的任何執行個體。

setInitialHeapUpdate

public static void setInitialHeapUpdate (boolean state)

設定堆積更新的初始 ERROR(/Client) 旗標。

如果 true，系統會在發生 GC 時自動更新 ERROR(/ClientData)，並提供 VM 堆積資訊。

這項變更會立即生效，適用於新建立的 ERROR(/Client) 物件。

參數
state boolean

setInitialThreadUpdate

public static void setInitialThreadUpdate (boolean state)

為執行緒更新設定初始 ERROR(/Client) 旗標。

這項變更會立即生效，適用於新建立的 ERROR(/Client) 物件。

參數
state boolean

setJdwpProxyPort

public static void setJdwpProxyPort (int port)

設定 jdwp Proxy 服務使用的通訊埠。在單一機器上執行的所有 jdwp Proxy 服務執行個體，都應使用這個通訊埠。

setLogLevel

public static void setLogLevel (String value)

設定要顯示的最低 LogLevel。

這項變更會立即生效。

參數
value String

setProfilerBufferSizeMb

public static void setProfilerBufferSizeMb (int bufferSizeMb)

設定剖析器緩衝區大小值。

參數
bufferSizeMb int：緩衝區大小 (MB)。

setTimeOut

public static void setTimeOut (int timeOut)

設定 adb 連線的逾時值。

這項變更只會套用至新建立的連結。

參數
timeOut int：逾時值 (毫秒)。

setUseAdbHost

public static void setUseAdbHost (boolean useAdbHost)

設定布林值，指出使用者是否使用 ADBHOST 變數。

參數
useAdbHost boolean：如果使用者使用 ADBHOST，則為 true

setsJdwpMaxPacketSize

public static void setsJdwpMaxPacketSize (int size)

參數
size int