Dokit 开源库：简化 Android 应用开发的利器

在 Android 应用开发过程中，我们经常需要处理调试、性能优化和用户体验等方面的问题。然而，这些任务通常需要大量的时间和精力。幸运的是，有一款名为 Dokit 的开源库可以帮助我们简化这些任务，提高开发效率和应用质量。

一、Dokit 简介

Dokit 是一款功能强大且易于集成的 Android 开发工具库，旨在帮助开发人员更轻松地进行应用调试、性能优化和用户体验改进。它提供了丰富的调试工具、性能监测和悬浮窗功能，使开发者可以更方便地查看应用的运行状态、性能指标和运行时信息。

Github：https://github.com/didi/DoKit

文档：https://xingyun.xiaojukeji.com/docs/dokit/#/intro

网站：https://www.dokit.cn/

介绍：https://zhuanlan.zhihu.com/p/196625684

二、Dokit 功能

Dokit 提供了许多有用的功能，以下是其中一些主要功能的介绍：

1. 悬浮窗调试工具: Dokit 提供了一个可自定义的悬浮窗，可以在应用运行时显示调试信息，包括布局边界、视图层级、性能指标等。这使得调试 UI 布局和交互变得更加方便。

2. 应用性能监测: Dokit 可以监测应用的性能指标，如 CPU 使用率、内存占用、网络请求等，并以可视化的方式展示。这有助于开发人员发现性能瓶颈并进行优化。

3. 网络请求监控: Dokit 可以拦截应用的网络请求，并展示请求的详细信息，如请求 URL、请求参数、响应数据等。这对于调试和分析网络请求非常有用。

4. 应用信息查看: Dokit 提供了应用信息查看功能，包括应用版本、设备信息、权限信息等。这有助于了解应用的运行环境和配置。

5. 自定义插件: Dokit 还支持开发者自定义插件，根据自己的需求扩展功能。你可以根据应用的特定需求，添加自定义的调试工具和监测功能。

三、Dokit 使用

3.1 DoKit Android 最新版本

由于jcenter事件的影响，我们需要将DoKit For Android迁移到mavenCentral()，但是需要更改groupId.所以大家要注意一下，具体的更新信息如下：

lastversion:3.5.0；kotlin编译插件为1.4.32 ；支持Gradle 6.8及以上

lastversion:3.5.0.1； kotlin编译插件为1.3.72； 支持Gradle 6.8及以下

DoKit	最新版本	描述
3.3.5及以后的Androidx	debugImplementation “io.github.didi.dokit:${aarName}: ${lastversion}”	(1)dokitx的library和plugin的groupId及版本号需要保持一致;(2)AGP最低版本要求3.3.0+
3.3.5及以前的Androidx版本	debugImplementation “com.didichuxing.doraemonkit:${aarName}:3.3.5”	（1）dokitx的library和plugin的groupId及版本号需要保持一致； (2)AGP最低版本要求3.3.0+
支持android support	debugImplementation “com.didichuxing.doraemonkit:${aarName}:3.3.5”	support放弃更新，请大家尽快升级和适配Androidx

${aarName}需要改为指定的名称，参考如下:

//核心模块
debugImplementation "io.github.didi.dokit:dokitx:${lastversion}"

//文件同步模块
debugImplementation "io.github.didi.dokit:dokitx-ft:${lastversion}"

//一机多控模块
debugImplementation "io.github.didi.dokit:dokitx-mc:${lastversion}"

//weex模块
debugImplementation "io.github.didi.dokit:dokitx-weex:${lastversion}"

//no-op 模块
releaseImplementation "io.github.didi.dokit:dokitx-no-op:${lastversion}"

debugImplementation 需要根据自己的构建改成对应的productFlavor

下面所有的例子均用dokitx举例。要使用support版本请将dokitx改为dokit即可。 v3.3.5以后的版本需要添加mavenCentral()仓库

3.2 DoKit Android 接入步骤

1. Gradle 依赖

dependencies {
    …
    debugImplementation 'io.github.didi.dokit:dokitx:${lastversion}'
    releaseImplementation 'io.github.didi.dokit:dokitx-no-op:${lastversion}'
    …
}

2. 初始化

在 App 启动的时候进行初始化。

@Override
public void onCreate() {

   DoKit.Builder(this)
            .productId("需要使用平台功能的话，需要到dokit.cn平台申请id")
            .build()

} 

3. 流量监控以及其他AOP功能（可选）

AOP包括以下几个功能:
1)百度、腾讯、高德地图的经纬度模拟
2)UrlConnection、Okhttp 抓包以及后续的接口hook功能
3)App 启动耗时统计
4)慢函数
5)大图

在项目的 build.gradle 中添加 classpath。

buildscript {
    dependencies {
        …
        classpath 'io.github.didi.dokit:dokitx-plugin:${lastversion}'
        …
    }
}

在 app 的 build.gradle 中添加 plugin。

apply plugin: 'com.didi.dokit'

插件配置选项: 添加到app module 的build.gradle文件下 与android {}处于同一级

dokitExt {
    //通用设置
    comm {
        //地图经纬度开关
        gpsSwitch true
        //网络开关
        networkSwitch true
        //大图开关
        bigImgSwitch true
        //webView js 抓包
        webViewSwitch true
    }

    slowMethod {
        //调用栈模式配置 对应gradle.properties中DOKIT_METHOD_STRATEGY=0
        stackMethod {
            //默认值为 5ms 小于该值的函数在调用栈中不显示
            thresholdTime 10
            //调用栈函数入口 千万不要用我默认的配置 如果有特殊需求修改成项目中自己的入口 假如不需要可以去掉该字段
            enterMethods = ["com.didichuxing.doraemondemo.MainDebugActivity.test1"]
            //黑名单 粒度最小到类 暂不支持到方法  千万不要用我默认的配置 如果有特殊需求修改成项目中自己的入口 假如不需要可以去掉该字段
            methodBlacklist = ["com.facebook.drawee.backends.pipeline.Fresco"]
        }
        //普通模式配置 对应gradle.properties中DOKIT_METHOD_STRATEGY=1
        normalMethod {
            //默认值为 500ms 小于该值的函数在运行时不会在控制台中被打印
            thresholdTime 500
            //需要针对函数插装的包名 千万不要用我默认的配置 如果有特殊需求修改成项目中自己的项目包名 假如不需要可以去掉该字段
            packageNames = ["com.didichuxing.doraemondemo"]
            //不需要针对函数插装的包名&类名 千万不要用我默认的配置 如果有特殊需求修改成项目中自己的项目包名 假如不需要可以去掉该字段
            methodBlacklist = ["com.didichuxing.doraemondemo.dokit"]
        }
    }
}

其中strategy和methodSwitch配置项已经弃用。新的配置开关位于项目根目录下的gradle.properties中。

具体的配置如下所示：

# dokit全局配置
# 插件开关
DOKIT_PLUGIN_SWITCH=true
# DOKIT读取三方库会和booster冲突 如果你的项目中也集成了booster 建议将开关改成false
DOKIT_THIRD_LIB_SWITCH=true
# 插件日志
DOKIT_LOG_SWITCH=true
# 自定义Webview的全限定名 主要是作用于h5 js抓包和数据mock
DOKIT_WEBVIEW_CLASS_NAME=com/didichuxing/doraemonkit/widget/webview/MyWebView
# dokit 慢函数开关
DOKIT_METHOD_SWITCH=true
# dokit 函数调用栈层级
DOKIT_METHOD_STACK_LEVEL=4
# 0:默认模式 打印函数调用栈 需添加指定入口  默认为application onCreate 和attachBaseContext
# 1:普通模式 运行时打印某个函数的耗时 全局业务代码函数插入
DOKIT_METHOD_STRATEGY=0

理由: 为了减少项目的编译时间，所以慢函数的默认开关为false。再加上plugin的transform注册必须早于project.afterEvaluate。所以无法通过原先的配置项拿到配置信息，只能通过在全局的gradle.properties中的配置可以拿到。

tips： 当修改完DoKit插件的相关配置以后一定要clean一下重新编译才能生效。这是AS的缓存增量编译导致的，暂时没有其他好的解决方案。

4. 自定义功能组件（可选）
   自定义功能组件

四、总结

Dokit 是一款功能强大且易于集成的 Android 开发工具库，它提供了丰富的调试工具、性能监测和悬浮窗功能，帮助开发人员更轻松地进行应用调试、性能优化和用户体验改进。通过集成 Dokit，开发人员可以更方便地查看应用的运行状态、性能指标和运行时信息。你可以在 Dokit 的官方文档中进一步了解其更详细的功能和使用方法，祝你在 Android 应用开发中取得更高的效率和质量！