Gradle的版本号与Android studio版本、AGP(Android Gradle Plugin)版本、jdk版本都有关系。只有同时匹配三个版本号,才能使用对应的Gradle版本。
Google 搜索 Android studio gradle plugin release,进入developer.android.com相关页面后能看到不同Android studio版本所使用的Android Gradle plugin版本范围。
Android Studio 版本 | 所需的 AGP 版本 |
---|---|
Iguana | 2023.2.1 | 3.2-8.3 |
Hedgehog | 2023.1.1 | 3.2-8.2 |
Giraffe | 2022.3.1 | 3.2-8.1 |
Flamingo | 2022.2.1 | 3.2-8.0 |
Electric Eel | 2022.1.1 | 3.2-7.4 |
Android Studio 版本 | 所需的 AGP 版本 |
---|---|
Dolphin | 2021.3.1 | 3.2-7.3 |
Chipmunk | 2021.2.1 | 3.2-7.2 |
Bumblebee | 2021.1.1 | 3.2-7.1 |
Arctic Fox | 2020.3.1 | 3.1-7.0 |
Google 搜索 Android studio gradle plugin release,进入developer.android.com相关页面后能看到Gradle版本与AGP版本的对应关系。
插件版本 | 所需的最低 Gradle 版本 |
---|---|
8.3 | 8.3 |
8.2 | 8.2 |
8.1 | 8.0 |
8.0 | 8.0 |
7.4 | 7.5 |
插件版本 | 所需的 Gradle 版本 |
---|---|
7.3 | 7.4 |
7.2 | 7.3.3 |
7.1 | 7.2 |
7.0 | 7.0 |
4.2.0+ | 6.7.1 |
4.1.0+ | 6.5+ |
4.0.0+ | 6.1.1+ |
3.6.0 - 3.6.4 | 5.6.4+ |
3.5.0 - 3.5.4 | 5.4.1+ |
3.4.0 - 3.4.3 | 5.1.1+ |
3.3.0 - 3.3.3 | 4.10.1+ |
3.2.0 - 3.2.1 | 4.6+ |
3.1.0+ | 4.4+ |
3.0.0+ | 4.1+ |
2.3.0+ | 3.3+ |
2.1.3 - 2.2.3 | 2.14.1 - 3.5 |
2.0.0 - 2.1.2 | 2.10 - 2.13 |
1.5.0 | 2.2.1 - 2.13 |
1.2.0 - 1.3.1 | 2.2.1 - 2.9 |
1.0.0 - 1.1.3 | 2.2.1 - 2.3 |
可以在 Android Studio 的?File?>?Project Structure?>?Project?菜单中指定 Gradle 版本,也可以使用命令行更新 Gradle 版本。首选方法是使用?Gradle 封装容器命令行工具,该工具可更新?gradlew
?脚本。以下示例使用 Gradle 封装容器将 Gradle 的版本设置为 8.2。
gradle wrapper --gradle-version 8.2
如果报gradle 和 jdk版本号不匹配。搜索 Java and gradle compatibility matrix 进入gradle官网。
Java version | Support for compiling/testing/…? | Support for running Gradle |
---|---|---|
8 | N/A | 2.0 |
9 | N/A | 4.3 |
10 | N/A | 4.7 |
11 | N/A | 5.0 |
12 | N/A | 5.4 |
13 | N/A | 6.0 |
14 | N/A | 6.3 |
15 | 6.7 | 6.7 |
16 | 7.0 | 7.0 |
17 | 7.3 | 7.3 |
18 | 7.5 | 7.5 |
19 | 7.6 | 7.6 |
20 | 8.1 | 8.3 |
21 | 8.4 | 8.5 |
进project structure -> SDK Location -> Gradle Settings 设置jdk版本号。
Android Studio 2.2 及更高版本捆绑提供了最新版本的 OpenJDK,这是我们建议用于 Android 项目的 JDK 版本。如需使用捆绑的 JDK,请执行以下操作: