问题及解决方案
更新到蜥蜴 Android Studio Iguana 后,出现Gradle project sync failed的问题(IDE更新版本的常态了)。
背景:对应用进行Android V版本升级(SDK=35,gradle插件版本要 8.4.0)
1、Gradle 版本过低
报错信息:
FAILURE: Build failed with an exception.
* Where:
Build file 'E:\code\Demo\app\build.gradle' line: 1* What went wrong:
A problem occurred evaluating project ':app'.
> Failed to apply plugin 'com.android.internal.version-check'.
> Minimum supported Gradle version is 8.6. Current version is 8.2. If using the gradle wrapper, try editing the distributionUrl in E:\code\Demo\gradle\wrapper\gradle-wrapper.properties to gradle-8.6-all.zip
2、应用项目没有gradle文件夹
因此并不能按提示配置版本号,正常Project文件夹如下:
缺少gradle文件夹可以自行创建/拷贝生成,然后修改版本号为8.6
#Tue Jun 27 15:58:22 CST 2023
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.6-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
下载中 :
3、 Gradle 插件与IDE/项目不匹配
解决了问题2下载完之后出现问题了
The project is using an incompatible version (AGP 8.4.0) of the Android Gradle plugin. Latest supported version is AGP 8.3.0
See Android Studio & AGP compatibility options.
总结
1、Gradle 及插件版本需要匹配
插件版本 | 所需的最低 Gradle 版本 |
---|---|
8.4 | 土耳其里拉 |
8.3 | 8.4 |
8.2 | 8.2 |
8.1 | 8.0 |
8.0 | 8.0 |
7.4 | 7.5 |
参考官方说明:Android Gradle 插件 8.4 版本说明 | Android Studio | Android Developers
2、Android V应用升级,必须用Jellyfish(水母)或更高的 IDE,因为SDK35需要gradle 8.4 (AGP 8.4.0)。
Android Studio 版本 | 所需的 AGP 版本 |
---|---|
Koala | 2024 年 1 月 1 日 | 3.2-8.5 |
Jellyfish | 2023.3.1 | 3.2-8.4 |
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 |
参考官方说明:Android Studio Jellyfish | 2023.3.1 | Android Developers