Gradle可以在没有安装Gradle的情况下使用,这时候就需要Gradle Wrapper了。Gradle Wrapper其实就是一个脚本文件,它会在没有安装Gradle的情况下为我们下载Gradle,之后我们就可以使用gradlew
命令,像使用gradle
一样来使用Gradle了。但是对于我们天朝用户来说,不管是Gradle还是Gradle Wrapper,都需要网络代理才能以较高的速度下载。
创建Gradle Wrappr文件
使用gradle wrapper
来创建一组Wrapper文件。Gradle官方建议我们在所有Gradle项目中都创建Wrapper文件,方便没有安装Gradle的用户使用。创建完毕之后,会发现我们的项目中多了如下一些文件:
- gradlew (Unix Shell 脚本)
- gradlew.bat (Windows批处理文件)
- gradle/wrapper/gradle-wrapper.jar (Wrapper JAR文件)
- gradle/wrapper/gradle-wrapper.properties (Wrapper属性文件)
然后,我们就可以像使用gradle
命令一样使用gradlew
了。Gradle Wrapper会自动为我们下载合适的Gradle版本。默认情况下,下载位置是$USER_HOME/.gradle/wrapper/dists
,如果设置了GRADLE_USER_HOME
环境变量,那么就会下载到GRADLE_USER_HOME/wrapper/dists
下。
设置Wrapper版本
使用gradle wrapper --gradle-version 3.2.1
来设置Wrapper的版本。或者也可以直接编辑gradle/wrapper/gradle-wrapper.properties
文件来修改版本。
文件内容如下,可以编辑最后面的gradle-3.3-all.zip
来配置版本。
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https://services.gradle.org/distributions/gradle-3.3-all.zip
然后使用gradlew -v
来查看变更之后的版本。每次更改版本,都会下载对应版本的Gradle文件。不过只需要下载一次,之后再次使用相同的版本就不会下载了。
参考资料
https://docs.gradle.org/current/userguide/gradle_wrapper.html