Repolode
JakeWharton

JakeWharton/timber

Una biblioteca de logging pequeña y extensible para Android que integra la clase Log de la plataforma mediante backends Tree configurables.

Estrellas
10,854
Forks
995
Issues abiertos
63
Último commit
anteayer

¿Qué es?

Timber es una biblioteca de logging para Android que se basa en la clase android.util.Log de la plataforma. En vez de llamar a Log directamente con una etiqueta manual cada vez, se usan los métodos estáticos de Timber; el comportamiento lo determinan las instancias de Tree que se instalan al iniciar la aplicación.

El DebugTree incluido usa automáticamente el nombre de la clase desde la que se llama como etiqueta del log, lo que facilita filtrarlos con herramientas como Pidcat. De forma predeterminada no se instala ningún Tree, así que el comportamiento del logging en producción queda totalmente bajo el control de la aplicación. Los desarrolladores pueden crear implementaciones personalizadas de Tree para enviar los mensajes a servicios de informes de fallos u otros destinos.

Timber también incluye reglas de Android Lint que detectan discrepancias en la cantidad y el tipo de argumentos de las cadenas de formato, etiquetas demasiado largas, el uso directo de Log en lugar de Timber y el registro redundante del mensaje de una excepción.

Funciones clave

  • 01Envía los logs mediante instancias de Tree configurables que se instalan al iniciar la aplicación.
  • 02DebugTree usa automáticamente el nombre de la clase desde la que se llama como etiqueta del log.
  • 03No incluye ningún Tree predeterminado, por lo que la aplicación controla el logging en producción.
  • 04Incluye reglas de Lint para los argumentos de formato, la longitud de las etiquetas y el uso de Log.

Casos de uso

  • Sustituir llamadas dispersas a android.util.Log por una API de logging coherente en una aplicación Android.
  • Enviar logs de una compilación de producción a un servicio de informes de fallos mediante un Tree personalizado.
  • Filtrar logs de depuración por nombre de clase con Pidcat u otras herramientas similares.

Inicio rápido

  1. 1

    Añade la dependencia de Timber indicada en el README a tu compilación de Gradle

  2. 2

    Instala un Tree en el onCreate de tu aplicación y luego llama a los métodos static de Timber

Antes de usarlo

  • Está diseñado solo para Android y se basa en la clase Log de la plataforma.
  • No se instala ningún Tree de forma predeterminada, así que debes instalar uno; de lo contrario, no se registrará nada.

En colecciones

Temas

Preguntas frecuentes

¿Qué es timber?
Una biblioteca de logging pequeña y extensible para Android que integra la clase Log de la plataforma mediante backends Tree configurables. Timber es una biblioteca de logging para Android que se basa en la clase android.util.Log de la plataforma. En vez de llamar a Log directamente con una etiqueta manual cada vez, se usan los métodos estáticos de Timber; el comportamiento lo determinan las instancias de Tree que se instalan al iniciar la aplicación.
¿timber es gratuito? ¿Qué licencia tiene?
timber es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿timber sigue mantenido?
Mantenimiento activo. El último commit de timber fue el 4 nov 2026.
¿Para qué puedo usar timber?
Sustituir llamadas dispersas a android.util.Log por una API de logging coherente en una aplicación Android. Enviar logs de una compilación de producción a un servicio de informes de fallos mediante un Tree personalizado. Filtrar logs de depuración por nombre de clase con Pidcat u otras herramientas similares.
¿Cómo se instala timber?
Añade la dependencia de Timber indicada en el README a tu compilación de Gradle Instala un Tree en el onCreate de tu aplicación y luego llama a los métodos static de Timber
¿Dónde consigo timber?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/JakeWharton/timber

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados