Config
Muyangmin edited this page Feb 23, 2017
·
3 revisions
PLog设计之初就充分考虑到项目的复杂度和多样性,大部分功能都有相应的设置项。了解这些设置项的场景和功能,会让你更好地使用PLog。
随着PLog功能的日趋完善,未来可能会加入更多的设置项,所有设置项都可以在PLogConfig
类中找到。
Tips:
PLogConfig
类是只读的;请使用PLogConfig.Builder
来创建新的配置,或者克隆现有配置。
启用该选项后,在每条日志前方会插入当前日志所在的源文件名和行号。如果你的IDE是Android Studio,那么在Logcat中会生成相应的链接,点击即可跳转到对应行。
启用该选项后,如果调用没有tag
参数的方法,会自动设置GlobalTag
为日志标签。关于全局日志,请参见Tags
Tips:
- 该功能不可禁用,但可以将全局标签设置为任意的字符串。
- 全局日志不可为null或空串。
启用该选项后,如果调用没有tag
参数的方法,会自动设置当前类名为日志标签。
- 为简洁起见,如果当前类为内部类,则只保留最后一个非匿名内部类开头的类名串。例如当前类名为
A$B$1
,则只会保留B$1
。 - 如果启用了forceConcatGlobalTag, 则AutoTag会在GlobalTag后面拼接;否则不适用GlobalTag。
PLog提供的一个重要功能是PLog#empty()
,该方法可用于任何位置打点,主要是观察程序的运行情况。与GlobalTag
类似,该功能也无法禁用,但可以设置为任何字符串。考虑到不同使用者的习惯,该方法的输出Level可以被自行控制,默认为DEBUG
。