Android Gradle Plugin 详细版本兼容性对照表(含 Android 15 支持)

版本兼容性对照表

AGP 版本 最低 Gradle 版本 推荐 Gradle 版本 JDK 支持 Android Studio 版本 编译 SDK 最低要求 编译 SDK 最高支持 生命周期状态
8.6 8.6 8.6 JDK 11-17 Jellyfish 2024.1.1 API 21 API 35 开发中
8.5 8.4 8.4-8.6 JDK 11-17 Iguana 2024.1.1 API 21 API 35 稳定版
8.4 8.4 8.4-8.6 JDK 11-17 Iguana 2024.1.1 API 21 API 35 稳定版
8.3 8.4 8.4 JDK 11-17 Iguana 2024.1.1 API 21 API 34 稳定版
8.2 8.2 8.2-8.4 JDK 11-17 Hedgehog 2023.1.1 API 21 API 34 稳定版
8.1 8.0 8.0-8.2 JDK 11-17 Giraffe 2023.1.1 API 21 API 34 稳定版
8.0 8.0 8.0 JDK 11-17 Flamingo 2022.2.1 API 21 API 34 稳定版
7.4 7.5 7.5-7.6 JDK 11 (推荐), JDK 8 (最低) Electric Eel 2022.1.1 API 16 API 33 稳定版
7.3 7.4 7.4-7.5 JDK 11 (推荐), JDK 8 (最低) Dolphin 2021.3.1 API 16 API 33 稳定版
7.2 7.3.3 7.3.3-7.4 JDK 11 (推荐), JDK 8 (最低) Chipmunk 2021.2.1 API 16 API 32 稳定版
7.1 7.2 7.2 JDK 11 (推荐), JDK 8 (最低) Bumblebee 2021.1.1 API 16 API 31 已弃用
7.0 7.0 7.0-7.1 JDK 11 (推荐), JDK 8 (最低) Arctic Fox 2020.3.1 API 16 API 31 已弃用

Android 15 (API 35) 支持详情

对 Android 15 的支持:

  • AGP 8.5+: 完全支持 Android 15 (API 35) 作为编译 SDK
  • AGP 8.4: 有限支持 Android 15 (API 35)
  • AGP 8.3 及以下: 不支持 Android 15 (API 35)

使用 Android 15 编译 SDK 的要求:

  1. AGP 版本: 至少 8.5
  2. Gradle 版本: 至少 8.4
  3. JDK 版本: JDK 11-17
  4. Android Studio: Iguana 2024.1.1 或更高版本

Android 15 相关配置示例:

在模块级 build.gradle 文件中:

gradle 复制代码
android {
    compileSdk 35 // 使用 Android 15 (API 35)
    
    defaultConfig {
        targetSdk 35 // 目标 SDK 设置为 35
        minSdk 21    // 最小支持 SDK
    }
}

特殊说明

JDK 版本详细要求:

  • AGP 8.0+: 最低 JDK 11,推荐 JDK 17
  • AGP 7.0-7.4: 最低 JDK 8,推荐 JDK 11
  • AGP 4.0-6.x: 最低 JDK 8

编译 SDK 版本支持说明:

  • compileSdk 35: Android 15
  • compileSdk 34: Android 14
  • compileSdk 33: Android 13
  • compileSdk 32: Android 12L
  • compileSdk 31: Android 12

Android Studio 版本命名(最新):

  • Jellyfish (2024.1.1): 支持 AGP 8.5-8.6
  • Iguana (2024.1.1): 支持 AGP 8.3-8.5
  • Hedgehog (2023.1.1): 支持 AGP 8.0-8.2