項目地址：https://github.com/orhanobut/logger
2.0.0的重要更新
特地提一下，這是今年更新的2.0.0版本，上一次更新還是2015年，目前最新的版本是2.1.1，那現(xiàn)在的Logger發(fā)生了怎樣的變化呢？
引入
compile 'com.orhanobut:logger:2.1.1'
改變之處
初始化
之前是初始化Logger是這樣的：
private static final String TAG = "APPLOG";
@Override
public void onCreate() {
super.onCreate();
Logger.init(TAG); //初始化需要打印log時，默認(rèn)是LogLevel.FULL
// Logger.init(TAG).logLevel(LogLevel.NONE); //上線后不需要打印log時
}
而現(xiàn)在是這樣的：
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;
}
});
}
初始化的時候如果使用默認(rèn)配置，只需要addLogAdapter就可以Logger.addLogAdapter(new AndroidLogAdapter())，當(dāng)然也可以像上面的代碼一樣，添加自定義的TAG。
配置策略
利用PrettyFormatStrategy.newBuilder還有更高級的設(shè)置，如：
FormatStrategy formatStrategy = PrettyFormatStrategy.newBuilder()
.showThreadInfo(false) // 是否顯示線程信息，默認(rèn) 顯示
.methodCount(0) // 方法棧打印的個數(shù)，默認(rèn)是 2
.methodOffset(7) // 設(shè)置調(diào)用堆棧的函數(shù)偏移值，默認(rèn)是 5
.logStrategy(customLog) // 設(shè)置log打印策略，默認(rèn)是 LogCat
.tag("My custom tag") // 設(shè)置全局TAG，默認(rèn)是 PRETTY_LOGGER
.build();
Logger.addLogAdapter(new AndroidLogAdapter(formatStrategy ));
在AndroidLogAdapter中新增isLoggable方法，根據(jù)返回的boolean值來控制是否打印log，而這里用的是BuildConfig.DEBUG，即在release版本中就不打印了。
for (LogAdapter adapter : logAdapters) {
if (adapter.isLoggable(priority, tag)) {
adapter.log(priority, tag, message);
}
}
保存log
當(dāng)log日志是需要保存時，可以調(diào)用Logger.addLogAdapter(new DiskLogAdapter())，利用DiskLogStrategy就可以將log日志輸出到文件中了，同樣也可以添加自定義TAG。
FormatStrategy formatStrategy = CsvFormatStrategy.newBuilder()
.tag("custom")
.build();
Logger.addLogAdapter(new DiskLogAdapter(formatStrategy));
Logger最新結(jié)構(gòu)分析圖
特性保留
- Logger.d("debug");
- Logger.e("error");
- Logger.w("warning");
- Logger.v("verbose");
- Logger.i("information");
- Logger.wtf("wtf!!!!");
支持一次性使用的tag - Logger.t("tag").d("debug");
支持打印帶參數(shù)的字符串 - 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結(jié)構(gòu)更加清晰，功能更加豐富，佩服作者的設(shè)計思路和開發(fā)技巧，不愧是有那么多star。
