2.3 升级Gradle版本

通常，在Android Studio里创建一个新的Android应用时，我们并没有手动安装Gradle，Android Studio会创建一个gradlew.bat文件^[1],通过Gradle Wrapper来帮助我们自动下载并安装对应版本的Gradle.
在Android Studio的Terminal里,我们可以通过gradlew -v命令查看自己当前项目采用的Gradle版本:

D:\Androidworkspace\GradleTest>gradlew -v

------------------------------------------------------------
Gradle 2.14.1
------------------------------------------------------------

或者在Android Studio的Project Structure工具里点击Project选项(快捷键:Ctrl+Alt+Shift+S),就可以看到当前项目的Gradle版本以及Gradle插件的版本.
如果想知道目前最新的Gradle版本是什么,可以到
http://services.gradle.org/distributions
查看Gradle的各版本,也可以在这里手动下载不同版本的Gradle:

G 1

可以看到目前最新版本是3.5,对于我们Android开发人员来说,推荐下载-all结尾的版本,相比-bin结尾的版本,-all结尾的版本还给我们的IDE提供了API/DSL文档.

如果我们想要更新Gradle版本,也是通过Gradle Wrapper来实现,主要由以下两种途径:

1. 通过在项目的build.gradle文件添加wrapper任务:

task wrapper(type: Wrapper) {
    distributionType = Wrapper.DistributionType.ALL
    gradleVersion = 3.5
}

然后点击Sync Now就可以了.在Terminal里输入gradlew wrapper,执行wrapper任务,我们可以更清楚的看到执行的过程:

D:\Androidworkspace\GradleTest>gradlew wrapper
Observed package id 'add-ons;addon-google_apis-google-23' in inconsistent location 'D:\Android\Android\sdk\add-ons\addon-google_apis-google-23-1' (Expected 'D:\Android\Android\sdk\add-ons\addon-google_apis-google-23')
Already observed package id 'add-ons;addon-google_apis-google-23' in 'D:\Android\Android\sdk\add-ons\addon-google_apis-google-23'. Skipping duplicate at 'D:\Android\Android\sdk\add-ons\addon-google_apis-google-23-1'
Observed package id 'add-ons;addon-google_apis-google-23' in inconsistent location 'D:\Android\Android\sdk\add-ons\addon-google_apis-google-23-1' (Expected 'D:\Android\Android\sdk\add-ons\addon-google_apis-google-23')
Already observed package id 'add-ons;addon-google_apis-google-23' in 'D:\Android\Android\sdk\add-ons\addon-google_apis-google-23'.   Skipping duplicate at 'D:\Android\Android\sdk\add-ons\addon-google_apis-google-23-1'
:wrapper

BUILD SUCCESSFUL

Total time: 6.011 secs

此时再在Terminal里输入gradlew -v,可以看到:

D:\Androidworkspace\GradleTest>gradlew -v

------------------------------------------------------------
Gradle 3.5
------------------------------------------------------------

打开gradle-wrapper.properties文件,也可以看到distributionUrl也已经改变:

distributionUrl=https\://services.gradle.org/distributions/gradle-3.5-all.zip

说明已经升级成功了,并且可以在项目路径的.gradle文件夹里看到新建了一个名为gradle-3.5-all的文件夹(文件夹里的内容下面介绍的方法会讲述).

2. 编辑gradle-wrapper.properties文件里distributionUrl的值,替换成自己想要更新的版本,然后点击Sync Project with Gradle Files工具.
   这种方法稍加变通会比较适合下载Gradle速度较慢的朋友,还是以升级到Gradle 3.5为例,具体做法是:
   a.到http://services.gradle.org/distributions下载Gradle 3.5的zip压缩包,下载后不要解压,后面Android Studio会自动帮我们解压.
   b.更改distributionUrl的值为:

distributionUrl=https\://services.gradle.org/distributions/gradle-3.5-all.zip

c.点击Android Studio的Sync Project with Gradle Files工具,当Android Studio底部Background Tasks进度条出现后稍等一会儿然后手动关掉任务.
d.到C:\Users\你的用户名\.gradle\wrapper\dists文件夹下,可以看到新生成了名为gradle-3.5-all的文件夹,里面还有一个文件名是乱码的文件夹,进入该文件夹,可以看到两个文件,分别名为:gradle-3.5-all.zip.lck和gradle-3.5-all.zip.part,删掉后缀名为part的文件^[2],并将之前下载好的zip压缩包放到这个文件夹里.
d.回到Android Studio,重新Sync Project with Gradle Files.
同步完成后再到我们刚才放置压缩包的文件夹下,可以看到文件变成了:

G 2

---

1. Unix类系统里是一个gradlew脚本 ↩

2. 这个文件是下载的缓存文件,下载完成会生成一个zip压缩包和名为gradle-3.5-all.zip.ok的文件 ↩