Gradle学习笔记使用Gradle Wrapper

悠悠 2022-07-13 09:13 262阅读 0赞

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][https_docs.gradle.org_current_userguide_gradle_wrapper.html]

[https_docs.gradle.org_current_userguide_gradle_wrapper.html]: https://docs.gradle.org/current/userguide/gradle_wrapper.html