一、Android Studio 与 AGP 版本对应关系
Android Studio 版本与 AGP 版本存在强关联，新版本 AS 通常要求特定范围的 AGP
| Android Studio 版本 | 代号（年度） | 支持的 AGP 版本范围 |
|---|---|---|
| Narwhal (2025.1.24) | 2025 | 8.12+ |
| Koala (2024.1.1) | 2024 | 8.5–8.7 |
| Jellyfish (2023.3.1) | 2023 | 8.4+ |
| Iguana (2023.2.1) | 2023 | 8.3+ |
| Hedgehog (2023.1.1) | 2023 | 8.2+ |
| Flamingo (2022.2.1) | 2022 | 8.0–8.3 |
| Electric Eel (2022.1.1) | 2022 | 7.4+ |
说明：
- AS 新版本通常兼容旧版 AGP，但旧版 AS 无法支持新版 AGP。
- 在
File > Project Structure > Project中可手动修改 AGP 版本
二、AGP 与 Gradle 版本对应关系
AGP 版本严格依赖特定 Gradle 版本，否则构建将失败
| AGP 版本 | 最低 Gradle 版本 | 推荐 Gradle 版本 |
|---|---|---|
| 8.5–8.12 | 8.7 | 8.7+ |
| 8.4 | 8.6 | 8.6+ |
| 8.3 | 8.4 | 8.4+ |
| 8.0–8.2 | 8.0 | 8.0–8.3 |
| 7.4 | 7.5 | 7.5–7.6 |
| 7.3 | 7.4 | 7.4+ |
| 7.0–7.2 | 7.0 | 7.0–7.3 |
配置位置：
- AGP 版本：项目根目录的
build.gradle文件（com.android.tools.build:gradle）。 - Gradle 版本：
gradle-wrapper.properties文件的distributionUrl
三、Gradle 与 JDK 版本对应关系
Gradle 版本决定了支持的 JDK 版本：
| Gradle 版本 | 最低 JDK（编译/运行） | 推荐 JDK |
|---|---|---|
| 8.0–8.7 | JDK 17 | JDK 17 |
| 7.0–7.6 | JDK 11 | JDK 11 |
| 6.1–6.7 | JDK 8 | JDK 8 |
关键限制：
- AGP 8.0+ 强制要求 JDK 17，AGP 7.x 支持 JDK 11（官方推荐），AGP 4.2+ 最低需 JDK 8。
- Android Studio 内置 JDK（
Embedded JDK）可自动匹配，但大型项目建议独立配置 JDK
四、Gradle 与 Kotlin 版本对应关系
Kotlin 插件版本需与 Gradle 及 AGP 兼容：
| Gradle 版本 | Kotlin 插件版本 | Kotlin 语言版本 |
|---|---|---|
| 8.5+ | 1.9.20+ | 1.8+ |
| 8.0–8.4 | 1.8.20–1.9.10 | 1.8 |
| 7.6 | 1.7.20+ | 1.4+ |
| 7.0–7.5 | 1.5.30–1.6.21 | 1.4+ |
AGP 兼容性：
- AGP 8.x 需 Kotlin ≥1.8.20，AGP 7.x 需 Kotlin ≥1.7.20。
- 在
build.gradle中指定 Kotlin 插件版本： plugins { id 'org.jetbrains.kotlin.android' version '1.9.20' }