Android 必知必会 - AndroidStudio、AGP、Gradle、Java、Kotlin版本对应关系(官方最新)

关键词:AndroidStudio版本、AGP版本、Gradle版本、JDK版本、AndroidStudio与AGP版本对应关系、AGP与Gradle对应关系、Gradle与Java版本对应关系、Gradle与Kotlin版本对应关系

更新日期:2025年05月09日

一、Android Gradle 插件(AGP)和 Android Studio 兼容性

Android Studio 与 AGP 版本对应关系。
Android Studio 支持的 AGP 版本范围。
AS 支持的 AGP 最低版本。

新版本

Android Studio 版本所需的 AGP 版本
Meerkat | 2024.3.23.2 - 8.10
Meerkat | 2024.3.13.2 - 8.9
Ladybug | 2024.2.23.2 - 8.8
Ladybug | 2024.2.13.2 - 8.7
Koala | 2024.1.13.2 - 8.5
Jellyfish | 2023.3.13.2 - 8.4
Iguana | 2023.2.13.2 - 8.3
Hedgehog | 2023.1.13.2 - 8.2
Giraffe | 2022.3.13.2 - 8.1
Flamingo | 2022.2.13.2 - 8.0

旧版

Android Studio 版本所需的 AGP 版本
Electric Eel | 2022.1.13.2-7.4
Dolphin | 2021.3.13.2-7.3
Chipmunk | 2021.2.13.2-7.2
Bumblebee | 2021.1.13.2-7.1
Arctic Fox | 2020.3.13.1-7.0

数据来源:Android Gradle 插件版本说明

二、Android Gradle 插件(AGP)对应 Grade 版本

新版本

插件版本所需的最低 Gradle 版本
8.58.7
8.48.6
8.38.4
8.28.2
8.18.0
8.08.0
7.47.5

旧版

插件版本所需的 Gradle 版本
7.37.4
7.27.3.3
7.17.2
7.07.0
4.2.0+6.7.1
4.1.0+6.5+
4.0.0+6.1.1+
3.6.0 - 3.6.45.6.4+
3.5.0 - 3.5.45.4.1+
3.4.0 - 3.4.35.1.1+
3.3.0 - 3.3.34.10.1+
3.2.0 - 3.2.14.6+
3.1.0+4.4+
3.0.0+4.1+
2.3.0+3.3+
2.1.3 - 2.2.32.14.1 - 3.5
2.0.0 - 2.1.22.10 - 2.13
1.5.02.2.1 - 2.13
1.2.0 - 1.3.12.2.1 - 2.9
1.0.0 - 1.1.32.2.1 - 2.3

数据来源:Android Gradle 插件版本说明

三、Gradle 版本与 Java、Kotlin 版本的对应关系

Gradle 版本与 JDK 版本的对应关系、Gradle 版本与 Kotlin 版本的对应关系。

Java 兼容性

Java 版本支持工具链支持运行 Gradle
8不适用2.0
9不适用4.3
10不适用4.7
11不适用5.0
12不适用5.4
13不适用6.0
14不适用6.3
156.76.7
167.07.0
177.37.3
187.57.5
197.67.6
208.18.3
218.48.5
228.78.8
238.108.10
24不适用不适用

Kotlin 兼容性

Gradle 已使用 Kotlin 1.6.10 至 2.0.20-Beta2 进行测试。Beta 版和 RC 版可能适用,也可能不适用。

嵌入式 Kotlin 版本最低 Gradle 版本Kotlin 语言版本
1.3.105.01.3
1.3.115.11.3
1.3.205.21.3
1.3.215.31.3
1.3.315.51.3
1.3.415.61.3
1.3.506.01.3
1.3.616.11.3
1.3.706.31.3
1.3.716.41.3
1.3.726.51.3
1.4.206.81.3
1.4.317.01.4
1.5.217.21.4
1.5.317.31.4
1.6.217.51.4
1.7.107.61.4
1.8.108.01.8
1.8.208.21.8
1.9.08.31.8
1.9.108.41.8
1.9.208.51.8
1.9.228.71.8
1.9.238.91.8
1.9.248.101.8

数据来源:Gradle 兼容性说明

总结

由于 Android 应用的项目涉及到 AGP、Android Studio、Gradle、Java、Kotlin,再加上项目本身使用的 SDK 基本都会使用到 AndroidX 组件,而随着 AndroidX 组件迁移到 Kotlin 重写,其内的 SDK 又对 Kotlin 的版本有一定的要求,这就导致项目的整体 AGP 升级和 SDK 的升级面临重重困难,这需要我们对着以上所涉及内容的版本兼容性说明小心翼翼的修改。

如果有什么建议或者问题可以随时联系我,共同探讨学习:

### 如何在 Android Studio 中配置和适配 Gradle 8.7 为了确保项目能够顺利使用 Gradle 8.7,在 `build.gradle` 文件中需要正确设置 Android Gradle Plugin (AGP)版本以及对应Gradle 版本。 #### 修改 Project-Level Build File 打开项目的根目录下的 `build.gradle` 文件,找到并修改如下部分: ```groovy // Top-level build file where you can add configuration options common to all sub-projects/modules. buildscript { repositories { google() mavenCentral() // 使用 Maven Central 而不是 JCenter, 因为 JCenter 已经关闭[^1] } dependencies { classpath 'com.android.tools.build:gradle:8.7.2' // 设置 AGP 版本为 8.7.2[^2] // NOTE: Do not place your application dependencies here; they belong // in the individual module build.gradle files } } ``` #### 更新 Wrapper Configuration 接着,更新 Gradle wrapper 到最新版本。这可以通过编辑 `gradle/wrapper/gradle-wrapper.properties` 文件来完成: ```properties distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-all.zip ``` 此操作会下载指定版本Gradle 并将其用于构建过程。 #### 启用必要的插件选项 对于某些新功能的支持可能还需要启用特定的 DSL 或者其他配置项。例如,如果要利用最新的编译优化特性,则可以在模块级别的 `build.gradle` 文件里加入这些语句: ```groovy android { ... compileOptions { sourceCompatibility JavaVersion.VERSION_11 targetCompatibility JavaVersion.VERSION_11 } kotlinOptions { jvmTarget = "11" } } plugins { id 'com.android.application' version '8.7.2' apply false id 'com.android.library' version '8.7.2' apply false id 'org.jetbrains.kotlin.android' version '1.9.0' apply false } ``` 以上更改有助于确保应用程序可以充分利用新的 JVM 功能,并保持与当前工具链的最佳兼容性[^3]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值