【错误记录】Android 编译报错 ( The project uses Gradle version which is incompatible with Android Studio )

一、错误记录

---

报错信息 :

Unsupported Gradle. 
The project uses Gradle version which is incompatible with Android Studio 2021.3.

Possible solution:
 - Open Gradle wrapper settings, upgrade version to 3.0 or newer and reload the project

二、问题分析

---

使用的 ijkplayer 版本是 0.8.8 版本的 , 这是 2018 年的版本 , 生成的 Android Studio 工程源码 也是 在 2018 年运行的 , 当时使用 的

• Android Studio 版本 ,
• Gradle 构建工具版本 ,
• Android Gradle 插件版本 ,

与当前差异很大 ;

上述 构建工具 , AS 开发环境 , AGP 插件 , 版本对应关系可以参考 https://developer.android.google.cn/studio/releases/gradle-plugin 文档 ;

Android Gradle 插件版本 与 对应的 最低 Gradle 构建工具版本 :

Android Gradle 插件版本	所需的最低 Gradle 构建工具版本
8.1	8.0
8.0	8.0
7.4	7.5
7.3	7.4
7.2	7.3.3
7.1	7.2
7.0	7.0
4.2.0+	6.7.1
Android Gradle 插件版本 ( 旧版本 )	所需的 Gradle 版本 ( 旧版本 )
—	—
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 Gradle 插件和 Android Studio 兼容版本 :

Android Studio 版本	所需插件版本
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
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

查看 根目录下的 build.gradle 中配置的 Android Gradle 插件版本号为 2.1.3 ;

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.1.3'

        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.4.1'
        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7'
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

然后再查看 gradle/wrapper/gradle-wrapper.properties 配置中的 Gradle 构建工具 版本号 , 是 2.14.1 版本 ;

#Wed Aug 24 16:26:25 CST 2016
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-2.14.1-all.zip

这个版本太低了 , 至少与当前的 Android Studio 版本 , 不匹配 ;

有两个方案 :

• 降低 Android Studio 版本 ;
• 提高 Gradle 构建工具 和 Android Gradle 插件 的版本 ;

三、解决方案

---

当前的 Android Studio 版本是 Dolphin | 2021.3.1 , 对应的 Android Gradle 插件版本是 3.2-7.3 ,

这里选择 最低的 Android Gradle 插件版本 3.2 ;

3.2.0 - 3.2.1 的 Android Gradle 插件版本对应的 Gradle 构建工具的版本是 4.6+ , 这里选择 gradle-4.6-all.zip 版本 ;