在 Android 工程中很多新手经常会因为 gradle、gradle 插件、JDK 等版本不匹配问题导致工程编译报错,却又不知原因为何。
本文给出了包括所用 Android Studio 在内的各种搭配之间的版本要求,希望能为在 Android 开发学习之路上,迷路的孩子找到正确的路!
1. AGP版本所要求的Gradle、JDK、SDK Build Tools 最小版本
AGP 含义是 Android Gradle Plugin,即 编译 Android 工程所用到的 gradle 插件
官方地址: Android Gradle 插件版本说明
| AGP | 最小Gradle | 最小JDK | 最小SDK Build Tools |
|---|---|---|---|
| 8.12.0 | 8.13 | Java 17 | 35.0.0 |
| 8.11.0 | 8.13 | Java 17 | 35.0.0 |
| 8.10.0 | 8.11.1 | Java 17 | 35.0.0 |
| 8.9.0 | 8.11.1 | Java 17 | 35.0.0 |
| 8.8.0 | 8.10.2 | Java 17 | 35.0.0 |
| 8.7.0 | 8.9 | Java 17 | 34.0.0 |
| 8.6.0 | 8.7 | Java 17 | 34.0.0 |
| 8.5.0 | 8.7 | Java 17 | 34.0.0 |
| 8.4.0 | 8.6 | Java 17 | 34.0.0 |
| 8.3.0 | 8.4 | Java 17 | 34.0.0 |
| 8.2.0 | 8.2 | Java 17 | 34.0.0 |
| 8.1.0 | 8.0 | Java 17 | 33.0.1 |
| 8.0.0 | 8.0 | Java 17 | 30.0.3 |
| 7.4.0 | 7.5 | Java 11 | 30.0.3 |
| 7.3.0 | 7.4 | Java 11 | 30.0.3 |
| 7.2.0 | 7.3.3 | Java 11 | 30.0.3 |
| 7.1.0 | 7.2 | Java 11 | 30.0.3 |
| 7.0.0 | 7.0.2 | Java 11 | 30.0.2 |
| 4.2.0 | 6.7.1 | Java 8 | 30.0.2 |
| 4.1.0 | 6.5 | Java 8 | 29.0.2 |
| 4.0.0 | 6.5 | Java 8 | 29.0.2 |
| 3.6.0 | 5.6.4 | Java 8 | 28.0.3 |
| 3.5.0 | 5.4.1 | Java 8 | 28.0.3 |
| 3.4.0 | 5.1.1 | Java 8 | 28.0.3 |
| 3.3.0 | 4.10.1 | Java 7 | 28.0.3 |
| 3.2.0 | 4.6 | Java 7 | 28.0.3 |
| 3.1.0 | 4.4 | Java 7 | 27.0.3 |
| 3.0.0 | 4.1 | Java 7 | 26.0.2 |
| 2.3.0 | 3.3 | Java 7 | 25.0.0 |
| 2.2.0 | 2.14.1 | Java 7 | 23.0.2 |
| 2.1.0 | 2.10 | Java 7 | 23.0.2 |
| 2.0.0 | 2.10 | Java 7 | 21.1.1 |
| 1.5.0 | 2.2.1 | Java 7 | 21.1.1 |
| 1.3.1 | 2.2.1 | Java 7 | 21.1.1 |
| 1.3.0 | 2.2.1 | Java 7 | 21.1.1 |
| 1.2.0 | 2.2.1 | Java 7 | 21.1.1 |
| 1.1.3 | 2.2.1 | Java 7 | 21.1.1 |
| 1.1.2 | 2.2.1 | Java 7 | 21.1.1 |
2. Android Studio所要求的AGP最小版本
官方地址: Android Studio 与 AGP 版本关系
| Android Studio version | 最小AGP |
|---|---|
| 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.2 | 3.2-8.8 |
| Ladybug 2024.2.1 | 3.2-8.7 |
| Koala 功能更新 2024.1.2 | 3.2-8.6 |
| 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.3 |
| Giraffe 2022.3.1 | 3.2-8.2 |
| Flamingo 2022.2.1 | 3.2-8.1 |
| 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.2-7.0 |
1370





