Android Studio 中 gradle 的两个版本号对应关系

问题描述

使用 Android Studio 开发的小伙伴，是不是经常被 gradle 折磨的死去活来，其实它很多地方还是很方便的。

今天我们说的是 gradle 版本号的问题。一个是我们看到的 gradle 版本（例如 4.4），另一个是在工程下面看到的版本，例如 classpath ‘com.android.tools.build:gradle:3.1.2’

注意：对照关系表在文章末尾。

 

gradle 的版本号怎么指定

如图所示，我们可以在菜单栏 File -> Projuect Structure 打开工程结构窗口，并在 Project 一项中选择 Gradle Verison。

同时，在 gradle-wrapper.properties 文件中，指定了你的 gradle 的下载路径和版本。

 

PS：如果遇到被墙导致 gradle 一直下载不下来，卡住的情况，可以如下解决：

1. 修改 gradle-wrapper.properties 文件中 distributionUrl 的值，改成一个国内的 gradle 资源下载地址。
2. 直接搜索 gradle ，并通过网盘等不会被墙的形式，下载到你需要的 gradle 版本，然后放到如下目录：

C:\Users\<你的账户>.gradle\wrapper\dists\gradle-4.4-all\9br9xq1tocpiv8o6njlyu5op1\

注意这里账户每个人的都不一样，根据自己的情况寻找，然后最后那一串乱码一样的是随机生成的，将已下载好的 gradle-4.4-all.zip 放到这个目录下就行，不用解压，重启 Android Studio 即可，Android Studio 会自动完成解压操作的。如下所示：

 

---

 

好了，回到主题，我们可以注意到，工程的 build.gradle 文件下还有一个这样的 classpath ‘com.android.tools.build:gradle:3.1.2’ 描述，这个看上去也像是在描述 gradle 版本号的东东，但是它又不是 4.4。所以它又是指什么呢？

// Top-level build file where you can add configuration options common to all sub-projects/modules.

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

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        google()
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

 

gradle 插件版本号

其实这个 classpath ‘com.android.tools.build:gradle:3.1.2’ 指的是 gradle 插件的版本号，而不是 gradle 的版本号。

不过 gradle 插件的版本号和 gradle 的版本号又是有关联的，关系如下： 

插件版本号	需要的 Gradle 版本号
1.0.0 - 1.1.3	2.2.1 - 2.3
1.2.0 - 1.3.1	2.2.1 - 2.9
1.5.0	2.2.1 - 2.13
2.0.0 - 2.1.2	2.10 - 2.13
2.1.3 - 2.2.3	2.14.1+
2.3.0+	3.3+
3.0.0+	4.1+
3.1.0+	4.4+
3.2.0 - 3.2.1	4.6+
3.3.0 - 3.3.2	4.10.1+

​如果对应关系存在更新，而上表中没有更新到，可以转步到官网中查看，地址：

https://developer.android.com/studio/releases/gradle-plugin