深入探究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的版本和部署。