DdmPreferences

public final class DdmPreferences
extends Object

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

Preferências para a biblioteca ddm.

Essa classe não processa o armazenamento das preferências. Ele é apenas um ponto central para aplicativos que usam a ddmlib para substituir os valores padrão.

Vários componentes da ddmlib consultam essa classe para receber os valores.

As chamadas para alguns métodos set##() vão atualizar os componentes usando os valores imediatamente, enquanto outros métodos não terão efeito depois que ERROR(/AndroidDebugBridge#init(boolean)) for chamado.

Confira a documentação de cada método.

Resumo

Constantes

String DEFAULT_ADBHOST_VALUE

boolean DEFAULT_INITIAL_HEAP_UPDATE

Valor padrão para a flag de atualização de heap na conexão do cliente.

boolean DEFAULT_INITIAL_THREAD_UPDATE

Valor padrão para a flag de atualização de linhas de execução na conexão do cliente.

int DEFAULT_PROFILER_BUFFER_SIZE_MB

Tamanho padrão do buffer do criador de perfil (megabytes)

int DEFAULT_TIMEOUT

Valores de tempo limite padrão para conexão adb (milissegundos)

boolean DEFAULT_USE_ADBHOST

Valores padrão para o uso da variável de ambiente ADBHOST.

Campos

public static final Log.LogLevel DEFAULT_LOG_LEVEL

Valor padrão para o logcat LogLevel

Métodos públicos

static void enableDdmlibCommandService(boolean enabled)

Ativa o serviço de comando ddmlib, permitindo que processos externos (por exemplo, ICEBOX) emitam comandos para ddmlib.

static void enableJdwpProxyService(boolean enabled)

Ative o serviço de proxy jdwp para permitir que vários clientes DDMLIB sejam usados ao mesmo tempo.

static String getAdbHostValue()

Retorna o valor da variável ADBHOST definida pelo usuário.

static int getDdmCommandPort()
static boolean getInitialHeapUpdate()

Retorna a flag ERROR(/Client) inicial para atualizações de heap.

static boolean getInitialThreadUpdate()

Retorna a flag ERROR(/Client) inicial para atualizações de conversas.

static int getJdwpMaxPacketSize()

Pacotes maiores que isso vão gerar uma exceção de estouro de buffer e desconectar o cliente.

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

Retorna o LogLevel mínimo exibido.

static int getProfilerBufferSizeMb()

Retorna o tamanho do buffer do criador de perfil (megabytes).

static int getTimeOut()

Retorna o tempo limite a ser usado em conexões adb (milissegundos).

static boolean getUseAdbHost()

Retorna um booleano indicando se o usuário usa ou não a variável ADBHOST.

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

Define o valor da variável ADBHOST.

static void setDdmCommandPort(int port)

Defina a porta usada pelo serviço de comando ddmlib.

static void setInitialHeapUpdate(boolean state)

Define a flag ERROR(/Client) inicial para atualizações de heap.

static void setInitialThreadUpdate(boolean state)

Define a flag ERROR(/Client) inicial para atualizações de encadeamento.

static void setJdwpProxyPort(int port)

Defina a porta usada pelo serviço de proxy jdwp.

static void setLogLevel(String value)

Define o LogLevel mínimo a ser exibido.

static void setProfilerBufferSizeMb(int bufferSizeMb)

Define o valor do tamanho do buffer do criador de perfil.

static void setTimeOut(int timeOut)

Define o valor de tempo limite para a conexão adb.

static void setUseAdbHost(boolean useAdbHost)

Define o valor do booleano que indica se o usuário usa ou não a variável ADBHOST.

static void setsJdwpMaxPacketSize(int size)

Constantes

DEFAULT_ADBHOST_VALUE

public static final String DEFAULT_ADBHOST_VALUE

Valor da constante: "127.0.0.1"

DEFAULT_INITIAL_HEAP_UPDATE

public static final boolean DEFAULT_INITIAL_HEAP_UPDATE

Valor padrão para a flag de atualização de heap na conexão do cliente.

Valor constante: false

DEFAULT_INITIAL_THREAD_UPDATE

public static final boolean DEFAULT_INITIAL_THREAD_UPDATE

Valor padrão para a flag de atualização de linhas de execução na conexão do cliente.

Valor constante: false

DEFAULT_PROFILER_BUFFER_SIZE_MB

public static final int DEFAULT_PROFILER_BUFFER_SIZE_MB

Tamanho padrão do buffer do criador de perfil (megabytes)

Valor da constante: 8 (0x00000008)

DEFAULT_TIMEOUT

public static final int DEFAULT_TIMEOUT

Valores de tempo limite padrão para conexão adb (milissegundos)

Valor da constante: 5000 (0x00001388)

DEFAULT_USE_ADBHOST

public static final boolean DEFAULT_USE_ADBHOST

Valores padrão para o uso da variável de ambiente ADBHOST.

Valor constante: false

Campos

DEFAULT_LOG_LEVEL

public static final Log.LogLevel DEFAULT_LOG_LEVEL

Valor padrão para o logcat LogLevel

Métodos públicos

enableDdmlibCommandService

public static void enableDdmlibCommandService (boolean enabled)

Ativa o serviço de comando ddmlib, permitindo que processos externos (por exemplo, ICEBOX) emitam comandos para ddmlib.

Parâmetros
enabled boolean

enableJdwpProxyService

public static void enableJdwpProxyService (boolean enabled)

Ative o serviço de proxy jdwp para permitir que vários clientes DDMLIB sejam usados ao mesmo tempo.

Parâmetros
enabled boolean

getAdbHostValue

public static String getAdbHostValue ()

Retorna o valor da variável ADBHOST definida pelo usuário.

Retorna
String

getDdmCommandPort

public static int getDdmCommandPort ()

Retorna
int

getInitialHeapUpdate

public static boolean getInitialHeapUpdate ()

Retorna a flag ERROR(/Client) inicial para atualizações de heap.

Retorna
boolean

getInitialThreadUpdate

public static boolean getInitialThreadUpdate ()

Retorna a flag ERROR(/Client) inicial para atualizações de conversas.

Retorna
boolean

getJdwpMaxPacketSize

public static int getJdwpMaxPacketSize ()

Pacotes maiores que isso vão gerar uma exceção de estouro de buffer e desconectar o cliente.

Retorna
int

getJdwpProxyPort

public static int getJdwpProxyPort ()

Retorna
int

getLogLevel

public static Log.LogLevel getLogLevel ()

Retorna o LogLevel mínimo exibido.

Retorna
Log.LogLevel

getProfilerBufferSizeMb

public static int getProfilerBufferSizeMb ()

Retorna o tamanho do buffer do criador de perfil (megabytes).

Retorna
int

getTimeOut

public static int getTimeOut ()

Retorna o tempo limite a ser usado em conexões adb (milissegundos).

Retorna
int

getUseAdbHost

public static boolean getUseAdbHost ()

Retorna um booleano indicando se o usuário usa ou não a variável ADBHOST.

Retorna
boolean

isDdmlibCommandServiceEnabled

public static boolean isDdmlibCommandServiceEnabled ()

Retorna
boolean

isJdwpProxyEnabled

public static boolean isJdwpProxyEnabled ()

Retorna
boolean

setAdbHostValue

public static void setAdbHostValue (String adbHostValue)

Define o valor da variável ADBHOST.

setDdmCommandPort

public static void setDdmCommandPort (int port)

Defina a porta usada pelo serviço de comando ddmlib. Essa porta é fixa para que serviços externos possam enviar comandos a qualquer instância em execução da ddmlib.

setInitialHeapUpdate

public static void setInitialHeapUpdate (boolean state)

Define a flag ERROR(/Client) inicial para atualizações de heap.

Se true, o ERROR(/ClientData) será atualizado automaticamente com as informações de heap da VM sempre que uma coleta de lixo acontecer.

Essa mudança entra em vigor imediatamente para objetos ERROR(/Client) recém-criados.

Parâmetros
state boolean

setInitialThreadUpdate

public static void setInitialThreadUpdate (boolean state)

Define a flag ERROR(/Client) inicial para atualizações de encadeamento.

Essa mudança entra em vigor imediatamente para objetos ERROR(/Client) recém-criados.

Parâmetros
state boolean

setJdwpProxyPort

public static void setJdwpProxyPort (int port)

Defina a porta usada pelo serviço de proxy jdwp. Essa porta precisa ser consistente em todas as instâncias do serviço de proxy jdwp executadas em uma única máquina.

setLogLevel

public static void setLogLevel (String value)

Define o LogLevel mínimo a ser exibido.

Essa mudança entra em vigor imediatamente.

Parâmetros
value String

setProfilerBufferSizeMb

public static void setProfilerBufferSizeMb (int bufferSizeMb)

Define o valor do tamanho do buffer do criador de perfil.

Parâmetros
bufferSizeMb int: o tamanho do buffer (megabytes).

setTimeOut

public static void setTimeOut (int timeOut)

Define o valor de tempo limite para a conexão adb.

Essa mudança entra em vigor apenas para conexões criadas recentemente.

Parâmetros
timeOut int: o valor de tempo limite (milissegundos).

setUseAdbHost

public static void setUseAdbHost (boolean useAdbHost)

Define o valor do booleano que indica se o usuário usa ou não a variável ADBHOST.

Parâmetros
useAdbHost boolean: verdadeiro se o usuário usa ADBHOST

setsJdwpMaxPacketSize

public static void setsJdwpMaxPacketSize (int size)

Parâmetros
size int