【错误记录】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
1
2
3
4
5

二、问题分析

---

使用的 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 插件和 Android Studio 兼容版本 :

查看 根目录下的 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
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13

然后再查看 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
1
2
3
4
5
6

这个版本太低了 , 至少与当前的 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 版本 ;