Android Studio报Gradle问题解决思路

Gradle的版本号与Android studio版本、AGP（Android Gradle Plugin）版本、jdk版本都有关系。只有同时匹配三个版本号，才能使用对应的Gradle版本。

1、AGP的版本号与Android studio版本的关系。

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

2、Gradle的版本号与AGP版本的关系。

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

 3、Gradle版本号与JDK版本号的关系。

如果报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版本号。

4、设置 JDK 版本

Android Studio 2.2 及更高版本捆绑提供了最新版本的 OpenJDK，这是我们建议用于 Android 项目的 JDK 版本。如需使用捆绑的 JDK，请执行以下操作：

1. 在 Android Studio 中打开您的项目，然后依次选择 File > Settings... > Build, Execution, Deployment > Build Tools > Gradle（在 Mac 上，依次选择 Android Studio > Preferences... > Build, Execution, Deployment > Build Tools > Gradle）。
2. 在 Gradle JDK 下，选择 Embedded JDK 选项。
3. 点击 OK。