Skip to content

Most visited

Recently visited

navigation

Gravar e visualizar registros com o Logcat

O Android Monitor contém um monitor do logcat que exibe mensagens de depuração. O monitor do logcat exibe mensagens do sistema, como quando uma coleta de lixo ocorre, e outras que você pode adicionar ao aplicativo usando a classe Log. Ele exibe mensagens em tempo real e mantém um histórico para você poder ver mensagens antigas.

Para exibir apenas as informações que lhe interessam, você pode criar filtros, determinar quantas informações devem aparecer nas mensagens, definir níveis de prioridade, exibir apenas mensagens produzidas pelo código do aplicativo e fazer uma busca pelo registro. Por padrão, o monitor do logcat exibe somente a saída de registro referente à execução mais recente do aplicativo.

Quando um aplicativo aciona uma exceção, o monitor do logcat exibe uma mensagem após o rastreamento de pilha associado que contém links para o código. Esse recurso pode ajudar a corrigir erros e melhorar o funcionamento do aplicativo.

A partir do Android Studio 2.2, a janela Run também exibe mensagens de registro para o aplicativo em execução no momento. Observe que você pode configurar a tela do monitor do logcat, mas não a janela Run.

Formato das mensagens do logcat

Cada mensagem do registro do Android é associada a uma tag e uma prioridade. A tag de uma mensagem de registro do sistema é uma string curta que indica o componente do sistema que originou a mensagem (por exemplo, ActivityManager). Uma tag definida pelo usuário pode ser qualquer string que você ache útil, como o nome da classe em questão (a tag recomendada). Você pode defini-la chamando o método Log, por exemplo:

Log.d(tag, message);

A prioridade é um dos seguintes valores:

O formato das mensagens do registro é:

date time PID-TID/package priority/tag: message

Por exemplo, a mensagem de registro a seguir tem prioridade V e uma tag AuthZen:

12-10 13:02:50.071 1901-4229/com.google.android.gms V/AuthZen: Handling delegate intent.

O PID se refere ao identificador do processo e o TID é o identificador do encadeamento: eles podem ser iguais se só houver um encadeamento.

Exibir um aplicativo em execução no monitor do logcat

Para exibir as mensagens de erro de um determinado aplicativo:

  1. Atenda aos pré-requisitos e às dependências.
  2. Abra um projeto de aplicativo.
  3. Execute o aplicativo em um dispositivo físico ou emulador.
  4. Abra o Android Monitor.
  5. Clique na aba logcat.
  6. Por padrão, o monitor do logcat exibe somente as mensagens de registro do aplicativo que está em execução no dispositivo ou emulador:

    Para alterar esse padrão, consulte Filtrar mensagens do logcat.

  7. Uma opção é selecionar um outro dispositivo, emulador ou processo.

Definir o nível de registro

É possível controlar a quantidade de mensagens que aparecem no monitor do logcat definindo o nível de registro. Você pode exibir todas as mensagens ou apenas aquelas que indicam situações mais graves.

Lembre-se de que o monitor do logcat continua coletando todas as mensagens qualquer que seja o nível de registro definido. A configuração só determina o que o monitor do logcat exibirá.

Para definir o nível de registro:

Buscar mensagens do logcat

Para buscar as mensagens atualmente exibidas no monitor do logcat:

  1. Você pode selecionar Regex se quiser usar um padrão de busca de expressão regular.
  2. Digite uma sequência de caracteres no campo de busca Ícone de busca.
  3. O monitor do logcat mostra as alterações efetuadas.

  4. Pressione “Enter” para armazenar a string de busca no menu durante essa sessão.
  5. Para repetir a busca, selecione-a no menu de busca. Marque ou desmarque Regex se necessário (a configuração não é gravada).

Filtrar mensagens do logcat

Uma forma de reduzir a saída de registros a um nível gerenciável é restringi-la com um filtro.

Observação: o filtro se aplica a todo o histórico do logcat, não somente às mensagens exibidas no monitor do logcat no momento. Veja se as outras opções de exibição estão configuradas corretamente para poder ver a saída do filtro que quer examinar.

Para definir e aplicar um filtro:

  1. No menu de filtragem, selecione uma opção de filtro:
    • Exibir somente aplicativos selecionados — exibe somente as mensagens produzidas pelo código do aplicativo (padrão). O monitor do logcat filtra as mensagens de registro usando o PID do aplicativo ativo.
    • Sem filtro — não aplica filtros. O monitor do logcat exibe todas as mensagens de registro do dispositivo, seja qual for o processo selecionado.
    • Editar configuração do filtro — cria ou modifica um filtro personalizado. Por exemplo, você pode criar um filtro para visualizar mensagens de registro de dois aplicativos ao mesmo tempo.

    Depois de definir os filtros, você pode selecioná-los no menu. Para removê-los do menu, basta excluí-los.

  2. Se você escolheu Editar configuração do filtro, crie ou modifique um filtro.
    1. Especifique os parâmetros do filtro na caixa de diálogo Create New Logcat Filter:
      • Nome do filtro — digite o nome para um filtro que queira definir ou selecione um no painel esquerdo para modificá-lo. O nome pode conter apenas caracteres minúsculos, sublinhados e dígitos.
      • Tag de registro — permite especificar uma tag. Para saber mais, acesse Formato das mensagens do logcat.
      • Mensagem de registro — permite especificar o texto da mensagem de registro. Para saber mais, acesse Formato das mensagens do logcat.
      • Nome do pacote — permite especificar o nome de um pacote. Para saber mais, acesse Formato das mensagens do logcat.
      • PID — permite especificar um ID de processo. Para saber mais, acesse Formato das mensagens do logcat.
      • Nível do registro — permite selecionar um nível de registro. Para obter mais informações, consulte Definir o nível de registro.
      • Regex — selecione essa opção para usar uma sintaxe de expressão regular para esse parâmetro.
    2. Clique em + para adicionar a configuração de filtro no painel esquerdo.
    3. Para remover um filtro, selecione-o no painel esquerdo e clique em -.

    4. Quando acabar, clique em OK. Se clicar em Cancel, as adições e modificações de filtro serão perdidas.
  3. Certifique-se de ver as mensagens de registro que quer examinar.
  4. Se você acha que não consegue ver as mensagens de registro que quer, tente selecionar No filters e buscar mensagens de registro específicas.

Configurar a vista de cabeçalho do logcat

Para personalizar a vista de cabeçalho para exibir somente as informações que lhe interessam:

Para obter mais informações sobre elementos de mensagem, leia Formato das mensagens do logcat.

Subir e descer no rastreamento de pilha

Quando o aplicativo aciona uma exceção, a mensagem inclui um rastreamento de pilha de chamadas de método. O monitor do logcat permite localizar rastreamentos de pilha rapidamente no registro e visualizar o código associado no Editor de código. Se necessário (e possível), o descompilador deriva o código-fonte que você pode visualizar.

Para mover para cima ou para baixo no rastreamento de pilha e ver o código associado no Editor de código:

Mover para o final do registro

Clicar em determinada mensagem interrompe a exibição de mensagens.

Para se mover rapidamente para o fim do registro e ver o fluxo de mensagens em tempo real:

Imprimir e gravar em um arquivo

Para preservar as informações do registro, você pode enviá-lo a uma impressora, gravá-lo em um arquivo PDF ou copiá-lo e colá-lo em um arquivo de texto

Para imprimir o registro ou gravá-lo em um arquivo PDF:

  1. Clique em “Imprimir” Ícone de imprimir.
  2. Na caixa de diálogo Print do Android Studio, você pode alterar os parâmetros da impressão e clicar em Print.
  3. Na caixa de diálogo Print do sistema operacional, você pode alterar os parâmetros da impressão e clicar em Print.
  4. É possível configurar os parâmetros para enviar o registro a uma impressora ou gravá-lo em um arquivo PDF.

Para copiar o registro para um arquivo de texto:

  1. No monitor do logcat, selecione e copie o texto do registro.
  2. Pressione Ctrl + A (⌘A) para selecionar tudo.

  3. Abra um editor de texto e cole o texto.

Apagar e recomeçar o registro

Para apagar (limpar) todo o registro:

Se houver um problema e o registro não estiver mais progredindo, você pode reiniciá-lo:

Adicionar mensagens de registro ao código

A classe Log permite criar mensagens de registro que aparecem no monitor do logcat. Geralmente, usam-se os seguintes métodos de registro, listados em ordem decrescente de prioridade (ou de menos para mais detalhado):

Consulte a descrição da classe Log para ver uma lista mais completa de opções.

Você nunca deve compilar registros detalhados no aplicativo, exceto durante o desenvolvimento. Registros de depuração são compilados, mas eliminados em tempo de execução, enquanto que os registros de erro, aviso e informação sempre são mantidos.

Para cada método de registro, o primeiro parâmetro deve ser uma tag exclusiva e o segundo, uma mensagem. A tag de uma mensagem de registro do sistema é uma string curta que indica o componente do sistema que originou a mensagem (por exemplo, ActivityManager ). Uma tag pode ser qualquer string que você ache útil, como o nome da classe em questão.

Uma boa prática geral é declarar uma constante TAG na classe para usar no primeiro parâmetro. Por exemplo, você pode criar uma mensagem de registro de informação assim:

private static final String TAG = "MyActivity";
...
Log.i(TAG, "MyClass.getView() — get item number " + position);

Observação: nomes de tag com mais de 23 caracteres são encurtados na saída do logcat.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)