> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashcat.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Android SDK 兼容性

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

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

## 系统要求

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

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

## 支持的平台

<CardGroup cols={3}>
  <Card title="手机应用" icon="mobile">
    Android 手机应用完整支持
  </Card>

  <Card title="平板应用" icon="tablet">
    Android 平板应用完整支持
  </Card>

  <Card title="Android TV" icon="tv">
    Android TV 应用完整支持
  </Card>
</CardGroup>

## 开发语言

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

## SDK 版本

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

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

## 构建工具链要求

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

## 功能兼容性

<AccordionGroup>
  <Accordion title="Android TV">
    Android TV 应用与普通 Android 应用具有相同的最低系统版本要求（API 23+）。

    <Check>
      所有 RUM 功能在 Android TV 上都可正常使用。
    </Check>
  </Accordion>

  <Accordion title="Jetpack Compose">
    * 支持 Jetpack Compose 的监控能力
    * 具体兼容性取决于应用所使用的 Compose 版本
    * 推荐使用最新稳定版 Compose

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

  <Accordion title="WebView 监控">
    * 支持 WebView 监控功能（需显式开启）
    * 兼容性取决于系统 WebView 版本
    * 详见 [SDK 接入指南 - WebView 集成](/zh/rum/sdk/android/sdk-integration#webview集成)

    <Note>
      WebView 监控需要额外的配置和依赖。
    </Note>
  </Accordion>

  <Accordion title="第三方库集成">
    提供对常见 Android 库的集成支持：

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

    <Note>
      具体兼容性取决于对应第三方库本身的系统要求。
    </Note>
  </Accordion>
</AccordionGroup>

## 版本更新策略

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

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

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

## 快速参考

<CardGroup cols={2}>
  <Card title="最低版本" icon="android">
    Android 6.0（API level 23）
  </Card>

  <Card title="支持平台" icon="devices">
    手机、平板、Android TV
  </Card>

  <Card title="开发语言" icon="code">
    Java、Kotlin
  </Card>

  <Card title="当前版本" icon="tag">
    SDK v3.x
  </Card>
</CardGroup>

## 相关文档

<CardGroup cols={3}>
  <Card title="SDK 接入" icon="plug" href="/zh/rum/sdk/android/sdk-integration">
    了解如何集成 Android SDK
  </Card>

  <Card title="高级配置" icon="sliders" href="/zh/rum/sdk/android/advanced-config">
    配置 SDK 的高级功能
  </Card>

  <Card title="数据收集" icon="database" href="/zh/rum/sdk/android/data-collection">
    了解 SDK 收集的数据类型
  </Card>
</CardGroup>