帮你快速理解、总结文档立即下载

SDK 集成

最近更新时间:2026-09-28 16:41:40
本文档已由 AI 辅助审校
我的收藏
用户体验监控 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.gradle
pluginManagement {
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.gradle
allprojects {
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.gradle
plugins {
id 'tdem-plugin' version '0.1.12'
}
buildscript classpath:
// 项目级 build.gradle
buildscript {
repositories {
maven { url 'https://maven.cnb.cool/tencent-dem/release/-/packages/' }
}
dependencies {
classpath 'com.tencent.tdemplugin:tdem-plugin:0.1.12'
}
}

// 模块级 build.gradle
apply 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 字节码执行插桩,自动采集对应的监控埋点数据。