Android开发中痛点解决（一）兼容性：API级别，JDK版本，Android Gradle 插件版本，Gradle版本和 Android Studio 兼容性
Android Studio 构建系统以 Gradle 为基础，并且 Android Gradle 插件 (AGP) 添加了几项专用于构建 Android 应用的功能。下表列出了各个 Android Studio 版本所需的 AGP 版本。
Android studio版本和AGP版本兼容性
现在，AGP 和 Android Studio 采用基于时间的兼容性政策。每个 Android Studio 版本都将支持过去 3 年内发布的 AGP 版本。新版 Android Studio 将不再支持发布时间超过 3 年的 AGP 版本。如果项目的 AGP 版本不兼容，Android Studio 会要求您更新 AGP。
| Android Studio 版本 | 所需的 AGP 版本 |
|---|---|
| Otter 2 功能更新:2025.2.2 | 4.0-8.13 |
| Otter : 2025.2.1 | 4.0-8.13 |
| Narwhal 4 功能更新 : 2025.1.4 | 4.0-8.13 |
| Narwhal 3 功能更新 : 2025.1.3 | 4.0-8.13 |
| Narwhal 功能更新 : 2025.1.2 | 4.0-8.12 |
| Narwhal : 2025.1.1 | 3.2-8.11 |
| Meerkat 功能更新: 2024.3.2 | 3.2-8.10 |
| Meerkat : 2024.3.1 | 3.2-8.9 |
| Ladybug : 2024.2.1 | 3.2-8.7 |
| Koala : 2024.1.1 | 3.2-8.5 |
| Jellyfish | 2023.3.1 | 3.2-8.4 |
| lguana | 2023.2.1 | 3.2-8.3 |
| Hedgehog | 2023.1.1 | 3.2-8.2 |
| Giraffe | 2022.3.1 | 3.2-8.1 |
| Flamingo | 2022.2.1 | 3.2-8.0 |
| Electric Eel | 2022.1.1 | 3.2-7.4 |
| Dolphin | 2021.3.1 | 3.2-7.3 |
| Chipmunk | 2021.2.1 | 3.2-7.2 |
| Bumblebee | 2021.1.1 | 3.2-7.1 |
| Arctic Fox | 2020.3.1 | 3.1-7.0 |
AGP和GRADLE版本的兼容性
Android Gradle 插件版本所需的 Gradle 版本。为了获得最佳性能，您应使用 Gradle 和插件这两者的最新版本。
| 插件版本 | 所需的最低 Gradle 版本 |
|---|---|
| 8.13 | 8.13 |
| 8.12 | 8.13 |
| 8.11 | 8.13 |
| 8.10 | 8.11.1 |
| 8.9 | 8.11.1 |
| 8.8 | 8.10.2 |
| 8.7 | 8.9 |
| 8.6 | 8.7 |
| 8.5 | 8.7 |
| 8.4 | 8.6 |
| 8.3 | 8.4 |
| 8.2 | 8.2 |
| 8.1 | 8.0 |
| 8.0 | 8.0 |
| 7.4 | 7.5 |
| 7.3 | 7.4 |
| 7.2 | 7.3.3 |
| 7.1 | 7.2 |
| 7.0 | 7.0 |
| 4.2.0+ | 6.7.1 |
| 下面是 Android Gradle Plugin 插件旧版本 | 下面是 所需的最低 Gradle 构建工具 旧版本 |
| 4.1.0+ | 6.5+ |
| 4.0.0+ | 6.1.1+ |
| 3.6.0 - 3.6.4 | 5.6.4+ |
| 3.5.0 - 3.5.4 | 5.4.1+ |
| 3.4.0 - 3.4.3 | 5.1.1+ |
| 3.3.0 - 3.3.3 | 4.10.1+ |
| 3.2.0 - 3.2.1 | 4.6+ |
| 3.1.0+ | 4.4+ |
| 3.0.0+ | 4.1+ |
| 2.3.0+ | 3.3+ |
| 2.1.3 - 2.2.3 | 2.14.1 - 3.5 |
| 2.0.0 - 2.1.2 | 2.10 - 2.13 |
| 1.5.0 | 2.2.1 - 2.13 |
| 1.2.0 - 1.3.1 | 2.2.1 - 2.9 |
| 1.0.0 - 1.1.3 | 2.2.1 - 2.3 |
特定 Android API 级别所要求的最低工具版本
Android Studio 和 AGP 需要满足最低版本要求才能支持特定 API 级别。如果使用的 Android Studio 或 AGP 版本低于项目的 targetSdk 或 compileSdk 所要求的版本，可能会导致意外问题。我们建议您使用最新的预览版 Android Studio 和 AGP 来处理以预览版 Android OS 为目标平台的项目
| API 级别 | 最低 Android Studio 版本 | 最低 AGP 版本 |
|---|---|---|
| 36 | Narwhal 功能更新 3 | 2025.1.3 | 8.13.0 |
| 35 | Meerkat | 2024.3.1 Patch 1 | 8.9.1 |
| 34 | Koala 功能更新 | 2024.2.1 | 8.6.0 |
| 33 | Hedgehog | 2023.1.1 | 8.1.1 |
| 32 | Flamingo | 2022.2.1 | 7.2 |
Gradle与JDK的版本兼容性
| Gradle版本 | 最低支持JDK | 最高支持JDK | 推荐JDK |
|---|---|---|---|
| 9.x+ | JDK17 | JDK21+ | JDK17或21（LTS） |
| 8.5-8.9 | JDK8 | JDK21 | JDK17（LTS） |
| 8.0-8.4 | JDK8 | JDK17 | JDK11或17 |
| 7.x | JDK8 | JDK17 | JDK11或17（LTS） |
| 6.x | JDK8 | JDK16 | JDK8或11 |
| 5.x | JDK8 | JDK14 | JDK8 |
