Android SDK 兼容性

了解 Android RUM SDK 支持的系统版本、开发工具、框架和第三方库兼容性

本文档说明 Android RUM SDK 支持的 Android 系统版本、开发平台及开发环境要求。

​

系统要求

类别	支持范围
最低 Android 版本	Android 6.0（API level 23）
最高 Android 版本	当前最新 Android 版本
支持的设备类型	Android 手机、平板、Android TV

不支持 Android 6.0（API level 23）以下的系统版本。

​

支持的平台

手机应用

Android 手机应用完整支持

平板应用

Android 平板应用完整支持

Android TV

Android TV 应用完整支持

​

开发语言

开发语言	是否支持	推荐程度
Java	✅	完全支持
Kotlin	✅	推荐使用

​

SDK 版本

SDK 主版本	支持的 Android API	状态
v3.x	API 23+	当前版本（推荐）
v2.x	API 23+	维护中
v1.x	-	已废弃

已废弃版本不建议用于新的集成项目，可能不再提供功能更新或问题修复。

​

构建工具链要求

要求项	说明
AndroidX	必须使用 AndroidX，不支持旧版 Support Library
构建系统	Gradle
Kotlin 版本	需与 AndroidX 生态版本保持兼容

​

功能兼容性

Android TV

Android TV 应用与普通 Android 应用具有相同的最低系统版本要求（API 23+）。

所有 RUM 功能在 Android TV 上都可正常使用。

Jetpack Compose

• 支持 Jetpack Compose 的监控能力
• 具体兼容性取决于应用所使用的 Compose 版本
• 推荐使用最新稳定版 Compose

Compose 应用中的导航、性能和用户交互都可以被自动追踪。

WebView 监控

• 支持 WebView 监控功能（需显式开启）
• 兼容性取决于系统 WebView 版本
• 详见 SDK 接入指南 - WebView 集成

WebView 监控需要额外的配置和依赖。

第三方库集成

提供对常见 Android 库的集成支持：

第三方库	支持状态	说明
OkHttp	✅	自动追踪 HTTP 请求
Retrofit	✅	通过 OkHttp 拦截器
Glide	✅	图片加载监控
Timber	✅	日志集成

具体兼容性取决于对应第三方库本身的系统要求。

​

版本更新策略

SDK 遵循语义化版本控制（Semantic Versioning）：

更新类型	版本格式	兼容性	说明
主版本	v3.0.0	可能不兼容	可能包含破坏性更改，需要代码调整
次版本	v3.1.0	向后兼容	新增功能，保持向后兼容
补丁版本	v3.1.1	完全兼容	Bug 修复，完全向后兼容

建议定期更新 SDK 到最新稳定版本以获得最佳性能和安全性。

​

快速参考

最低版本

Android 6.0（API level 23）

支持平台

手机、平板、Android TV

开发语言

Java、Kotlin

当前版本

SDK v3.x

​

相关文档

SDK 接入

了解如何集成 Android SDK

高级配置

配置 SDK 的高级功能

数据收集

了解 SDK 收集的数据类型