目录
[添加jitpack 仓库](#添加jitpack 仓库)
[1、 LogDogV2.3.1初始化:](#1、 LogDogV2.3.1初始化:)
[2、通过上面的初始化 ，已经知道IJsonEngine 优化了泛型参数，采用 Object/Any](#2、通过上面的初始化 ，已经知道IJsonEngine 优化了泛型参数，采用 Object/Any)
[3、优化空异常的判断，哪怕打印变量是NULL LogDog会打印"null" 提示开发人员](#3、优化空异常的判断，哪怕打印变量是NULL LogDog会打印“null” 提示开发人员)
[1、新增 log 格式换行开关](#1、新增 log 格式换行开关)
[2、新增log 方法栈打印深度校准](#2、新增log 方法栈打印深度校准)
一、简介
以前版本：
Android开源 日志框架 LogDog V2.0.0
https://blog.csdn.net/Ym_quiet/article/details/130838654
Android开源 日志框架 LogDog V1.2
https://blog.csdn.net/Ym_quiet/article/details/130550198
Android开源 日志框架 LogDog V1.0
https://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
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
java
//这里使用的是 Google开源 Gson 也可以使用其他Json 框架 如:阿里的FastJson
Gson gson = new Gson();
logDog.install(this, new IJsonEngine() {
@NonNull
@Override
public 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
Kotlin
LogDog.builder
.wrapFormat()默认是没有开启的，也就是默认不会换行的就是Log 有多长会打印多长，但是会在系统日志安全长度内，如果超出会被强制切断打印输出到下一条Log。这个开关建议在开发调试可以开启，在测试阶段如果需要Log文件输出建议关闭，因为会对日志文件产生误解。
2、新增log 方法栈打印深度校准
Koltin
Kotlin
LogDog.builder
.extraOffset()这个主要是对LogDog.custom()有自己封装需求的开发人员开放的，因为有自己封装的会多一层方法（封装方法层），深度校准范围[-3,5] ,闭区间 -3到5。
3、新增日志文件分享
在我们日常开发时，总是需要修复Bug，但是Android开发的bug就不好找了，尤其碰到非专业测试，他们给的现象都不是准确，但是APP 又是在他们测试手机上，每次copy Log文件也很麻烦，所以我嘛，纯属就是怕麻烦，新增在这个Log文件分享的功能，测试APP 直接把Log文件分享给办公APP 然后发给开发人员不就很方便了。
好了开始配置：
在AndroidManifest.xml 新增如下：
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>代码上：
Kotlin
LogDog.logFileShare()**注意：**必须开启了日志文件输出（logWriteLogFileEnable(true)），不然调用是没有效果的
期望：后面可能会把crash 日志加入进去，大概只需要开发人员，开启搜集Crash Log开关就可以将Crash 日志写入日志文件内。方便定位bug。
五、结语
++希望您给博主一些鼓励（点赞、关注、收藏），如果++LogDog ++有BUG或者您有好的建议欢迎大家提出。++