Gradle基础：13:使用本地文件方式的gradlew

gradlew指的就是gradle wrapper，可以使用gradle init生成。gradlew就是将gradle封装了一下，在实际使用中，使用gradle的地方直接换成gradlew即可，不必在意事前环境是否安装，是否按照期待进行了安装，一般在第一次使用的时候首先会缺省按照设定文件中指定的版本下载gradle展开到本用户指定的目录下，之后会直接使用此gradle，而在使用的时候第一次会下载gradle，这篇文章介绍一下使用本地zip包进行展开的方式。

事前准备

准备一个gradlew的使用示例，实际非常简单，使用gradle init即可，本文使用如下Gradle的镜像生成gradlew的使用示例。

执行命令：docker run --rm -it liumiaocn/gradle:jdk8.6.0.1 sh

liumiaocn:jar liumiao$ docker run --rm -it  liumiaocn/gradle:jdk8.6.0.1 sh
# gradle --version------------------------------------------------------------
Gradle 6.0.1
------------------------------------------------------------Build time:   2019-11-18 20:25:01 UTC
Revision:     fad121066a68c4701acd362daf4287a7c309a0f5Kotlin:       1.3.50
Groovy:       2.5.8
Ant:          Apache Ant(TM) version 1.10.7 compiled on September 1 2019
JVM:          1.8.0_232 (AdoptOpenJDK 25.232-b09)
OS:           Linux 4.9.184-linuxkit amd64# 

生成gradlew的使用示例

# mkdir test
# cd test
# ls
# gradle initSelect type of project to generate:1: basic2: application3: library4: Gradle plugin
Enter selection (default: basic) [1..4] 1Select build script DSL:1: Groovy2: Kotlin
Enter selection (default: Groovy) [1..2] 1Project name (default: test): test> Task :init
Get more help with your project: https://guides.gradle.org/creating-new-gradle-buildsBUILD SUCCESSFUL in 22s
2 actionable tasks: 2 executed
# find  -type f
./build.gradle
./gradlew.bat
./.gitignore
./settings.gradle
./gradle/wrapper/gradle-wrapper.jar
./gradle/wrapper/gradle-wrapper.properties
./gradlew
./.gradle/6.0.1/gc.properties
./.gradle/6.0.1/executionHistory/executionHistory.lock
./.gradle/6.0.1/executionHistory/executionHistory.bin
./.gradle/6.0.1/fileHashes/fileHashes.bin
./.gradle/6.0.1/fileHashes/fileHashes.lock
./.gradle/6.0.1/fileChanges/last-build.bin
./.gradle/buildOutputCleanup/buildOutputCleanup.lock
./.gradle/buildOutputCleanup/outputFiles.bin
./.gradle/buildOutputCleanup/cache.properties
./.gitattributes
# 

gradlew第一次执行

使用./gradlew执行并按CTRL + C中断执行，可以看到第一次执行时首先会下载gradle-6.0.1-bin.zip文件

# ls
build.gradle  gradle  gradlew  gradlew.bat  settings.gradle
# ./gradlew
Downloading https://services.gradle.org/distributions/gradle-6.0.1-bin.zip
^C#

而此下载版本Gradle的配置信息则是在wrapper的如下文件中进行设定的

# cat ./gradle/wrapper/gradle-wrapper.properties
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-6.0.1-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
# 

GRADLE_USER_HOME缺省指的则是~/.gradle目录，这也是distributionUrl下载地址的zip文件所要解压的目的目录, 修改此变量地址指向本地zip文件

# cat gradle/wrapper/gradle-wrapper.properties
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=file:///usr/local/download/gradle-6.0.1-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
# 

并在本地实现保存相应的zip文件

# ls /usr/local/download/gradle-6.0.1-bin.zip
/usr/local/download/gradle-6.0.1-bin.zip
# 

这样第一次执行时就会直接使用本地文件了，执行结果如下所示：

# ./gradlew
Downloading file:/usr/local/download/gradle-6.0.1-bin.zip
.........10%.........20%.........30%.........40%.........50%.........60%.........70%.........80%.........90%.........100%Welcome to Gradle 6.0.1!
...省略
BUILD SUCCESSFUL in 7s
1 actionable task: 1 executed
# 

执行之后可以看到~/.gradle下也展开了相应的文件

# find ~/.gradle -type f
/root/.gradle/native/jansi/1.18/linux64/libjansi.so
/root/.gradle/native/30/linux-amd64/libnative-platform.so
...省略
/root/.gradle/wrapper/dists/gradle-6.0.1-bin/9urc0czldohtc4p99uuywire5/gradle-6.0.1-bin.zip
# 

总结

实际上这种使用gradlew的方法并没有太多实际的意义，使用gradlew一般是同一个用户可能会使用不同版本的gradle，希望在多个版本自由选择和切换时；或者是不同用户使用同一个版本，对于系统级别的gradle为了避免各个用户之间相互影响，所以使用wrapper可以保证每个用户有自己独立不受影响的gradle环境，或者此两种情况的组合，这才是gradlew实际的常见使用场景。不过已经使用了gradlew并希望不改变这个现状，同时使用时无法连接外网的这种有限场景可以使用本文介绍的方式进行对应。