Repolode
JakeWharton

JakeWharton/timber

Android 플랫폼 Log 클래스를 플러그형 Tree 백엔드로 감싸는 작고 확장 가능한 로깅 라이브러리입니다.

스타
10,852
포크
994
열린 이슈
63
마지막 커밋
3일 전

어떤 프로젝트인가요?

Timber는 Android 플랫폼의 android.util.Log 클래스 위에서 동작하는 로깅 라이브러리입니다. 매번 태그를 직접 지정해 Log를 호출하는 대신 Timber의 static 메서드를 호출하며, 동작 방식은 앱 시작 시 설치하는 Tree 인스턴스로 결정됩니다.

기본 제공되는 DebugTree는 호출한 클래스 이름을 로그 태그로 자동 사용하므로 Pidcat 같은 도구로 로그를 쉽게 필터링할 수 있습니다. 기본으로 설치되는 Tree가 없기 때문에 프로덕션 로깅 동작은 전적으로 앱에서 제어합니다. 개발자는 메시지를 크래시 리포팅이나 다른 대상으로 전달하는 커스텀 Tree를 구현할 수 있습니다.

Timber에는 포맷 문자열의 인수 개수 및 타입 불일치, 지나치게 긴 태그, Timber 대신 Log를 직접 사용하는 경우, 불필요한 예외 메시지 로깅을 감지하는 Android Lint 규칙도 포함되어 있습니다.

핵심 기능

  • 01앱 시작 시 설치하는 플러그형 Tree 인스턴스를 통해 로그를 전달합니다.
  • 02DebugTree는 호출한 클래스 이름을 로그 태그로 자동 사용합니다.
  • 03기본 Tree를 제공하지 않아 프로덕션 로깅을 앱에서 제어할 수 있습니다.
  • 04포맷 인수, 태그 길이, Log 사용을 검사하는 Lint 규칙이 포함되어 있습니다.

활용 사례

  • Android 앱에서 여러 곳에 흩어진 android.util.Log 호출을 일관된 로깅 API로 대체합니다.
  • 커스텀 Tree를 통해 프로덕션 빌드의 로그를 크래시 리포팅 서비스로 전송합니다.
  • Pidcat 또는 유사한 도구로 클래스 이름을 기준으로 디버그 로그를 필터링합니다.

빠른 시작

  1. 1

    README의 Timber 의존성을 Gradle 빌드에 추가합니다

  2. 2

    애플리케이션의 onCreate에서 Tree를 설치한 다음 Timber의 static 메서드를 호출합니다

사용 전 알아둘 점

  • 플랫폼의 Log 클래스를 기반으로 하며 Android 전용입니다.
  • 기본적으로 Tree가 설치되지 않으므로 직접 Tree를 심지 않으면 로그가 기록되지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

timber은(는) 무엇인가요?
Android 플랫폼 Log 클래스를 플러그형 Tree 백엔드로 감싸는 작고 확장 가능한 로깅 라이브러리입니다. Timber는 Android 플랫폼의 android.util.Log 클래스 위에서 동작하는 로깅 라이브러리입니다. 매번 태그를 직접 지정해 Log를 호출하는 대신 Timber의 static 메서드를 호출하며, 동작 방식은 앱 시작 시 설치하는 Tree 인스턴스로 결정됩니다.
timber은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
timber은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
timber은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. timber의 마지막 커밋은 2026년 11월 4일입니다.
timber은(는) 어디에 사용할 수 있나요?
Android 앱에서 여러 곳에 흩어진 android.util.Log 호출을 일관된 로깅 API로 대체합니다. 커스텀 Tree를 통해 프로덕션 빌드의 로그를 크래시 리포팅 서비스로 전송합니다. Pidcat 또는 유사한 도구로 클래스 이름을 기준으로 디버그 로그를 필터링합니다.
timber는 어떻게 설치하나요?
README의 Timber 의존성을 Gradle 빌드에 추가합니다 애플리케이션의 onCreate에서 Tree를 설치한 다음 Timber의 static 메서드를 호출합니다
timber은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/JakeWharton/timber

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트