高效的 Android 日志记录框架 ZLog

最新推荐文章于 2025-06-24 09:33:46 发布

张可_

最新推荐文章于 2025-06-24 09:33:46 发布

阅读量4.2k

点赞数

CC 4.0 BY-SA版权

分类专栏： android开发文章标签： Android Java 移动开发架构

本文链接：https://blog.youkuaiyun.com/u013872857/article/details/79175458

ZLog是一款用于Android应用的日志记录框架，它能够将运行时的日志和Crash信息保存到本地文件。提供多种日志级别打印方法，如e(), d(), i()等，支持通过Init()方法初始化并控制是否保存到文件。日志文件按类型管理，超过大小限制会自动清理。使用ZLog能方便地同时输出到控制台和文件，且具备灵活的控制选项。" 56012462,1347849,美化你的Sublime Text 3：侧边栏图标与Boxy Theme主题,"['ST3美化', '前端开发', '开发工具']

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

ZLog

用于记录 Android 运行时产生的日志、Crash 等信息并保存到本地文件中的框架。
代码地址：
https://github.com/0xZhangKe/ZLog

使用方式

首先添加 ZLog 依赖：

compile 'com.github.0xZhangKe:ZLog:3.0'

在使用前需要通过日志的输出文件夹对其初始化，例如下面这样：

ZLog.Init(String.format("%s/log/", getExternalFilesDir(null).getPath()));

一般来说可以在 Application 中的 onCreate() 方法中对其初始化，初始化完成后即可直接使用其中提供的方法输出日志，其中提供了一系列的打印日志的方法，使用方式如下：

ZLog.e("TAG", "Internet Error");

其中的日志输出的方法参数等等都是按照 Android 的日志工具 Log 来的，并且在调用 ZLog的方法后会自动调用 Log 对应的方法输出日志；
所以完全可以使用 ZLog替代 Log，因为使用 ZLog打印日志时，不仅会输出到文件中，还会调用 Log 中的相关方法打印到控制台；
为了灵活控制日志是否输出到日志文件还是单纯的只输出到控制台中，其中提供了两种控制方式控制其行为（默认情况下，日志会同时输出到控制台及日志文件中）。
第一种：调用 openSaveToFile() 或 closeSaveToFile() 方法开启或关闭整个 ZLog 框架的行为，比如只要调用了 closeSaveToFile() 方法，那么直到你调用 openSaveToFile() 方法前，所有的日志都不会输出到文件中，反之亦然；
第二种：针对单条日志文件，可以传一个 boolean 类型的参数控制，比如 ZLog.e(“TAG”, “Internet Error”， false) ,那么此条日志记录就不会输出到文件中。
具体可以查看下面的类文档。

日志文件的保存规则：

Error 类型日志保存到对应目录下的 errorLog1.txt 中，如果 errorLog1.txt 大小超过 1MB，则重新输出到 errorLog2.txt 中，以此类推，当 Error 类型的文件个数超过 9 个时，会自动清理所有 Error 类型的日志文件，并从 errorLog1.txt 重新开始；
INFO、DEBUG、WTF 类型的日志会保存到 log.txt 中，其他规则与同上；
CRASH 类型的文件会保存到 crash.txt 中，其他规则同上。