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 |
| Iguana (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 |
| 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 |