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

默认分析器缓冲区大小（兆字节）

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 代理服务，允许同时使用多个支持 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()

返回分析器缓冲区大小（以兆字节为单位）。

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 代理服务使用的端口。

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

默认分析器缓冲区大小（兆字节）

常量值： 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 代理服务，允许同时使用多个支持 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 ()

返回分析器缓冲区大小（以兆字节为单位）。

返回
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，则每次发生垃圾回收时，ERROR(/ClientData) 都会自动更新为虚拟机的堆信息。

此更改会立即生效，适用于新创建的 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 代理服务使用的端口。此端口在单台机器上运行的所有 jdwp 代理服务实例中应保持一致。

setLogLevel

public static void setLogLevel (String value)

设置要显示的最小 LogLevel。

此更改会立即生效。

参数
value String

setProfilerBufferSizeMb

public static void setProfilerBufferSizeMb (int bufferSizeMb)

设置分析器缓冲区大小值。

参数
bufferSizeMb int：缓冲区大小（以兆字节为单位）。

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