开源项目 log4android 使用方式详解

Posted 2020-07-26

话不多说， 直接上主题。

      log4android 是一个类似于log4j的开源android 日志记录项目。 项目基于 microlog 改编而来， 新加入了对文件输出的各种定义方式。

 

项目地址： 点击这里  (https://github.com/lisicnu/Log4Android)

 

使用方式: 

0. 导入包.

    项目已经发布到maven仓库中, 可以直接导入包, 当前版本为 1.0.0

    gradle编译中如下:

         compile ‘com.github.lisicnu:log4android:1.0.0‘ 

 

1. 初始化方法.

    LogManager.init(Context) ,  默认到  assets目录下寻找microlog.properties的文件 对日志进行初始化.

    LogManager.init(Context,int), 打开指定的资源文件进行初始化, 不可指定SD卡文件.

    LogManager.init(Context,int, boolean), 打开指定的文件进行初始化, 可指定SD卡文件.

 

2. 注意点.

    LogManger.isDebug 此属性确定是否是测试模式, 如果是测试模式, 将直接输出到 logcat中, 否则按配置文件进行输出.

    建议使用方式. LogManager.isDebug = BuildConfig.DEBUG;  此值默认为true.

 

3. 使用方式.

    调用 LogManager.v(String ,Object). 等方法进行日志记录. 使用方式和 android.utl.Log 方法一样.

 

4. 配置文件

完整配置文件例子:

     microlog.formatter=PatternFormatter
     microlog.formatter.PatternFormatter.pattern=%i %c %d [%P] %m %T
     microlog.appender=FileAppender
     microlog.appender.FileAppender.File=logs
     microlog.appender.FileAppender.Options=%a %f-yyyyMMdd
     microlog.level=DEBUG
     microlog.addDefaultLogger=true

 

     其中, PatternFormater 中的 含义如下

        %i :  // 输出设置的clientId.
        %c :  // 输出logger的名称.
        %d :  // 输出绝对时间
        %m :  // 输出消息
        %P :  // 输出等级, 如 DEBUG, WARNING, ERROR 等.
        %r :  // 输出从设置之后的相对时间.
        %t :  // 输出线程名
        %T :  // 输出 throwable的详细信息.
        %% :  // 输出 %.

microlog.appender.FileAppender.File  此属性设置文件夹名称, 默认路径为程序外置sd卡数据目录下的logs文件夹.
microlog.appender.FileAppender.Options  设置输出文件的属性.

        %a :  // 追加到日志文件中. 如果没有,则创建新文件.
        %f :  // 指定使用日期为文件命名,后可能具体的日期格式. 如 yyyyMMddHHmmss, yyyMMddHHmm等. e.g. %f-yyyyMMddHHmmss
        %p :  // 使用固定文件名, 当文件大小达到最大时,默认追加数字索引. 当使用此属性时, microlog.appender.FileAppender.File将被识别为文件名的前缀.
        %s :  // 文件的最大大小, 单位为 M. 0 或者不设置表示不分割文件. 如 %s-0.5