Repolode
Enviar
JakeWharton

JakeWharton/timber

Uma biblioteca de logging pequena e extensível para Android, que encapsula a classe Log da plataforma com backends Tree configuráveis.

Ver no GitHubSite
Estrelas
10,854
Forks
995
Issues abertas
63
Último commit
anteontem

O que é?

Timber é uma biblioteca de logging para Android que se apoia na classe android.util.Log da plataforma. Em vez de chamar Log diretamente e informar uma tag manualmente a cada vez, você chama os métodos estáticos de Timber, e o comportamento é definido pelas instâncias de Tree instaladas na inicialização do app.

O DebugTree incluído usa automaticamente o nome da classe que faz a chamada como tag do log, facilitando a filtragem com ferramentas como o Pidcat. Nenhum Tree é instalado por padrão, então o comportamento dos logs em produção fica inteiramente sob o controle do app. Os desenvolvedores podem criar implementações personalizadas de Tree para encaminhar mensagens a serviços de relatórios de falhas ou outros destinos.

Timber também inclui regras do Android Lint que sinalizam incompatibilidades na quantidade e nos tipos de argumentos em strings de formato, tags muito longas, uso direto de Log em vez de Timber e registro redundante de mensagens de exceção.

Recursos principais

  • 01Encaminha logs por instâncias de Tree configuráveis, instaladas na inicialização do app.
  • 02DebugTree usa automaticamente o nome da classe que faz a chamada como tag do log.
  • 03Não inclui um Tree padrão, deixando os logs de produção sob o controle do app.
  • 04Inclui regras do Lint para argumentos de formato, tamanho de tags e uso de Log.

Casos de uso

  • Substituir chamadas dispersas a android.util.Log por uma API de logging consistente em um app Android.
  • Enviar logs de uma build de produção para um serviço de relatórios de falhas usando um Tree personalizado.
  • Filtrar logs de debug pelo nome da classe com Pidcat ou ferramentas semelhantes.

Início rápido

  1. 1

    Adicione a dependência do Timber indicada no README ao seu build do Gradle

  2. 2

    Instale um Tree no onCreate do seu aplicativo e, em seguida, chame os métodos static do Timber

Antes de usar

  • Foi desenvolvido somente para Android, com base na classe Log da plataforma.
  • Nenhum Tree é instalado por padrão, então você precisa instalar um; caso contrário, nada será registrado.

Em coleções

Apps para Android e ferramentas para celularPlataformas de OpenTelemetry e observabilidadeLinters e formatadores de código

Tópicos

#android#logging#kotlin#debugging#lint

Perguntas frequentes

O que é timber?
Uma biblioteca de logging pequena e extensível para Android, que encapsula a classe Log da plataforma com backends Tree configuráveis. Timber é uma biblioteca de logging para Android que se apoia na classe android.util.Log da plataforma. Em vez de chamar Log diretamente e informar uma tag manualmente a cada vez, você chama os métodos estáticos de Timber, e o comportamento é definido pelas instâncias de Tree instaladas na inicialização do app.
timber é gratuito? Qual é a licença?
timber é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
timber ainda é mantido?
Manutenção ativa. O último commit de timber foi em 4 de nov. de 2026.
Para que posso usar timber?
Substituir chamadas dispersas a android.util.Log por uma API de logging consistente em um app Android. Enviar logs de uma build de produção para um serviço de relatórios de falhas usando um Tree personalizado. Filtrar logs de debug pelo nome da classe com Pidcat ou ferramentas semelhantes.
Como instalar timber?
Adicione a dependência do Timber indicada no README ao seu build do Gradle Instale um Tree no onCreate do seu aplicativo e, em seguida, chame os métodos static do Timber
Onde consigo timber?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/JakeWharton/timber

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados