用途:为已有 Android 项目(Kotlin 或 Java)接入 Dynatrace Mobile Agent,完成从零到首个事件的基础监控配置。仅限初始接入,自定义动作、崩溃分组、数据隐私策略等需查阅 Dynatrace 官方文档。
使用流程:先做预检,确认当前目录为 Android 项目根(存在 settings.gradle.kts 或 settings.gradle),并检查 Gradle ≥7.0.2、AGP ≥7.0、JVM Java 11;用 ./gradlew --version(Windows 用 gradlew.bat --version)查看 Gradle 及实际 JVM,不要用 java -version。随后检测已有 dynatrace { } 或 configure<DynatraceExtension> { } 配置,提取 applicationId 与 beaconUrl 作为预填值。接着向用户收集 applicationId、beaconUrl(来自 Dynatrace 租户中已创建的移动应用配置),并询问是否启用 session replay;若用户已说明则跳过。
文件定位:应用模块不一定叫 app,需在 settings 文件中查找模块并检查哪个模块应用了 com.android.application 插件(过滤 apply false 与 buildSrc/)。入口文件优先找 Application 子类,否则回退到 launcher activity,勿默认名为 MainActivity。
配置写入:根 build 文件需应用 com.dynatrace.instrumentation 插件(不是 app 模块),并加入 classpath com.dynatrace.tools.android:gradle-plugin:8.+,再添加 configure<...DynatraceExtension> 或 dynatrace 块,设置 applicationId、beaconUrl、userOptIn(true)、agentBehavior.startupLoadBalancing(true)、agentBehavior.startupWithGrailEnabled(true),按需 sessionReplay.enabled(true)。入口文件在 super.onCreate()(Application 子类)或 setContentView(...)(launcher activity)之后插入 Dynatrace.applyUserPrivacyOptions,含 DataCollectionLevel.USER_BEHAVIOR 与 withCrashReportingOptedIn(true),启用 session replay 时再加 .withScreenRecordOptedIn(true)。
验证:先列出 assemble 任务,仅一个则直接使用,多个则询问用户,然后执行对应 ./gradlew 任务,构建成功即确认插件接入正确。
限制:任何步骤失败须立即停止、报告并回滚全部改动,不留半接入状态;资料未提供收费、价格或平台支持等更多信息。