Dokit简介
- DoraemonKit 能够快速让你的业务测试代码能够在这里统一管理,统一收口;
- DoraemonKit 内置很多常用的工具,避免重复实现,一次接入,你将会拥有强大的工具集合;
- 搭配dokit平台,借助接口Mock、健康体检、文件同步助手让你方便和他人协同,极大的提升研发过程中的效率
Android应用接入
1.Gradle 依赖
dependencies {
…
debugImplementation 'com.didichuxing.doraemonkit:dokitx:3.3.5'
releaseImplementation 'com.didichuxing.doraemonkit:dokitx-no-op:3.3.5'
…
}
2.初始化
import android.app.Application;
import com.didichuxing.doraemonkit.DoraemonKit;
public class AndroidApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
//pId可在https://www.dokit.cn/登录后控制台添加应用后获取
DoraemonKit.install(this, "5bb7f0d4a09c833656de5ec0708c68a0");
}
}
3.流量监控以及其他AOP功能(可选)
- AOP包括以下几个功能: 1)百度、腾讯、高德地图的经纬度模拟 2)UrlConnection、Okhttp 抓包以及后续的接口hook功能 3)App 启动耗时统计 4)慢函数 5)大图
- 在项目的 build.gradle 中添加 classpath。
buildscript {
dependencies {
…
classpath 'com.didichuxing.doraemonkit:dokitx-plugin:3.3.5'
…
}
}
- 在 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 {
//调用栈模式配置
stackMethod {
//默认值为 5ms 小于该值的函数在调用栈中不显示
thresholdTime 10
//调用栈函数入口
enterMethods = ["com.didichuxing.doraemondemo.MainDebugActivity.test1"]
//黑名单 粒度最小到类 暂不支持到方法
methodBlacklist = ["com.facebook.drawee.backends.pipeline.Fresco"]
}
//普通模式配置
normalMethod {
//默认值为 500ms 小于该值的函数在运行时不会在控制台中被打印
thresholdTime 500
//需要针对函数插装的包名
packageNames = ["com.wch.dokit"]
//不需要针对函数插装的包名&类名
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
4.编译通过后安装
- 华为畅享8设备(安卓8),安卓应用引入dokit插件编译通过打开后崩溃并报如下错误
2021-01-08 11:21:48.002 13696-13696/test.xdja.com.testdemov3 E/AndroidRuntime: FATAL EXCEPTION: main
Process: test.xdja.com.testdemov3, PID: 13696
java.lang.RuntimeException: Unable to instantiate application test.xdja.com.testdemov3.AndroidApplication:
java.lang.ClassNotFoundException: Didn't find class "test.xdja.com.testdemov3.AndroidApplication"
on path: DexPathList[[zip file "/data/app/test.xdja.com.testdemov3-EtvgXQ5acPFVjPhPky2zyQ==/base.apk"],
nativeLibraryDirectories=[/data/app/test.xdja.com.testdemov3-EtvgXQ5acPFVjPhPky2zyQ==/lib/arm64,
/data/app/test.xdja.com.testdemov3-EtvgXQ5acPFVjPhPky2zyQ==/base.apk!/lib/arm64-v8a, /system/lib64, /vendor/lib64, /product/lib64]]
- 华为MatePad设备(安卓10),安卓应用引入dokit插件编译通过打开后崩溃并报如下错误
2021-01-08 11:33:29.643 19241-19241/? E/AndroidRuntime: FATAL EXCEPTION: main
Process: test.xdja.com.testdemov3, PID: 19241
java.lang.BootstrapMethodError: Exception from call site #4 bootstrap method
at okhttp3.internal.Util.<clinit>(Util.java:87)
at okhttp3.internal.Util.immutableList(Util.java:234)
at okhttp3.OkHttpClient.<clinit>(OkHttpClient.java:124)
at com.didichuxing.doraemonkit.util.DoraemonStatisticsUtil.uploadUserInfo(DoraemonStatisticsUtil.java:54)
at com.didichuxing.doraemonkit.DoraemonKitReal.install(DoraemonKitReal.kt:174)
at com.didichuxing.doraemonkit.DoraemonKit.install(DoraemonKit.kt:58)
at com.didichuxing.doraemonkit.DoraemonKit.install(DoraemonKit.kt:24)
at test.xdja.com.testdemov3.AndroidApplication.onCreate(AndroidApplication.java:13)
at android.app.Instrumentation.callApplicationOnCreate(Instrumentation.java:1202)
at android.app.ActivityThread.handleBindApplication(ActivityThread.java:7351)
at android.app.ActivityThread.access$2400(ActivityThread.java:308)
at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2295)
5.上述问题解决