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

叁歲伎倆 2023-10-14 19:39 75阅读 0赞

#### 文章目录 ####

*  一、错误记录
 *  二、问题分析
 *  三、解决方案

## 一、错误记录 ##

--------------------

**报错信息 :**

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

![在这里插入图片描述][e090d59fcfbb4787b7346e27480aba44.png]

## 二、问题分析 ##

--------------------

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

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

与当前差异很大 ;

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

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

<table> 
 <thead> 
  <tr> 
   <th>Android Gradle 插件版本</th> 
   <th>所需的最低 Gradle 构建工具版本</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>8.1</td> 
   <td>8.0</td> 
  </tr> 
  <tr> 
   <td>8.0</td> 
   <td>8.0</td> 
  </tr> 
  <tr> 
   <td>7.4</td> 
   <td>7.5</td> 
  </tr> 
  <tr> 
   <td>7.3</td> 
   <td>7.4</td> 
  </tr> 
  <tr> 
   <td>7.2</td> 
   <td>7.3.3</td> 
  </tr> 
  <tr> 
   <td>7.1</td> 
   <td>7.2</td> 
  </tr> 
  <tr> 
   <td>7.0</td> 
   <td>7.0</td> 
  </tr> 
  <tr> 
   <td>4.2.0+</td> 
   <td>6.7.1</td> 
  </tr> 
  <tr> 
   <td><strong>Android Gradle 插件版本 ( 旧版本 )</strong></td> 
   <td><strong>所需的 Gradle 版本 ( 旧版本 )</strong></td> 
  </tr> 
  <tr> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>4.1.0+</td> 
   <td>6.5+</td> 
  </tr> 
  <tr> 
   <td>4.0.0+</td> 
   <td>6.1.1+</td> 
  </tr> 
  <tr> 
   <td>3.6.0 - 3.6.4</td> 
   <td>5.6.4+</td> 
  </tr> 
  <tr> 
   <td>3.5.0 - 3.5.4</td> 
   <td>5.4.1+</td> 
  </tr> 
  <tr> 
   <td>3.4.0 - 3.4.3</td> 
   <td>5.1.1+</td> 
  </tr> 
  <tr> 
   <td>3.3.0 - 3.3.3</td> 
   <td>4.10.1+</td> 
  </tr> 
  <tr> 
   <td>3.2.0 - 3.2.1</td> 
   <td>4.6+</td> 
  </tr> 
  <tr> 
   <td>3.1.0+</td> 
   <td>4.4+</td> 
  </tr> 
  <tr> 
   <td>3.0.0+</td> 
   <td>4.1+</td> 
  </tr> 
  <tr> 
   <td>2.3.0+</td> 
   <td>3.3+</td> 
  </tr> 
  <tr> 
   <td>2.1.3 - 2.2.3</td> 
   <td>2.14.1 - 3.5</td> 
  </tr> 
  <tr> 
   <td>2.0.0 - 2.1.2</td> 
   <td>2.10 - 2.13</td> 
  </tr> 
  <tr> 
   <td>1.5.0</td> 
   <td>2.2.1 - 2.13</td> 
  </tr> 
  <tr> 
   <td>1.2.0 - 1.3.1</td> 
   <td>2.2.1 - 2.9</td> 
  </tr> 
  <tr> 
   <td>1.0.0 - 1.1.3</td> 
   <td>2.2.1 - 2.3</td> 
  </tr> 
 </tbody> 
</table>

**Android Gradle 插件和 Android Studio 兼容版本 :**

<table> 
 <thead> 
  <tr> 
   <th>Android Studio 版本</th> 
   <th>所需插件版本</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Giraffe | 2022.3.1</td> 
   <td>3.2-8.1</td> 
  </tr> 
  <tr> 
   <td>Flamingo | 2022.2.1</td> 
   <td>3.2-8.0</td> 
  </tr> 
  <tr> 
   <td>Electric Eel | 2022.1.1</td> 
   <td>3.2-7.4</td> 
  </tr> 
  <tr> 
   <td>Dolphin | 2021.3.1</td> 
   <td>3.2-7.3</td> 
  </tr> 
  <tr> 
   <td>Chipmunk | 2021.2.1</td> 
   <td>3.2-7.2</td> 
  </tr> 
  <tr> 
   <td>Bumblebee | 2021.1.1</td> 
   <td>3.2-7.1</td> 
  </tr> 
  <tr> 
   <td>Arctic Fox | 2020.3.1</td> 
   <td>3.1-7.0</td> 
  </tr> 
 </tbody> 
</table>

查看 根目录下的 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 版本 , 不匹配 ;

![在这里插入图片描述][40abca28a2084e0f98201852ca285ade.png]

**有两个方案 :**

*  **降低 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 版本 ;

[e090d59fcfbb4787b7346e27480aba44.png]: https://img-blog.csdnimg.cn/e090d59fcfbb4787b7346e27480aba44.png
[https_developer.android.google.cn_studio_releases_gradle-plugin]: https://developer.android.google.cn/studio/releases/gradle-plugin?hl=ru
[40abca28a2084e0f98201852ca285ade.png]: https://img-blog.csdnimg.cn/40abca28a2084e0f98201852ca285ade.png