RepositoryKotlinUSUnited States
JA

JakeWharton/timber

A logger with a small, extensible API which provides utility on top of Android's normal Log class.

10.9kstars
995forks
49issues
4views

🪵 Timber – Logger Android nhỏ gọn, mạnh mẽ từ Jake Wharton

Timber là lớp wrapper mỏng trên Android Log, thêm tiện ích qua Tree để logging linh hoạt.

Timber là một logger có API nhỏ gọn và có khả năng mở rộng, xây dựng trên lớp Log của Android. Jake Wharton từng copy lớp này vào từng ứng dụng nhỏ, đến khi quyết định biến nó thành thư viện để tránh lặp lại công việc.

✨ Điểm nổi bật

  • Tree-based logging: Thêm hành vi logging thông qua Tree, cài đặt bằng Timber.plant.
  • DebugTree tự động tag: Tự lấy tên lớp gọi làm tag, phù hợp với công cụ đọc log như Pidcat.
  • Không cài đặt Tree mặc định: Tránh log trong production – “mỗi lần log, một con chó con chết”.
  • Lint rules tích hợp: Kiểm tra lỗi định dạng, độ dài tag, dùng Log thay vì Timber, v.v.
  • String format tự động: Không cần String.format hay nối chuỗi trong lời gọi log.
  • Cài đặt đơn giản: Chỉ cần plant(Tree) trong onCreate và dùng các phương thức tĩnh của Timber.

💡 Vì sao đáng chú ý

Không chỉ là wrapper, Timber mang lại cách tiếp cận khác biệt: logging được kiểm soát qua Tree, dễ dàng tùy biến theo môi trường (debug/release). Kết hợp với các quy tắc lint tích hợp, Timber giúp giảm lỗi formatting và cải thiện chất lượng code. Đây là lựa chọn lý tưởng cho bất kỳ dự án Android nào cần quản lý log rõ ràng và an toàn.


#Android #Logging #Kotlin #JakeWharton #TiniX