Android 日志记录杂谈-Logger,Timber,logback-android

10083523,2560,1600.jpg

首先,希望大家不要喷我。如果哪里不对,希望大家能在下面评论说明下,然后我进行修改。

-----------------------我是不分割不舒服君-----------------------------------------

“Every time you log in production, a puppy dies.” – Jake Wharton

做安卓项目中,调试程序的时候一般会进行打log来查看相关信息,而我原来是使用的系统自带的Log来打印。

归结二个问题:<信息显示>,<信息存储>,就这二个问题我们具体来看如何解决

-----------------------主体分割君---------------------------------------------------

1.信息显示

可能代码中你是这么写的log:Log.v(tag,"XXXX");当项目越来越多了。你查看log的时候发现,这个log信息不知道是哪个文件甚至哪段代码生成的,然后又要回头去找写这段log代码。而且一大片log信息挑出来后你看的眼睛也要花了。这时候我们是不是没办法,只能大海捞针一样来看,或者关键字tag来搜索。答案当然是不用。(这B装的我好累)

所以根据这个情况我网上搜索后,发现挺多推荐Logger,于是我便使用Logger。

看到Logger所能提供的功能:

1.Thread information

2.Class information

3.Method information

4.Pretty-print for json content

5.Pretty-print for new line "\n"

6.Clean output

7.Jump to source

先上Logger源码地址:https://github.com/orhanobut/logger
首先在build.gradle中引入Logger:
compile 'com.orhanobut:logger:1.15'
然后直接在代码中就可以使用Logger了。先看效果:

public class Act_Logger extends Activity{

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
       //设置tagname,可以不写,默认为“PRETTYLOGGER”
      //  Logger.init("tagname");

        String name = "billy";
        Logger.d("你好啊,某某人");
        Logger.d("你好啊,%s",name);
        getString(name);

        ArrayList<UserBean> list = new ArrayList<UserBean>();
        list.add(new UserBean("user1",1));
        list.add(new UserBean("user2",2));
        list.add(new UserBean("user3",3));
        list.add(new UserBean("user4",4));

        Logger.d(list);

    }

    public void getString(String name){
        Logger.e("你好啊,%s",name);
    }
}
屏幕快照 2016-11-24 11.40.22 AM.png

我们从Log信息中可以查看到线程的name,具体到哪个类,哪个方法,都有显示,而且Log信息也十分美观。
而且可以点击跳到相应的代码处。十分方便,同时打印的时候支持Array, Map, Set 和 List。

description.png

什么,你觉得这样也没怎么样?那么如果你想查看一个json的信息,原来的log中json的排版也不(keng)错(die),现在来看看Logger中的json的信息显示。

logger-log.png

瞬间感觉高大上。快给同事们看看。

这里提到一个小功能,为啥

   Logger.d("你好啊,某某人");
   Logger.d("你好啊,%s",name);

都可以支持。

是因为最终都调用了

private String createMessage(String message, Object... args) {      
    return args == null || args.length == 0 ? message : String.format(message, args);
}

然后再用系统的Log来打印字符串。

主要我觉得createMessage这个代码片段可以拿来作为util工具的一个方法挺方便的。就拿来用在自己项目里面了。

2.信息存储

Log如果我们用手机连着电脑调试,这时候是方便,可以一边操作一边查看信息,但是万一是安装到了某个客户手机上,或者某个安卓设备上,这时候你有某个需求需要去知道他的Log的信息,那时候难道你要连着电脑一边操作一边查看Log信息?

这里网上我又查看了下,还是老套路,发现大家推荐Timber。然后我就使用了Timber。这个其实是Log的封装库,废话不多说。脱光衣服直接上。

老套路,先附上Timber的源码地址:
https://github.com/JakeWharton/timber

在build.grade中引入Timber:
compile 'com.jakewharton.timber:timber:4.3.1'

在继承Application的自定义类中,设置Timber的树,其实Timber是类似管理着一片森林,具体用哪棵树是你自己这边决定的。比如Timber自带的是DebugTree这个类。

@Override
public void onCreate() {    
          super.onCreate();    
         //在这里先使用Timber.plant注册一个Tree,然后调用静态的.d .v 去使用     
          if (BuildConfig.DEBUG) {    
                Timber.plant(new Timber.DebugTree());    
          } else {        
                Timber.plant(new FileLoggingTree());    
          }
}

然后就可以使用了

Timber.tag("code_gg");        
Timber.d("test Timber %d",10);

然后上面的FileLoggingTree是我这边自己写的一棵树,就是当我用Timber这个封装库拿到了Log的信息后,后面就可以我们自己处理了。比如写到文件中等。我这边先写了一个傻白甜的FileLoggingTree类,仅供参考。后面我们会用到另外一个第三方,就更强大了。

其中String CacheDiaPath = context.getCacheDir().toString();

private static class FileLoggingTree extends Timber.Tree {
        @Override
        protected void log(int priority, String tag, String message, Throwable t) {
            if (TextUtils.isEmpty(CacheDiaPath)) {
                return;
            }
            File file = new File(CacheDiaPath + "/log.txt");
            Log.v("dyp", "file.path:" + file.getAbsolutePath() + ",message:" + message);
            FileWriter writer = null;
            BufferedWriter bufferedWriter = null;
            try {
                writer = new FileWriter(file);
                bufferedWriter = new BufferedWriter(writer);
                bufferedWriter.write(message);
                bufferedWriter.flush();

            } catch (IOException e) {
                Log.v("dyp", "存储文件失败");
                e.printStackTrace();
            } finally {
                if (bufferedWriter != null) {
                    try {
                        bufferedWriter.close();
                    } catch (IOException e) {
                        e.printStackTrace();
                    }
                }
            }
        }
}

log方法参数一共有int priority, String tag, String message, Throwable t这四个参数,而我这边就是简单的拿了message这个参数的内容,然后保存到了我指定路径下的log.txt文件中。当然Timber可以自己封装.

比如还有记录崩溃信息的树

 /**
     * A tree which logs important information for crash reporting.
     */
    private static class CrashReportingTree extends Timber.Tree {
        @Override
        protected void log(int priority, String tag, String message, Throwable t) {
            if (priority == Log.VERBOSE || priority == Log.DEBUG) {
                return;
            }
            FakeCrashLibrary.log(priority, tag, message);
            if (t != null) {
                if (priority == Log.ERROR) {
                    FakeCrashLibrary.logError(t);
                } else if (priority == Log.WARN) {
                    FakeCrashLibrary.logWarning(t);
                }
            }
        }
    }

当然我觉得我写的挺low的。后来我又去查看了一些能写到文件中的log的第三方。发现了logback-android。
logback-android很强大,可以存储信息到
-files
-SQLite databases
-logcat
-sockets
-syslog
-email

所以我们可以用Timber配合logback-android来模拟存储到文件中。

首先又是老样子,附上logback-android源码地址:
https://github.com/tony19/logback-android

第一步:引入logback-android

Gradle

// only needed for SNAPSHOT builds
repositories {
  maven { url 'https://oss.sonatype.org/content/repositories/snapshots' }
}

dependencies {
  compile 'org.slf4j:slf4j-api:1.7.21'
  compile 'com.github.tony19:logback-android-core:1.1.1-6'
  compile 'com.github.tony19:logback-android-classic:1.1.1-6'
}

第二步:在以下位置创建一个logback.xml文件,默认情况下这个路径和文件名是固定的

Paste_Image.png

第三步:配置logback文件

<!--debug属性用来决定是否打印logback的日志信息-->
<configuration debug='false'>

    <!--声明一个属性,用来指定log文件存放的路径-->
    <property name="LOG_DIR" value="/sdcard/rlog"/>

    <!--声明一个时间戳-->
    <timestamp datePattern="yyyyMMdd" key="today"/>

    <!--用于在控制台输出的Appender-->
    <appender name="LOGCAT" class="ch.qos.logback.classic.android.LogcatAppender">
        <encoder>
            <pattern>%-5relative [%thread][%file:%M:%line] - %msg%n</pattern>
        </encoder>
    </appender>

    <!--声明一个FileAppender-->
    <appender name="BASE_FILE" class="ch.qos.logback.core.FileAppender">
        <!--初始化的时候不创建文件,在第一次使用的时候创建文件-->
        <lazy>true</lazy>
        <!--log追加到文件,否则覆盖文件-->
        <append>true</append>
        <!--用来保存log的文件全路径-->
        <file>${LOG_DIR}/base.log</file>
        <!--输出log的格式-->
        <encoder>
            <!--<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} [%file:%line] - %msg%n</pattern>-->
            <pattern>%date [%thread] %-5level %logger{36} [%file:%line] - %msg%n</pattern>
        </encoder>
    </appender>

    <!--声明一个RollingFileAppender-->
    <appender name="BASE_ROLL_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_DIR}/base.roll.${today}.log</file>
        <append>true</append>
        <encoder>
            <pattern>%date %-5relative [%thread] %-5level %logger{36} [%file:%M:%line] - %msg%n
            </pattern>
        </encoder>

        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_DIR}/base.roll.%d{yyyy-MM-dd}.log</fileNamePattern>
            <!--最大保存7天的日志-->
            <maxHistory>7</maxHistory>
        </rollingPolicy>

        <!--文件大于10mb,切换文件-->
        <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
            <maxFileSize>10MB</maxFileSize>
        </triggeringPolicy>
    </appender>

    <!--指定logtest采用BASE_ROLL_FILE声明的RollingFileAppender输出日志-->
    <logger name="logtest">
        <appender-ref ref="BASE_ROLL_FILE"/>
    </logger>

    <!-- Write INFO (and higher-level) messages to the log file -->
    <root level="TRACE">
        <appender-ref ref="LOGCAT"/>
    </root>

    <!--支持的level-->
    <!--TRACE-->
    <!--DEBUG-->
    <!--INFO-->
    <!--WARN-->
    <!--ERROR-->

    <!--<pattern>
      %d{yyyy-MM-dd HH:mm:ss} [%level] - %msg%n
      Logger: %logger
      Class: %class
      File: %file
      Caller: %caller
      Line: %line
      Message: %m
      Method: %M
      Relative: %relative
      Thread: %thread
      Exception: %ex
      xException: %xEx
      nopException: %nopex
      rException: %rEx
      Marker: %marker
      %n
  </pattern>-->

    <!--引用其他位置的配置信息-->
    <!--<includes>-->
    <!--<include file="/sdcard/foo.xml"/>-->
    <!--<include resource="assets/config/test.xml"/>-->
    <!--<include resource="AndroidManifest.xml"/>-->

    <!--<include file="/sdcard/logback/logback-test.xml"/>-->
    <!--<include file="/sdcard/logback/logback.xml"/>-->
    <!--<include resource="AndroidManifest.xml"/>-->
    <!--<include resource="assets/logback-test.xml"/>-->
    <!--<include resource="assets/logback.xml"/>-->
    <!--</includes>-->
</configuration>

还有其他的appender提供,详细说明移步: http://logback.qos.ch/manual/appenders.html

第四步:
可以在代码里面使用logback-android了

//以下日志只会在控制台输出
//        Logger logger = LoggerFactory.getLogger(MainActivity.class);
//        logger.trace("angcyo-->{}","trace");
//        logger.debug("angcyo-->{}","debug");
//        logger.info("angcyo-->{}","info");
//        logger.warn("angcyo-->{}","warn");
//        logger.error("angcyo-->{}","error");

//以下日志会在BASE_ROLL_FILE声明的文件中输出,并且也会在控制台输出
        Logger logger = LoggerFactory.getLogger("logtest");
        logger.trace("angcyo-->{}","trace");
        logger.debug("angcyo-->{}","debug");
        logger.info("angcyo-->{}","info");
        logger.warn("angcyo-->{}","warn");
        logger.error("angcyo-->{}","error");

保存在文件中的Log信息:

Paste_Image.png

现在可以用logback-android 来写一颗树供Timber来使用:

public class FileLoggingTree extends Timber.DebugTree {

    static Logger mLogger = LoggerFactory.getLogger(FileLoggingTree.class);

    @Override
    protected void log(int priority, String tag, String message, Throwable t) {
        if (priority == Log.VERBOSE) {
            return;
        }

        String logMessage = tag + ": " + message;
        switch (priority) {
            case Log.DEBUG:
                mLogger.debug(logMessage);
                break;
            case Log.INFO:
                mLogger.info(logMessage);
                break;
            case Log.WARN:
                mLogger.warn(logMessage);
                break;
            case Log.ERROR:
                mLogger.error(logMessage);
                break;
        }
    }
}

然后再调用Timber.plant(new FileLoggingTree());就可以了。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,716评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,558评论 1 294
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,431评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,127评论 0 209
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,511评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,692评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,915评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,664评论 0 202
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,412评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,616评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,105评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,424评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,098评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,096评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,869评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,748评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,641评论 2 271

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,569评论 25 707
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,100评论 18 139
  • afinalAfinal是一个android的ioc,orm框架 https://github.com/yangf...
    passiontim阅读 15,088评论 2 44
  • 共享|全球化|品质生活|环保 庄游,创建于2015年,致力于构建中国用户与丰富的全球自然资源的桥梁,使用户共享全球...
    庄游塞坦庄园阅读 557评论 2 0
  • cc349d22ab8e阅读 180评论 0 0