您的位置:

深入探究gradle-wrapper.properties

Gradle是一个面向Java、Android和Groovy应用程序的开源构建自动化工具,而Gradle Wrapper则是一个用于在项目中使用指定版本Gradle的自包含脚本。

一、wrapperVersion

Gradle Wrapper版本,用于确定下载和使用的Gradle版本。 这是一个字符串,它代表Gradle Wrapper的版本,格式应该像“gradle-5.6.2”。

wrapperVersion=5.6.2

如果Gradle版本无法解决特定的问题,可以通过更改wrapperVersion指定Gradle Wrapper使用的Gradle版本。

二、distributionUrl

指定从哪里下载Gradle二进制分发包。

distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.2-bin.zip

这里需要注意的是,distributionUrl的值是一条URL,用于指定Gradle二进制分发包的路径。使用distributions.gradle.org作为主机名时,在访问Gradle二进制分发包时会自动重定向到近地的服务,确保使用最快的下载。也可以将URL更改为指向企业内部的二进制发行版本。

三、zipStoreBase

Gradle Wrapper下载的Gradle分发包的基础路径。

zipStoreBase=GRADLE_USER_HOME

zipStoreBase表示Gradle分发包的基本中的存储路径,包括了cache和wrapper两个子路径。这里,我们将zipStoreBase设置为GRADLE_USER_HOME,将考虑环境变量“GRADLE_USER_HOME”的设置。如果未设置,则默认为用户目录下的“.gradle”目录。

四、zipStorePath

Gradle Wrapper下载的Gradle分发包的路径。

zipStorePath=wrapper/dists

zipStorePath是Gradle分发包下载文件的位置。如果指定了zipStoreBase,则此路径将成为zipStoreBase下的一个相对路径。

五、示例代码

举例来说,以下是一份完整的gradle-wrapper.properties文件示例:

#Mon Mar 16 11:18:17 CET 2020
distributionBase=GRADLE_USER_HOME
distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.2-bin.zip
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
wrapperVersion=5.6.2

在这个示例中,Gradle Wrapper将使用5.6.2版本的Gradle,并将从services.gradle.org下载该版本。下载的分发包将存储在用户的默认Gradle存储位置中的“wrapper/dists”目录中。

六、总结

通过修改gradle-wrapper.properties,可以轻松地配置Gradle Wrapper以指定使用特定版本的Gradle以及从特定位置下载Gradle二进制分发包。这能够使开发人员更好地控制和管理Gradle的版本和部署。