目录
一、简介
二、下载使用
添加jitpack 仓库
添加依赖:
三、更改
1、 LogDogV2.3.1初始化:
2、通过上面的初始化 ，已经知道IJsonEngine 优化了泛型参数，采用 Object/Any
3、优化空异常的判断，哪怕打印变量是NULL LogDog会打印“null” 提示开发人员
四、新增
1、新增 log 格式换行开关
2、新增log 方法栈打印深度校准
3、新增日志文件分享
五、结语
一、简介
以前版本：
Android开源 日志框架 LogDog V2.0.0
https://blog.csdn.net/Ym_quiet/article/details/130838654
Android开源 日志框架 LogDog V1.2https://blog.csdn.net/Ym_quiet/article/details/130550198
Android开源 日志框架 LogDog V1.0https://blog.csdn.net/Ym_quiet/article/details/130453232
LogDog 2.3.1版本，比较之前版本，变化有点大，如果已经引用之前的版本，需要修改初始化和初始化配置，但是在log 打印调用方法，不需要更改，LogDog框架始终以兼容的角度去优化框架，不会出现更新版本后，需要大量更改以前的代码调用，而是尽可能采取扩展式优化，减少重构式或者重写式优化，不管怎么样，在使用LogDog时哪怕要重写也是采用内部重写，外部调用方法不变。
二、下载使用
添加jitpack 仓库
Android Gradle Plugin 为 v7.1.0 以下版本：进入项目根目录，打开 “build.gradle” 文件，在 “allprojects” 中加入如下代码：
...
allprojects {
repositories {
maven { url 'https://jitpack.io' }
mavenCentral()
google()
}
}
当您的 Android Gradle Plugin 为 v7.1.0 或以上版本：进入项目根目录，打开 “settings.gradle” 文件，在 “dependencyResolutionManagement” 中加入如下代码：
...
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
maven { url 'https://jitpack.io' }
mavenCentral()
google()
}
}
添加依赖:
进入 “app” 目录，打开 “build.gradle” 文件，在 “dependencies” 中添加 ：
...
dependencies {
...
implementation "com.gitee.ym521:logdog:2.3.1"
}
三、更改
1、 LogDogV2.3.1初始化:
Kotlin
logDog.install(this, object : IJsonEngine {override fun toJSON(obj: Any): String {return gson.toJson(obj)}})LogDog.builder.logWriteLogFileEnable(true) //是否开启写入日志文件.logShowMethodEnable(true) //是否开启显示方法栈信息 默认打印两个方法信息.logShowThreadInfoEnable(true) //是否打印当前线程信息Java
//这里使用的是 Google开源 Gson 也可以使用其他Json 框架 如:阿里的FastJsonGson gson = new Gson();logDog.install(this, new IJsonEngine() {@NonNull@Overridepublic String toJSON(@NonNull Object obj) {return gson.toJson(obj);}});LogDog.getBuilder().logWriteLogFileEnable(true) //是否开启写入日志文件.logShowMethodEnable(true) //是否开启显示方法栈信息 默认打印两个方法信息.logShowThreadInfoEnable(true); //是否打印当前线程信息其他更多配置可以参考LogDog V2.0.0 ,配置方法级别不会发生改变，一般只会新增。
2、通过上面的初始化 ，已经知道IJsonEngine 优化了泛型参数，采用 Object/Any
3、优化空异常的判断，哪怕打印变量是NULL LogDog会打印“null” 提示开发人员
四、新增
1、新增 log 格式换行开关
Koltin
LogDog.builder.wrapFormat()默认是没有开启的，也就是默认不会换行的就是Log 有多长会打印多长，但是会在系统日志安全长度内，如果超出会被强制切断打印输出到下一条Log。这个开关建议在开发调试可以开启，在测试阶段如果需要Log文件输出建议关闭，因为会对日志文件产生误解。
2、新增log 方法栈打印深度校准
Koltin
LogDog.builder.extraOffset()这个主要是对LogDog.custom()有自己封装需求的开发人员开放的，因为有自己封装的会多一层方法（封装方法层），深度校准范围[-3,5] ,闭区间 -3到5。
3、新增日志文件分享
在我们日常开发时，总是需要修复Bug，但是Android开发的bug就不好找了，尤其碰到非专业测试，他们给的现象都不是准确，但是APP 又是在他们测试手机上，每次copy Log文件也很麻烦，所以我嘛，纯属就是怕麻烦，新增在这个Log文件分享的功能，测试APP 直接把Log文件分享给办公APP 然后发给开发人员不就很方便了。
好了开始配置：
在AndroidManifest.xml 新增如下：
<provider android:name="com.ym521.logdog.provider.LogFileShareProvider"android:authorities="${applicationId}.fileshare" android:exported="false"android:grantUriPermissions="true"><meta-data android:name="android.support.FILE_PROVIDER_PATHS"android:resource="@xml/provider_logfile_paths" />
</provider>代码上：
LogDog.logFileShare()注意：必须开启了日志文件输出（logWriteLogFileEnable(true)），不然调用是没有效果的
期望：后面可能会把crash 日志加入进去，大概只需要开发人员，开启搜集Crash Log开关就可以将Crash 日志写入日志文件内。方便定位bug。
五、结语
希望您给博主一些鼓励（点赞、关注、收藏），如果LogDog有BUG或者您有好的建议欢迎大家提出。
