Skip to content
Muyangmin edited this page Feb 23, 2017 · 3 revisions

PLog设计之初就充分考虑到项目的复杂度和多样性,大部分功能都有相应的设置项。了解这些设置项的场景和功能,会让你更好地使用PLog。
随着PLog功能的日趋完善,未来可能会加入更多的设置项,所有设置项都可以在PLogConfig类中找到。

Tips:PLogConfig类是只读的;请使用PLogConfig.Builder来创建新的配置,或者克隆现有配置。

KeepLineNumber(行号保持)

启用该选项后,在每条日志前方会插入当前日志所在的源文件名和行号。如果你的IDE是Android Studio,那么在Logcat中会生成相应的链接,点击即可跳转到对应行。

GlobalTag*(全局日志标签)

启用该选项后,如果调用没有tag参数的方法,会自动设置GlobalTag为日志标签。关于全局日志,请参见Tags

Tips:

  • 该功能不可禁用,但可以将全局标签设置为任意的字符串。
  • 全局日志不可为null或空串。

AutoTag (自动日志标签)

启用该选项后,如果调用没有tag参数的方法,会自动设置当前类名为日志标签。

  • 为简洁起见,如果当前类为内部类,则只保留最后一个非匿名内部类开头的类名串。例如当前类名为 A$B$1,则只会保留B$1
  • 如果启用了forceConcatGlobalTag, 则AutoTag会在GlobalTag后面拼接;否则不适用GlobalTag。

EmptyMsg/EmptyMsgLevel(空消息设置)

PLog提供的一个重要功能是PLog#empty(),该方法可用于任何位置打点,主要是观察程序的运行情况。与GlobalTag类似,该功能也无法禁用,但可以设置为任何字符串。考虑到不同使用者的习惯,该方法的输出Level可以被自行控制,默认为DEBUG