1. Features

支持直接打印数据集合, 如List、Set、Map、数组等

全局配置log输出, 个性化设置Tag

准确显示调用方法、行，快速定位日志所在文件位置

支持android系统复杂对象Intent、Bundle、Message等打印

提供空实现 release-no-op版本

支持高性能日志写入文件(基于mmap)

兼容Android Studio 3.1 日志格式

2. screenshot

日志说明
image.png
个性化设置Tag
image.png
打印数据列表
打印数组
image.png
打印对象本身属性和继承的属性
image.png
打印系统对象Intent
image.png
// 输出字符串
LogUtils.d("12345");
// 输出参数
LogUtils.d("12%s3%d45", "a", 0);
// 输出异常
LogUtils.d(new NullPointerException("12345"));
// 输出对象
Person person = new Person();
person.setAge(11);
person.setName("pengwei");
person.setScore(37.5f);
LogUtils.d(person);
// 对象为空
LogUtils.d(null);
// 输出json(json默认debug打印)
String json = "{'a':'b','c':{'aa':234,'dd':{'az':12}}}";
LogUtils.json(json);
// 打印数据集合
List list1 = new ArrayList<>();
for(int i = 0; i < 4; i++){
list1.add(person);
}
LogUtils.d(list1);
// 打印数组
double[][] doubles = {{1.2, 1.6, 1.7, 30, 33},
{1.2, 1.6, 1.7, 30, 33},
{1.2, 1.6, 1.7, 30, 33},
{1.2, 1.6, 1.7, 30, 33}};
LogUtils.d(doubles);
// 自定义tag
LogUtils.tag("我是自定义tag").d("我是打印内容");
// 其他用法
LogUtils.v("12345");
LogUtils.i("12345");
LogUtils.w("12345");
LogUtils.e("12345");
LogUtils.wtf("12345");
### [](https://github.com/pengwei1024/LogUtils/blob/master/README_USAGE.md#options)options
| 方法 | 描述 | 取值 | 缺省 |
| --- | --- | --- | --- |
| configAllowLog | 是否允许日志输出 | boolean | true |
| configTagPrefix | 日志log的前缀 | String | "LogUtils" |
| configShowBorders | 是否显示边界 | boolean | false |
| configLevel | 日志显示等级 | LogLevelType | LogLevel.TYPE_VERBOSE |
| addParserClass | 自定义对象打印 | Parser | 无 |
| configFormatTag | 个性化设置Tag | String | %c{-5} |
| configMethodOffset | 方法偏移量 | int | 0 |
###### [](https://github.com/pengwei1024/LogUtils/blob/master/README_USAGE.md#%E5%86%99%E5%85%A5%E6%97%A5%E5%BF%97%E6%96%87%E4%BB%B6%E5%8F%82%E6%95%B0)写入日志文件参数
| 方法 | 描述 | 取值 | 缺省 |
| --- | --- | --- | --- |
| configLog2FileEnable | 是否支持写入文件 | boolean | false |
| configLog2FilePath | 写入日志路径 | String | 无 |
| configLog2FileNameFormat | 写入日志文件名 | string | %d{yyyyMMdd}.txt |
| configLog2FileLevel | 写入日志等级 | LogLevelType | LogLevel.TYPE_VERBOSE |
| configLogFileEngine | 写入日志实现 | LogFileEngine | 无 |
| configLogFileFilter | 写入日志过滤 | LogFileFilter | 无 |
##### [](https://github.com/pengwei1024/LogUtils/blob/master/README_USAGE.md#demo)Demo
```source-java
LogUtils.getLogConfig()
.configAllowLog(true)
.configTagPrefix("MyAppName")
.configShowBorders(true)
.configFormatTag("%d{HH:mm:ss:SSS} %t %c{-5}")
# 支持写入日志到文件
LogUtils.getLog2FileConfig().configLog2FileEnable(true)
// targetSdkVersion >= 23 需要确保有写sdcard权限
.configLog2FilePath("/sdcard/项目文件夹/logs/")
.configLog2FileNameFormat("%d{yyyyMMdd}.txt")
.configLogFileEngine(new LogFileEngineFactory());
configFormatTag参数详解
变量
简写
描述
参数
示例
输出结果
%%
无
转义%
无
%%d
%d
%date
%d
当前时间
格式化时间,如HH:mm:ss
%d{HH:mm:ss:SSS}
10:00:46:238
%thread
%t
当前线程名称
无
%t
thread-127
%caller
%c
线程信息和类路径
一般用%c{-5}就好了，用法为%c{整数}或者%caller{整数}，整数为包名路径，如路径为com.apkfuns.logutils.demo.MainActivity.onCreate(MainActivity.java:135),%c{1}输出com，以.分割的第一个,如果小于0就是排除前面n个，如%c{-1} ，结果为apkfuns.logutils.demo.activity.MainActivity.onCreate(MainActivity.java:135),
%c{-5}
MainActivity.onCreate(MainActivity.java:135)
自定义对象打印
实现Parser接口，并实现parseClassType() 和parseString()方法,再通过addParserClass()配置到LogUtil 详细文档
4. Usage
Gradle
implementation 'com.apkfuns.logutils:library:1.7.5'
release-no-op版本
debugImplementation 'com.apkfuns.logutils:library:1.7.5'
releaseImplementation 'com.apkfuns.logutils:logutils-no-op:1.7.5'
日志写入到文件
依赖log2file库 (基于Log4a实现)
implementation 'com.apkfuns.log2file:log2file:1.3.1'
LogUtils.getLog2FileConfig().configLogFileEngine(new LogFileEngineFactory(context));
自己实现日志写入文件 (实现LogFileEngine接口)
public class MyLogFileEngine implements LogFileEngine {
// logFlile 日志文件， logContent 日志内容，LogFileParam日志参数
@Override
public void writeToFile(File logFile, String logContent, LogFileParam params) {
....
}
}
...
LogUtils.getLog2FileConfig().configLogFileEngine(new MyLogFileEngine());

别忘了添加写文件权限

mmap 日志原理

[高性能]日志优先写到内存映射文件，和写内存一样高效

[保证日志不丢失]日志超过4k立即写入文件，每次程序重新启动立即写入，或者端上调用LogUtils.getLog2FileConfig().flushAsync()立即写入

5. Skills