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

3,540 阅读3分钟

首先献上GitHub地址: ALog

ALog
ALog
api
api
build
build
License
License

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.javaDemo

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
Download

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,演示动画如下所示。

templates
templates

大家可以下载这个Live Templates包,然后在AS中File→Import Settings即可。

Tips: 如果有用到AndroidUtilCodeLogUtils,那么你导入这个Live Templates,输入ulog也会有智能模板哦。

关于如何写Live Templates,其实大家可以借鉴安卓自带的Live Templates,然后效仿一下即可。

默认初始化下的图例

  • ALog.d("debug");

detail
detail

  • ALog.d("customTag", "debug0", "debug1");

args
args

  • ALog.d(longStr);

long
long

  • ALog.file(longStr);

file
file

filecontent
filecontent

  • ALog.json(json);

json
json

  • ALog.xml(xml);

xml
xml

更多使用请运行demo来查看。

Contact

jianshu
jianshu
weibo
weibo
Blog
Blog
QQ0Group
QQ0Group
QQ1Group
QQ1Group