Android Studio 开发环境兼容性检索（AGP / Gradle / Kotlin / JDK）

本表检索了 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+ 已移除