Skip to content

Migrating

Muyangmin edited this page Feb 24, 2017 · 2 revisions

PLog 2.0版本在1.7.x的基础上做了大规模的重构,其公开API也做了一些调整,其中有一部分是不兼容的升级。

这篇wiki将详细列出从PLog 1.x版本升级到2.x版本所需要注意的地方,虽然有诸多不便,但还是推荐大家使用新版PLog以获得更强大的特性。

由于个人精力有限,在2.0正式版发布之后,1.x版本将逐步停止维护,但同时也一如既往地欢迎大家一起维护这个日志库。

Gradle依赖的改变

1.x版本的依赖包为单个依赖,2.x做了拆包处理,可按需配置,有助于进一步压缩体积。

1.x
    compile 'org.mym.plog:android-plog:1.7.0'
2.x
    compile "org.mym.plog:plog-core:${VERSION_NAME}"

详细的依赖包请参见这里

删除keepInnerClass配置

1.x版本中的这个选项在实践中发现用途不是很大,因此在2.x版本中已自动开启该功能,并将其从公开API中删除。现在自动Tag会自动带上内部类的完整信息。

删除maxLengthPerLine配置

在2.x版本中,由于Printer之间相互独立,1.x版本中的maxLengthPerLine配置失去了原本的意义,因此已经删除。

在新版本中,内置的DebugPrinter有两个构造器:

    public DebugPrinter(boolean isDebug);
    public DebugPrinter(boolean isDebug, int maxLengthPerLine);

在使用第一个构造器时,DebugPrinter会自动使用100字符换行;如果使用第二个参数则使用给定的参数换行。

另外,如果需要实现自定义Printer,可以直接继承AbsPrinter获得该特性,也可以自行实现SoftWrapper接口。

Clone this wiki locally