一、错误记录
报错信息 :
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 版本 ;