Android Log输出框架
- 规范LOG输出;
- 控制拦截应用中所有LOG输出；
- 可根据LOG TAG或全局定制LOG输出风格；
- 可定制相关LOG输出时携带的调试信息(方法调用链/线程信息等)；
- 可格式化输出JSON/XML/DataObject等数据格式；
在gradle中引入Logger
dependencies {
compile 'com.devyok.logger:logger:1.0.0'
}
在Application#onCreate中配置Logger
Logger.config(new Configuration().setDebug(false)
.setOutputThreadInfo(true)
.setMethodStackTraceDepth(2)
.setOutputCodeLine(true));
使用Logger提供的接口
Logger.info(LOG_TAG,"onCreate info enter");
Logger.debug(LOG_TAG,"onCreate debug enter");
Logger.error(LOG_TAG,"onCreate error enter");
Logger.verbose(LOG_TAG,"onCreate verbose enter");
配置如下：
//方法的参数值表示要抓取方法调用的深度
Logger.config(new Configuration().setMethodStackTraceDepth(2));
以下信息是随着Log一起输出到logcat
method trace[Instrumentation.callActivityOnCreate:1080->Activity.performCreate:5104->MainActivity.onCreate:19]
说明： “MainActivity.onCreate:19” ， MainActivity.onCreate (类名.方法名)：19 (代码行)， 表示log是在MainActivity#onCreate方法的19行输出的。 -> 表示调用关系，从Activity.performCreate 5104行调用了MainActivity.onCreate,log输出是在onCreate的19行。
配置如下：
Logger.config(new Configuration().setOutputCodeLine(true));
以下信息是随着Log一起输出到logcat
code line[MainActivity.onCreate:19]
说明： “MainActivity.onCreate:19” ， MainActivity.onCreate (类名.方法名)：19 (代码行)， 表示log是在MainActivity#onCreate方法的19行输出的。
配置如下：
Logger.config(new Configuration().setOutputThreadInfo(true));
以下信息是随着Log一起输出到logcat
thread infos[id = 1,name = main,state = RUNNABLE,isDaemon = false,priority = 5]
配置如下：
Logger.config(new Configuration().setDebug(true));
开启之后将能够输出所有通过Logger.debug输出的LOG
配置如下：
Logger.config(new Configuration().addLogOutputterClass(CustomLogOutputer.class));
自定义输出类
CustomLogOutputer.java
//在输出所有LOG时，添加分割线(**与##)
public class CustomLogOutputer extends AbstractLogOutputter{
@Override
public boolean onOutput(int priority, String tag, String msg) {
Log.i(tag,"******************");
System.out.println("msg = " + msg);
Log.i(tag,"#################");
return true;
}
}
配置如下：
Logger.config(new Configuration().setLogFormatterClass(CustomLogFormatter.class));
自定义扩展
//扩展输出信息
public class CustomLogFormatter extends DefaultLogFormatter{
@Override
protected String buildExtInofs(Configuration cfg) {
if(cfg instanceof CustomConfiguration) {
CustomConfiguration cuscfg = (CustomConfiguration) cfg;
if(cuscfg.isOutputPhoneInfos()){
StringBuffer extInfos = new StringBuffer();
String brand = Build.BRAND;
String product = Build.PRODUCT;
extInfos.append("phone infos[")
.append("brand = ").append(brand).append(",")
.append("product = ").append(product)
.append("]");
return extInfos.toString();
}
}
return "";
}
}
配置如下：
Logger.config(new Configuration().setLogFormatterClass(CustomLogFormatter.class),"tagName");
经过以上配置之后，tagName针对的log tag将以此配置为准进行输出。
-
输出DataObject
User user = new User(); user.setAddress("bj"); user.setId("1"); user.setAge(30); user.setName("devyok"); Logger.debug("tag",user, Logger.DataType.BEAN); -
输出Json
JSONObject jsonObject = new JSONObject(); jsonObject.put("age","10"); jsonObject.put("name","dw"); Logger.info("tag",jsonObject.toString(), Logger.DataType.JSON); -
输出Xml
Logger.info("tag","<xml></xml>", Logger.DataType.XML);
如果你使用了proguard来优化工程，你需要添加以下设置
-keep class com.devyok.logger.** { *; }
Logger is released under the Apache 2.0 license.
Copyright (C) 2017 DengWei.