wrapper

使用wrapper可以很方便的在當(dāng)前項(xiàng)目直接使用gradlew命令執(zhí)行，而不用去部署gradle環(huán)境。
使用gradle wrapper命令后將在當(dāng)前項(xiàng)目下生成 gradle wrapper相關(guān)的文件。
wrapper附帶的文件：

├─gradle
│  └─wrapper
│          gradle-wrapper.jar
│          gradle-wrapper.properties
├─gradlew
├─gradlew.bat 

基本使用

指定gradle版本

修改gradle wrapper的版本，默認(rèn)是BIN文件，不含源代碼的gradle，下載帶源碼方便學(xué)習(xí)使用，體積較大

gradle wrapper --gradle-version 4.1

對(duì)應(yīng)的配置文件，gradle/wrapper/gradle-wrapper.properties

#Mon Sep 04 13:49:34 GMT+08:00 2017
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-4.1-bin.zip

指定版本和文件類(lèi)型

gradle wrapper --distribution-type ALL --gradle-version 4.1

#Mon Sep 04 13:55:17 GMT+08:00 2017
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-4.1-all.zip

指定版本、類(lèi)型、下載地址

由于網(wǎng)絡(luò)等原因，官網(wǎng)下載gradle 速度往往比較慢，這時(shí)我們可以配置下載地址，可以執(zhí)行內(nèi)網(wǎng)的文件或者網(wǎng)絡(luò)較好的鏡像站點(diǎn)。

這里使用http://mirrors.flysnow.org/的鏡像文件，非常感謝提供。

gradle wrapper --distribution-type ALL --gradle-distribution-url http://mirrors.flysnow.org/gradle/gradle-4.1-all.zip --gradle-version 4.1

#Mon Sep 04 14:23:56 GMT+08:00 2017
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=http\://mirrors.flysnow.org/gradle/gradle-4.1-all.zip

Gradle wrapper 對(duì)應(yīng)的源碼

可以查看源碼了解到wrapper做了什么東東，包括下載gradle、執(zhí)行g(shù)radle命令等
~/.gradle/wrapper/dists/gradle-4.1-all/bzyivzo6n839fup2jbap0tjew/gradle-4.1/src/wrapper/org/gradle/wrapper/GradleWrapperMain.java

更新wrapper

更新Gradle wrapper時(shí)最好是通過(guò)執(zhí)行wrapper task，會(huì)自動(dòng)更新一系列對(duì)應(yīng)的文件，而不用手動(dòng)復(fù)制粘貼。

cli help

gradle help --task wrapper

:help
Detailed task information for wrapper

Path
     :wrapper

Type
     Wrapper (org.gradle.api.tasks.wrapper.Wrapper)

Options
     --distribution-type     The type of the Gradle distribution to be used by the wrapper.
                             Available values are:
                                  ALL
                                  BIN

     --gradle-distribution-url     The URL to download the Gradle distribution from.

     --gradle-version     The version of the Gradle distribution required by the wrapper.

Description
     Generates Gradle wrapper files. [incubating]

Group
     Build Setup

BUILD SUCCESSFUL

Total time: 0.97 secs