本文档说明 Android RUM SDK 支持的 Android 系统版本、开发平台及开发环境要求。
系统要求
| 类别 | 支持范围 |
|---|---|
| 最低 Android 版本 | Android 6.0(API level 23) |
| 最高 Android 版本 | 当前最新 Android 版本 |
| 支持的设备类型 | Android 手机、平板、Android TV |
支持的平台
手机应用
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 TV 应用与普通 Android 应用具有相同的最低系统版本要求(API 23+)。
所有 RUM 功能在 Android TV 上都可正常使用。
Jetpack Compose
Jetpack Compose
- 支持 Jetpack Compose 的监控能力
- 具体兼容性取决于应用所使用的 Compose 版本
- 推荐使用最新稳定版 Compose
WebView 监控
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 修复,完全向后兼容 |
快速参考
最低版本
Android 6.0(API level 23)
支持平台
手机、平板、Android TV
开发语言
Java、Kotlin
当前版本
SDK v3.x