话不多说, 直接上主题。
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