开源项目 log4android 使用方式详解

话不多说，直接上主题。

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

更多相关文章

随机推荐