Timber

JakeWharton

Timber

使用方法

编译环境

• 只有一个400多行的类，可以单独把它复制出来放项目里，也可以通过Gradle引用

compile 'com.jakewharton.timber:timber:3.1.0'

API

• 定义一个Log树

public class MyApp extends Application { 
    @Override
    public void onCreate() {
        super.onCreate();
        if (BuildConfig.DEBUG) {
            Timber.plant(new Timber.DebugTree());
        } else {
            Timber.plant(new CrashReportingTree());
        }
    }
}

• 使用，拥有Log的d v i e w 方法，但不需要传入tag

Timber.d("Activity Created");

• 定义临时tag

Timber.tag("MainActivity");

原理

• Tree

  之前的d v i e w 方法汇总

/**
 * {@param priority} Log.ERROR Log.WARN
 */
private void prepareLog(int priority, Throwable t, String message, Object... args) {
    // 1. 日志级别
    if (!isLoggable(priority)) return;

    // 2. message校验处理

    // 3. 获取tag
    String tag = getTag();

    // 4. 输出日志
    log(priority, tag, message, t);
}

// 1. 自定义优先级
protected boolean isLoggable(int priority) {
    return true;
}

// 3. 获取tag：线程内传参
private final ThreadLocal<String> explicitTag = new ThreadLocal<String>();

String getTag() {
    String tag = explicitTag.get();
    if (tag != null) {
        explicitTag.remove();
    }
    return tag;
}

// 实现真正的日志方法，如默认实现的DebugTree用Log，切割字符串等
protected abstract void log(int priority, String tag, String message, Throwable t);

• 森林

private static final List<Tree> FOREST = new CopyOnWriteArrayList<Tree>();

public static void plant(Tree tree) {...}
public static void uprootAll() {
    FOREST.remove(tree)
}

Hugo

有时候需要打印方法的传参和返回值，甚至方法的执行时间，一个个拼接很麻烦，此时只要在方法上加上@DebugLog 就可以自动实现

其他

• WebViewFragment WebView使用的正确姿势

• PhoneNumberUtils 和 PhoneNumberFormattingTextWatcher Android 不为人知的API