项目地址：https://github.com/orhanobut/logger

2.0.0的重要更新

特地提一下，这是今年更新的2.0.0版本，上一次更新还是2015年，目前最新的版本是2.1.1，那现在的Logger发生了怎样的变化呢？

引入

compile 'com.orhanobut:logger:2.1.1'

改变之处

初始化

之前是初始化Logger是这样的：

private static final String TAG = "APPLOG";
@Override
public void onCreate() {
    super.onCreate();
    Logger.init(TAG);  //初始化需要打印log时，默认是LogLevel.FULL
//    Logger.init(TAG).logLevel(LogLevel.NONE); //上线后不需要打印log时
}

而现在是这样的：

private static final String TAG = "APPLOG";
@Override
public void onCreate() {
    super.onCreate();
    initLogger(TAG);
}
private void initLogger(String tag) {
    FormatStrategy formatStrategy = PrettyFormatStrategy.newBuilder()
            .tag(tag) // 全局tag
            .build();
    Logger.addLogAdapter(new AndroidLogAdapter(formatStrategy) {
        @Override
        public boolean isLoggable(int priority, String tag) {
            return BuildConfig.DEBUG;
        }
    });
}

初始化的时候如果使用默认配置，只需要addLogAdapter就可以Logger.addLogAdapter(new AndroidLogAdapter())，当然也可以像上面的代码一样，添加自定义的TAG。

配置策略

利用PrettyFormatStrategy.newBuilder还有更高级的设置，如：

FormatStrategy formatStrategy = PrettyFormatStrategy.newBuilder()
  .showThreadInfo(false)  // 是否显示线程信息，默认 显示
  .methodCount(0)         // 方法栈打印的个数，默认是 2
  .methodOffset(7)        // 设置调用堆栈的函数偏移值，默认是 5
  .logStrategy(customLog) // 设置log打印策略，默认是 LogCat
  .tag("My custom tag")   // 设置全局TAG，默认是 PRETTY_LOGGER
  .build();
Logger.addLogAdapter(new AndroidLogAdapter(formatStrategy ));

在AndroidLogAdapter中新增isLoggable方法，根据返回的boolean值来控制是否打印log，而这里用的是BuildConfig.DEBUG，即在release版本中就不打印了。

for (LogAdapter adapter : logAdapters) {
  if (adapter.isLoggable(priority, tag)) {
    adapter.log(priority, tag, message);
  }
}

保存log

当log日志是需要保存时，可以调用Logger.addLogAdapter(new DiskLogAdapter())，利用DiskLogStrategy就可以将log日志输出到文件中了，同样也可以添加自定义TAG。

FormatStrategy formatStrategy = CsvFormatStrategy.newBuilder()
  .tag("custom")
  .build();
Logger.addLogAdapter(new DiskLogAdapter(formatStrategy));

Logger最新结构分析图

特性保留

• Logger.d("debug");
• Logger.e("error");
• Logger.w("warning");
• Logger.v("verbose");
• Logger.i("information");
• Logger.wtf("wtf!!!!");
  支持一次性使用的tag
• Logger.t("tag").d("debug");
  支持打印带参数的字符串
• Logger.d("hello %s", "world");
  支持打印Collections (仅限debug logs)
• Logger.d(MAP);
• Logger.d(SET);
• Logger.d(LIST);
• Logger.d(ARRAY);
  支持打印JSON和XML (以debug log展示)
• Logger.json(JSON_CONTENT);
• Logger.xml(XML_CONTENT);

Logger打印的样式

感悟

这次的更新让Logger结构更加清晰，功能更加丰富，佩服作者的设计思路和开发技巧，不愧是有那么多star。