本表检索了 Android 项目中常用构建工具的兼容性关系，包括：
AGP（Android Gradle Plugin）Gradle（构建工具）KGP（Kotlin Gradle Plugin）JDK（Java Development Kit）compileSdkVersion（编译 API 上限）
📊 全版本兼容性总表
| AGP 版本 | 最低 Gradle | 最高 Gradle | Kotlin 插件版本范围 | 最低 JDK | 支持的 compileSdk | 状态 |
|---|---|---|---|---|---|---|
| 3.6.x | 5.6.4 | 6.5 | 1.3.x – 1.4.x | JDK 8 | ≤ 29（Android 10） | ❌ 过时 |
| 4.0.x | 6.1.1 | 6.5 | 1.3.x – 1.4.x | JDK 8 | ≤ 30 | ❌ 过时 |
| 4.1.x | 6.5 | 6.7.1 | 1.4.x – 1.5.x | JDK 8 | ≤ 30 | ❌ 过时 |
| 4.2.x | 6.7.1 | 6.9 | 1.4.x – 1.5.x | JDK 8 | ≤ 30 | ⚠️ 部分兼容 |
| 7.0.x | 7.0 | 7.2 | 1.5.x – 1.6.x | JDK 11 | ≤ 31（Android 12） | ✅ 稳定 |
| 7.1.x | 7.2 | 7.3 | 1.5.x – 1.6.x | JDK 11 | ≤ 32 | ✅ 稳定 |
| 7.2.x | 7.3 | 7.4 | 1.6.x – 1.7.x | JDK 11 | ≤ 32/33 | ✅ 稳定 |
| 7.3.x | 7.4 | 7.5 | 1.7.x – 1.8.x | JDK 11 | ≤ 33（Android 13） | ✅ 稳定 |
| 7.4.x | 7.5 | 7.6 | 1.8.x – 1.9.x | JDK 11 | ≤ 33 | ✅ 推荐 |
| 8.0.x | 8.0 | 8.1 | 1.8.x – 1.9.x | JDK 17 | ≤ 34（Android 14） | ✅ 推荐 |
| 8.1.x | 8.1 | 8.2 | 1.9.x – 2.0.x | JDK 17 | ≤ 34 | ✅ 推荐 |
| 8.2.x | 8.2 | 8.3 | 1.9.22 – 2.0.x | JDK 17 | ≤ 34 | ✅ 稳定 |
| 8.3.x | 8.3 | 8.4 | 2.0.x – 2.1.x | JDK 17 | ≤ 35（Android 15） | ✅ 最新 |
| 8.10.0+ | 8.11.1 | 8.12+ | 2.1.x | JDK 17 | ≥ 34 / 35+ | ✅ 最新 |
✅ 推荐构建组合（2025）
✔ 稳定生产环境推荐
# gradle-wrapper.properties
distributionUrl=https\://services.gradle.org/distributions/gradle-8.2-all.zip
// build.gradle
plugins {
id 'com.android.application' version '8.2.0' apply false
id 'org.jetbrains.kotlin.android' version '1.9.22' apply false
}
- JDK：17
- compileSdk：34
✔ 最新功能体验环境（适用于 Jetpack Compose 1.6+ 、Android 15）
# gradle-wrapper.properties
distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-all.zip
// build.gradle
plugins {
id 'com.android.application' version '8.10.0' apply false
id 'org.jetbrains.kotlin.android' version '2.1.20' apply false
}
- JDK：17
- compileSdk：35
📌 常见注意事项
- AGP ≥ 8.0 必须使用 JDK 17
- Gradle 与 AGP 是强绑定关系，版本不兼容会构建失败
- Kotlin 插件版本应与 Kotlin 编译器一致，否则 kapt 、Compose 等可能异常
- 已废弃配置项（如
android.bundle.enableUncompressedNativeLibs）在 AGP 8.1+ 已移除