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的版本和部署。