一个精简、全面、方便的AndroidLog库--ALog

2017-04-09 本文已影响1151人 Blankj

首先献上GitHub地址: ALog

![ALog][alogsvg] ![api][apisvg] ![build][buildsvg] ![License][licensesvg]

Functions

可设置Log开启和关闭
可设置是否输出到控制台(Logcat)
可设置Log全局Tag
全局Tag为空时Tag为当前类名
可设置Log是否显示头部信息
Log头部含有当前线程名
Log头部含有当前类及行号和函数名，支持点击跳转
可设置Log是否写入文件
可设置Log写入文件目录
可设置Log写入文件前缀
可设置Log是否显示边框
可设置Log控制台过滤器
可设置Log文件过滤器
可设置Log栈深度
支持控制台长字符串的输出
支持多参数输出
支持单独写入文件
支持JSON串的输出
支持XML串的输出
支持Live Templates
jar包不足5Kb

API→ALog.java→Demo

init                    : 初始化
getConfig               : 获取log配置
Config.setLogSwitch     : 设置log总开关
Config.setConsoleSwitch : 设置log控制台开关
Config.setGlobalTag     : 设置log全局tag
Config.setLogHeadSwitch : 设置log头部信息开关
Config.setLog2FileSwitch: 设置log文件开关
Config.setDir           : 设置log文件存储目录
Config.setFilePrefix    : 设置log文件前缀
Config.setBorderSwitch  : 设置log边框开关
Config.setConsoleFilter : 设置log控制台过滤器
Config.setFileFilter    : 设置log文件过滤器
Config.setStackDeep     : 设置log栈深度
v                       : Verbose日志
d                       : Debug日志
i                       : Info日志
w                       : Warn日志
e                       : Error日志
a                       : Assert日志
file                    : log到文件
json                    : log字符串之json
xml                     : log字符串之xml

How to use

compile 'com.blankj:alog:1.3.0' or ![Download][jarsvg]

Usage

初始化

在Application的onCreate函数中初始化，如下

// init it in ur application
public void initALog() {
    ALog.Config config = ALog.init(this)
            .setLogSwitch(BuildConfig.DEBUG)// 设置log总开关，包括输出到控制台和文件，默认开
            .setConsoleSwitch(BuildConfig.DEBUG)// 设置是否输出到控制台开关，默认开
            .setGlobalTag(null)// 设置log全局标签，默认为空
            // 当全局标签不为空时，我们输出的log全部为该tag，
            // 为空时，如果传入的tag为空那就显示类名，否则显示tag
            .setLogHeadSwitch(true)// 设置log头信息开关，默认为开
            .setLog2FileSwitch(false)// 打印log时是否存到文件的开关，默认关
            .setDir("")// 当自定义路径为空时，写入应用的/cache/log/目录中
            .setFilePrefix("")// 当文件前缀为空时，默认为"alog"，即写入文件为"alog-MM-dd.txt"
            .setBorderSwitch(true)// 输出日志是否带边框开关，默认开
            .setConsoleFilter(ALog.V)// log的控制台过滤器，和logcat过滤器同理，默认Verbose
            .setFileFilter(ALog.V)// log文件过滤器，和logcat过滤器同理，默认Verbose
            .setStackDeep(1);// log栈深度，默认为1
    ALog.d(config.toString());
}

借助我帮大家写好的Live Templates大家可以更方便地使用ALog，演示动画如下所示。