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 |

