开源项目 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