Timberとは？AndroidログをTreeで整理するKotlinライブラリ

ページ内ナビ

概要

Timberは、Android標準のLogの上に小さな拡張可能APIを提供するログライブラリです。アプリの起動時にTreeを登録し、各所ではTimberのメソッドを呼ぶ構成にすることで、開発中のLogcat出力と本番向けの独自処理を切り替えられます。呼び出し元をタグにするDebugTreeと、よくある誤用を検出するLintも備えています。

特徴と向いている用途

公式資料に基づく紹介・実機未検証 · 内容確認日：2026-10-04

主な特徴

ログの呼び出し側と出力処理をTreeで分離する

Timber.plantでTreeを早い段階に登録すると、アプリ内ではTimber.dなどの共通APIからログを送れます。DebugTreeは呼び出し元のクラスを自動で特定してタグに使います。用途に合わせたTreeを実装すれば、保存先や外部報告などの処理を呼び出し側から分離できます。組み込みLintは引数数・型の不一致、文字列連結、Android Logの直接利用などを検出します。

出典：[1]

向いている用途

Androidアプリ全体のログ方針を一か所で切り替えたい場合に向く

多数の画面や機能から同じログAPIを使いながら、デバッグ版では読みやすいLogcat出力、本番版では選別した報告処理へ切り替えたいAndroidアプリに向きます。ログ呼び出しの書式をLintで継続的に点検したいチームにも適しています。

出典：[1]

導入前の確認

Treeは自動登録されないため、ビルド種別ごとの方針を実装する

初期状態ではTreeが一つも登録されず、どのログをどこへ出すかは利用側が決めます。READMEはTreeをApplication.onCreateなどの早い段階で登録する構成を示しています。本番でDebugTreeを無条件に使うのではなく、機密情報や不要なログを外部へ送らない設計が必要です。安定版は5.0.1で、READMEにある5.1.0-SNAPSHOTは開発版として別のリポジトリを要求します。ライセンスはApache-2.0です。

出典：[1][2][3]

参考にした公式資料

[1]JakeWharton/timber — README(2026-10-04)
[2]Timber 5.0.1 release(2026-10-04)
[3]JakeWharton/timber — LICENSE(2026-10-04)

編集部からの補足

Android標準のLogを直接呼ぶ箇所を散在させず、出力方針をTreeへ集約できる点に注目しました。導入時は、デバッグ用と本番用で植えるTreeを明示的に分けてください。

3ステップで試す

1
安定版を依存関係へ追加する
AndroidアプリのモジュールにあるGradle dependenciesブロックへ追加します。
implementation 'com.jakewharton.timber:timber:5.0.1'
2
デバッグ用Treeを起動時に登録する
Application.onCreateなど、ログ呼び出しより前に実行される場所へ置きます。
if (BuildConfig.DEBUG) Timber.plant(Timber.DebugTree())
3
共通APIからログを送る
デバッグ実行し、Logcatで呼び出し元に基づくタグとメッセージを確認します。
Timber.d("Hello from %s", "Timber")

公式READMEで確認

成長

成長の推移 · 直近30日

10,852 Stars

推移データを蓄積中です。

開発アクティビティ

直近90日・週次

Commit（直近30日）: 12
Open PR: 14

開発アクティビティを蓄積中です。

Built with

Kotlin

カテゴリとタグ

GitHubデータ

GitHubのデータGitHubの詳細データを見る

GitHubで見る

Stars: 10,852
Forks: 994
Watchers: 244
Open Issues: 49
Contributors: 48
所有者種別: User
主要言語: Kotlin
ライセンス: Apache-2.0
リポジトリ最終更新: 2026/10/03