一、简介

以前版本：

Android开源日志框架 LogDog V2.0.0https://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 框架 如:阿里的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

 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>

代码上：