用户体验监控 Android SDK 支持 Gradle 依赖引入 Fat-AAR,并配合编译期插桩插件实现网络 / 启动的自动埋点。
前提条件
Android 5.0(API 21)及以上。
Android Studio 2022.3+、AGP 7.3.1+、Kotlin 1.7.20。
崩溃监控需要 NDK 21.4.7075529、CMake 3.10.2+。
操作步骤
步骤1:添加仓库
插件与 SDK 均从 CNB 制品库获取,需在
settings.gradle 中同时配置依赖仓库与插件仓库。// settings.gradlepluginManagement {repositories {maven { url 'https://maven.cnb.cool/tencent-dem/release/-/packages/' }google()mavenCentral()gradlePluginPortal()}}dependencyResolutionManagement {repositories {maven { url 'https://maven.cnb.cool/tencent-dem/release/-/packages/' }google()mavenCentral()}}
若项目未使用
dependencyResolutionManagement(Gradle 6.x 或沿用 allprojects),可在项目级 build.gradle 中配置:// 项目级 build.gradleallprojects {repositories {maven { url 'https://maven.cnb.cool/tencent-dem/release/-/packages/' }google()mavenCentral()}}
注意:
制品库完整地址须包含
/-/packages/ 路径段,仅写 https://cnb.cool/tencent-dem/release 无法解析制品。步骤2:添加依赖
dependencies {implementation 'com.tencent.tdem:tdem:0.1.24'}
步骤3:应用插桩插件(网络 / 启动 / Compose Navigation 插桩)
引入并启用 tdem-plugin 0.1.12 插件,支持以下两种写法,选择其一即可。
plugins {} DSL(推荐):// 模块级 build.gradleplugins {id 'tdem-plugin' version '0.1.12'}
buildscript classpath:// 项目级 build.gradlebuildscript {repositories {maven { url 'https://maven.cnb.cool/tencent-dem/release/-/packages/' }}dependencies {classpath 'com.tencent.tdemplugin:tdem-plugin:0.1.12'}}// 模块级 build.gradleapply plugin: 'tdem-plugin'
插桩开关(两种写法通用,下列为当前默认值):
tdem {instrumentOkHttp = true // OkHttp3 自动监控instrumentHUC = true // HttpURLConnection 自动监控instrumentSSE = true // SSE 自动监控instrumentLaunch = true // Application/Activity 启动埋点instrumentComposeNavigation = false // Compose Navigation 页面流转,默认关闭}
说明:
tdem {} 是 tdem-plugin 的插件配置块,在插件引入代码之后写入。该配置块不会立即执行,仅用于定义字节码插桩开关;在项目编译打包阶段,插件读取此处配置,根据各项开关对 Class 字节码执行插桩,自动采集对应的监控埋点数据。