gradle-wrapper.properties中各属性的含义

gradle-wrapper.properties中各属性的含义

1. gradle-wrapper.properties

每一个用gradle编译的工程，都会有一个gradle\wrapper目录。该目录下有2个文件：gradle-wrapper.jar和gradle-wrapper.properties。

其中gradle-wrapper.properties的内容如下：

distributionBase=GRADLE_USER_HOMEdistributionPath=wrapper/distszipStoreBase=GRADLE_USER_HOMEzipStorePath=wrapper/distsdistributionUrl=https\://services.gradle.org/distributions/gradle-3.1-bin.zip
1
2
3
4
5
1
2
3
4
5

注：目前最新的是3.3版。

1.1 distributionUrl

distributionUrl是要下载的gradle的地址，使用哪个版本的gradle，就在这里修改。

gradle的3种版本：

1. gradle-xx-all.zip是完整版，包含了各种二进制文件，源代码文件，和离线的文档。例如，https://services.gradle.org/distributions/gradle-3.1-all.zip

2. gradle-xx-bin.zip是二进制版，只包含了二进制文件（可执行文件），没有文档和源代码。例如，https://services.gradle.org/distributions/gradle-3.1-bin.zip

3. gradle-xx-src.zip是源码版，只包含了Gradle源代码，不能用来编译你的工程。例如，https://services.gradle.org/distributions/gradle-3.1-src.zip

如果只是为了编译，可以不用完整版，只需要二进制版即可，例如，gradle-3.1-bin.zip。

1.2 其他4个属性

zipStoreBase和zipStorePath组合在一起，是下载的gradle-3.1-bin.zip所存放的位置。 
zipStorePath是zipStoreBase指定的目录下的子目录。

distributionBase和distributionPath组合在一起，是解压gradle-3.1-bin.zip之后的文件的存放位置。 
distributionPath是distributionBase指定的目录下的子目录。

下载位置可以和解压位置不一样。

zipStoreBase和distributionBase有两种取值：GRADLE_USER_HOME和PROJECT。

其中，GRADLE_USER_HOME表示用户目录。 
在windows下是%USERPROFILE%/.gradle，例如C:\Users\<user_name>\.gradle\。 
在Linux下是$HOME/.gradle，例如~/.gradle。

PROJECT表示工程的当前目录，即gradlew所在的目录。

1.3 例1：各项属性的整体含义

例1，gradle-wrapper.properties的内容如下：

distributionBase=GRADLE_USER_HOMEdistributionPath=wrapper/distszipStoreBase=GRADLE_USER_HOMEzipStorePath=wrapper/distsdistributionUrl=https\://services.gradle.org/distributions/gradle-3.1-bin.zip
1
2
3
4
5
1
2
3
4
5

各项属性的整体含义，如下：

• （1） 去 https://services.gradle.org/distributions/gradle-3.1-bin.zip 下载gradle的3.1版本，只包含binary的版本。

• （2） 下载的gradle-3.1-bin.zip存放到C:\Users\<user_name>\.gradle\wrapper\dists目录中。 
  （注：具体还有2级目录，即全路径为C:\Users\<user_name>\.gradle\wrapper\dists\gradle-3.1-bin\<url-hash>\，gradle-3.1-bin目录是根据下载的gradle的文件名来定的，<url-hash>目录名是根据distribution url路径字符串计算md5值得来的，具体参考PathAssembler.Java中的rootDirName()和getHash()，PathAssembler.java的位置见本文最后的参考路径）

• （3） 解压gradle-3.1-bin.zip，将解压后的文件存放到C:\Users\<user_name>\.gradle\wrapper\dists中。（注：具体还有2级目录，同上）

1.4 搭建gradle测试环境

从任意一个gradle编译的工程中拷贝出gradle相关的文件，如下图： 
注：.gradle目录是后生成的。

在cmd或者cygwin中执行./gradlew即可。

1.5 例2：zipStoreBase=PROJECT，distributionBase=GRADLE_USER_HOME

例2，gradle-wrapper.properties的内容如下：

distributionBase=GRADLE_USER_HOMEdistributionPath=wrapper/distszipStoreBase=PROJECTzipStorePath=wrapper/distsdistributionUrl=https\://services.gradle.org/distributions/gradle-3.3-bin.zip
1
2
3
4
5
1
2
3
4
5

执行./gradlew，log如下：

Downloading https://services.gradle.org/distributions/gradle-3.3-bin.zip......Unzipping D:\gradle_env\wrapper\dists\gradle-3.3-bin\37bujujhbsnkqrb1fi6n3qirfu\gradle-3.3-bin.zip to C:\Users\galian\.gradle\wrapper\dists\gradle-3.3-bin\37bujujhbsnkqrb1fi6n3qirfu
1
2
3
4
1
2
3
4

含义：

• （1） 先将下载到zipStoreBase和zipStorePath指定的位置，即gradlew所在目录的wrapper/dists目录下，即D:\gradle_env\wrapper\dists\gradle-3.3-bin\37bujujhbsnkqrb1fi6n3qirfu\gradle-3.3-bin.zip。 
  注意：这里的gradle-3.3-bin\37bujujhbsnkqrb1fi6n3qirfu就是上面提到的2级目录。

• （2） 然后解压到distributionBase和distributionPath指定的位置，即user_home目录的wrapper/dists目录下，在我的电脑中位置：C:\Users\galian\.gradle \wrapper\dists\gradle-3.3-bin\37bujujhbsnkqrb1fi6n3qirfu 
  注意：这里的gradle-3.3-bin\37bujujhbsnkqrb1fi6n3qirfu就是上面提到的2级目录。

1.6 例3：zipStoreBase=PROJECT，distributionBase=PROJECT

把gradle-wrapper.properties中的distributionBase改为PROJECT：

distributionBase=PROJECTdistributionPath=wrapper/distszipStoreBase=PROJECTzipStorePath=wrapper/distsdistributionUrl=https\://services.gradle.org/distributions/gradle-3.3-bin.zip
1
2
3
4
5
1
2
3
4
5

执行./gradlew，log如下：

$ ./gradlewUnzipping D:\gradle_env\wrapper\dists\gradle-3.3-bin\37bujujhbsnkqrb1fi6n3qirfu\gradle-3.3-bin.zip to D:\gradle_env\wrapper\dists\gradle-3.3-bin\37bujujhbsnkqrb1fi6n3qirfu:helpWelcome to Gradle 3.3.To run a build, run gradlew <task> ...To see a list of available tasks, run gradlew tasksTo see a list of command-line options, run gradlew --helpTo see more detail about a task, run gradlew help --task <task>BUILD SUCCESSFULTotal time: 7.199 secs
1
2
3
4
5
6
7
8
9
10
11
12
1
2
3
4
5
6
7
8
9
10
11
12

含义：

• （1） 先将下载到zipStoreBase和zipStorePath指定的位置，即gradlew所在目录的wrapper/dists目录下。

• （2） 解压的位置也是gradlew所在目录中的wrapper/dists目录下。下载位置和解压位置是同一个位置。

注意：执行./gradlew前，需要将gradle-3.3-bin.zip.lck文件删除，否则会报如下错误：

Exception in thread "main" java.lang.RuntimeException: Gradle distribution 'D:\gradle_env\wrapper\dists\gradle-3.3-bin\37bujujhbsnkqrb1fi6n3qirfu' does not contain any directories. Expected to find exactly 1 directory.        at org.gradle.wrapper.Install.getDistributionRoot(Install.java:84)        at org.gradle.wrapper.Install.access$000(Install.java:29)        at org.gradle.wrapper.Install$1.call(Install.java:51)        at org.gradle.wrapper.Install$1.call(Install.java:47)        at org.gradle.wrapper.ExclusiveFileAccessManager.access(ExclusiveFileAccessManager.java:65)        at org.gradle.wrapper.Install.createDist(Install.java:47)        at org.gradle.wrapper.WrapperExecutor.execute(WrapperExecutor.java:129)        at org.gradle.wrapper.GradleWrapperMain.main(GradleWrapperMain.java:48)
1
2
3
4
5
6
7
8
9
10
1
2
3
4
5
6
7
8
9
10

2. 相关代码

gradle-3.3-src\gradle-3.3\subprojects\wrapper\src\main\java\org\gradle\wrapper\PathAssembler.java

    /**     * Determines the local locations for the distribution to use given the supplied configuration.     */    public LocalDistribution getDistribution(WrapperConfiguration configuration) {        String baseName = getDistName(configuration.getDistribution());        // distName是gradle-3.3-bin等，不带后缀        String distName = removeExtension(baseName);        // rootDirName是2级目录        String rootDirName = rootDirName(distName, configuration);        // distDir 是存放zip解压后的文件的目录        File distDir = new File(getBaseDir(configuration.getDistributionBase()), configuration.getDistributionPath() + "/" + rootDirName);        // distZip是存放下载的zip的目录        File distZip = new File(getBaseDir(configuration.getZipBase()), configuration.getZipPath() + "/" + rootDirName + "/" + baseName);        return new LocalDistribution(distDir, distZip);    }    // 获取2级目录：一级是gradle版本，另一级是url的hash值    private String rootDirName(String distName, WrapperConfiguration configuration) {        String urlHash = getHash(configuration.getDistribution().toString());        return distName + "/" + urlHash;    }    /**     * This method computes a hash of the provided {@code string}.     * <p>     * The algorithm in use by this method is as follows:     * <ol>     *    <li>Compute the MD5 value of {@code string}.</li>     *    <li>Truncate leading zeros (i.e., treat the MD5 value as a number).</li>     *    <li>Convert to base 36 (the characters {@code 0-9a-z}).</li>     * </ol>     */    private String getHash(String string) {        try {            MessageDigest messageDigest = MessageDigest.getInstance("MD5");            byte[] bytes = string.getBytes();            messageDigest.update(bytes);            return new BigInteger(1, messageDigest.digest()).toString(36);        } catch (Exception e) {            throw new RuntimeException("Could not hash input string.", e);        }    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

3. gradle各版本文件对比

以gradle3.3版本为例。

3.1 gradle-3.3-all.zip 和 gradle-3.3-bin.zip

bin版本比完整版少了3个目录：src、docs和samples。

3.2 gradle-3.3-all.zip 和 gradle-3.3-src.zip

src版是编译gradle的源码，src版的subprojects目录与完整版的src目录基本是一致的。 
src版是编译环境，所以源码目录结构都是gradle工程的结构。 
完整版的src目录，只是源文件，不能直接拿来编译。

4. 参考

• （1） https://docs.gradle.org/current/dsl/org.gradle.api.tasks.wrapper.Wrapper.html
• （2） https://docs.gradle.org/current/javadoc/org/gradle/api/tasks/wrapper/Wrapper.PathBase.html
• （3） http://services.gradle.org/distributions/gradle-3.3-src.zip
• （4） http://services.gradle.org/distributions
• （5） gradle-3.3-src\gradle-3.3\subprojects\wrapper\src\main\java\org\gradle\wrapper\PathAssembler.java

本文作者：Abracadabra(爱博客大伯) 

原文地址：http://blog.csdn.net/u013553529/article/details/55011602

相关阅读：

《gradle 用户指南中文版》目录