AndroidStuido gradle 版本兼容问题排错

56 阅读1分钟

AndroidStuido 很好用,但是兼容问题太差了,之前的版本好好的编译通过,结果升级下AndroidStuido, 结果编译不过了,最常见的问题,就是gradle版本问题报错。

gradle 插件和gradle版本的对应关系

gradle 插件: 就是build.gradle 里面的 classpath 例如:

classpath 'com.android.tools.build:gradle:8.13.0'

gradle 版本: 就是gradle\wrapper\gradle-wrapper.properties 文件中的gradle配置,例如:

distributionUrl=https://services.gradle.org/distributions/gradle-8.13-bin.zip

好了,我们现在来按照官网给出的版本适配要求进行修改,基本上就能解决这个gradle版本报错的问题。 developer.android.google.cn/build/relea…

插件版本所需的最低 Gradle 版本
8.138.13
8.128.13
8.118.13
8.108.11.1
8.98.11.1
8.88.10.2
8.78.9
8.68.7
8.58.7
8.48.6
8.38.4
8.28.2
8.18.0
8.08.0

升级AndroidStudio后,不仅仅gralde版本要符合兼容要求,API 编译也有要求,详情情况下表:

API 级别最低 Android Studio 版本最低 AGP 版本
36.1Narwhal 3 功能更新 2025.1.38.13.0
36.0Meerkat 2024.3.1 Patch 18.9.1
35Koala 功能更新 2024.2.18.6.0
34Hedgehog 2023.1.18.1.1
33Flamingo 2022.2.17.2

AGP: Android Gradle Plugin

例如:你升级了AndroidStudio 到2025.1.3 版本,那么你就必须用36.1 的SDK进行编译,gradle的插件版本必须高于8.13.0 相应的 gradle 版本也要进行修改了。 如上,记录下排错经历。