• Stars
    star
    450
  • Rank 96,423 (Top 2 %)
  • Language
    Java
  • License
    Apache License 2.0
  • Created over 7 years ago
  • Updated over 5 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

📝 A simple util of log in Android develop.

ALog(该库已停止维护,后续更新都在 AndroidUtilCodeLogUtils

ALog api build License

Functions

  • 兼容 Android Studio 3.1.0 的 Logcat 完美显示日志
  • 兼容 Kotlin
  • 可设置 Log 开启和关闭
  • 可设置是否输出到控制台(Logcat)
  • 可设置 Log 全局 Tag
  • 全局 Tag 为空时 Tag 为当前类名
  • 可设置 Log 是否显示头部信息
  • Log 文件顶部显示设备信息
  • Log 头部含有当前线程名
  • Log 头部含有当前类及行号和函数名,支持点击跳转
  • 可设置 Log 是否写入文件
  • 可设置 Log 写入文件目录
  • 可设置 Log 写入文件前缀
  • 可设置 Log 是否显示边框
  • 可设置 Log 控制台过滤器
  • 可设置 Log 文件过滤器
  • 可设置 Log 栈深度
  • 可设置 Log 栈偏移
  • 可设置 Log 保存天数
  • 可增加 Log 格式化器,默认已支持 Array, Throwable, Bundle, Intent 格式化输出
  • 支持控制台长字符串的输出
  • 支持多参数输出
  • 支持单独写入文件
  • 支持 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.setSingleTagSwitch: 设置 log 单一 tag 开关(为美化 AS 3.1 的 Logcat)
Config.setConsoleFilter  : 设置 log 控制台过滤器
Config.setFileFilter     : 设置 log 文件过滤器
Config.setStackDeep      : 设置 log 栈深度
Config.setStackOffset    : 设置 log 栈偏移
Config.setSaveDays       : 设置 log 可保留天数
Config.addFormatter      : 新增 log 格式化器
log                      : 自定义 tag 的 type 日志
v                        : tag 为类名的 Verbose日志
vTag                     : 自定义 tag 的 Verbose日志
d                        : tag 为类名的 Debug 日志
dTag                     : 自定义 tag 的 Debug 日志
i                        : tag 为类名的 Info 日志
iTag                     : 自定义 tag 的 Info 日志
w                        : tag 为类名的 Warn 日志
wTag                     : 自定义 tag 的 Warn 日志
e                        : tag 为类名的 Error日志
eTag                     : 自定义 tag 的 Error日志
a                        : tag 为类名的 Assert 日志
aTag                     : 自定义 tag 的 Assert 日志
file                     : log 到文件
json                     : log 字符串之 json
xml                      : log 字符串之 xml

How to use

compile 'com.blankj:alog:1.9.1' or 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)// 输出日志是否带边框开关,默认开
            .setSingleTagSwitch(true)// 一条日志仅输出一条,默认开,为美化 AS 3.1 的 Logcat
            .setConsoleFilter(ALog.V)// log 的控制台过滤器,和 logcat 过滤器同理,默认 Verbose
            .setFileFilter(ALog.V)// log 文件过滤器,和 logcat 过滤器同理,默认 Verbose
            .setStackDeep(1)// log 栈深度,默认为 1
            .setStackOffset(0)// 设置栈偏移,比如二次封装的话就需要设置,默认为 0
            .setSaveDays(3)// 设置日志可保留天数,默认为 -1 表示无限时长
            // 新增 ArrayList 格式化器,默认已支持 Array, Throwable, Bundle, Intent 的格式化输出
            .addFormatter(new ALog.IFormatter<ArrayList>() {
                @Override
                public String format(ArrayList list) {
                    return "ALog Formatter ArrayList { " + list.toString() + " }";
                }
            });
    ALog.d(config.toString());
}

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

templates

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

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

默认初始化下的图例

  • ALog.d("debug");

detail

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

args

  • ALog.d(longStr);

long

  • ALog.file(longStr);

file

filecontent

  • ALog.json(json);

json

  • ALog.xml(xml);

xml

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

Contact

jianshu weibo Blog QQ0Group QQ1Group

More Repositories

1

AndroidUtilCode

🔥 Android developers should collect the following utils(updating).
Java
33,174
star
2

awesome-java-leetcode

👑 LeetCode of algorithms with java solution(updating).
Java
8,683
star
3

AndroidStandardDevelop

🌟 Best practices in Android develop(final).
2,998
star
4

awesome-comment

💥 Funny comments
2,321
star
5

AndroidOfferKiller

💪 Help you get a better offer.
1,846
star
6

FreeProGuard

🔰 Config proguard for common Android libraries.
Java
562
star
7

resume

🎉 An resume template for Android developers.
CSS
499
star
8

SwipePanel

Android 侧划,如斯优雅
Java
487
star
9

RxBus

🚌 The RxBus as steady as an old dog.
Java
342
star
10

AucFrameTemplate

AucFrame
Groovy
255
star
11

ProgressRing

自定义View之渐变圆环进度条
Java
157
star
12

doge-expression

🐶 Expression of cartoon doge
139
star
13

HelloKotlin

💨 Kotlin从入门到JAVA
80
star
14

glory

select * from learn
CSS
36
star
15

NiceViewPager

Java
25
star
16

proguard-templates

24
star
17

blankj.github.io

homepage
HTML
22
star
18

AutoCheckEditTextDemo

Automatically check user's input is correct.
Java
17
star
19

AchieveScroll

Java
15
star
20

RecyclerPopupWindow

Use RecyclerView and PopupWindow to Replace ListPopupWindow
Java
15
star
21

StaticBus

🚌 A static bus use in modules.
Java
15
star
22

Blankj

About me
11
star
23

GetRotateDegree

Java
10
star
24

EditTextPassword

Java
10
star
25

AndroidUtilDebug

7
star
26

AndroidStudioGitIgnore

Android Studio .gitignore
6
star
27

CustomViewGroup

Java
5
star
28

AndroidCommon

Java
5
star
29

AppFrame

Java
5
star
30

RewriteView

Java
4
star
31

MyTopBar

Java
3
star
32

ListViewExpandation

Java
3
star
33

GoGoGo

3
star
34

ListViewSkill

Java
2
star
35

EventIntercept

Java
2
star
36

JavaUtilCode

1
star
37

AndroidStudioPluginTemplate

1
star
38

Lg

二次封装mars-xlog
C++
1
star
39

AndroidStudioTemplatePlugin

1
star