目录

• 简介
• 安装gradle和解决gradle安装的问题
• Gradle特性
• 标准task
• Build phases
• Gradle Wrapper
• wrapper的使用
• wrapper的升级
• 一个简单的build.gradle
• gradle使用maven仓库
• 总结

简介

gradle的最新版本是6.7，从2009年的第一个版本，到2020年的6.7，已经发展了11年了。gradle是作为android的官方构建工具引入的，除了java，它还能够支持多种语言的构建，所以用途非常广泛。

gradle是开源的构建工具，你可以使用groovy或者kotlin来编写gradle的脚本，所以说gradle是一个非常强大的，高度定制化的和非常快速的构建工具。

根据我的了解，虽然gradle非常强大，但是对于java程序员来说，一般还是都使用的maven，或者同时提供maven和gradle两种构建方式。

为什么会这样呢？个人觉得有两个原因：

第一个原因是gradle安装文件和依赖包的网络环境，如果单单依靠国内的网络环境的话，非常难安装完成。

第二个原因就是gradle中需要自己编写构建脚本，相对于纯配置的脚本来说，比较复杂。

安装gradle和解决gradle安装的问题

gradle需要java8的支持，所以，你首先需要安装好JDK8或者以上的版本。

❯ java -version
java version "1.8.0_151"
Java(TM) SE Runtime Environment (build 1.8.0_151-b12)
Java HotSpot(TM) 64-Bit Server VM (build 25.151-b12, mixed mode)

安装gradle有两种方式，一种就是最简单的从官网上面下载安装包。然后解压在某个目录，最后将PATH指向该目录下的bin即可：

❯ mkdir /opt/gradle
❯ unzip -d /opt/gradle gradle-6.7-bin.zip
❯ ls /opt/gradle/gradle-6.7
LICENSE  NOTICE  bin  README  init.d  lib  media
export PATH=$PATH:/opt/gradle/gradle-6.7/bin

如果你想使用包管理器，比如MAC上面的brew来进行管理的话，则可以这样安装：

brew install gradle

但是这样安装很有可能在下载gradle安装包的时候卡住。

==> Downloading https://services.gradle.org/distributions/gradle-6.4.1-bin.zip
##O#- #

怎么办呢？

这时候我们需要自行下载gradle-6.4.1-bin.zip安装包，然后将其放入http服务器中，让这个压缩包可以通过http协议来访问。

简单点的做法就是将这个zip文件拷贝到IDEA中，利用IDEA本地服务器的预览功能，获得zip的http路径，比如：http://localhost:63345/gradle/gradle-6.7-all.zip.

接下来就是最精彩的部分了，我们需要修改gradle.rb文件：

brew edit gradle

使用上面的命令可以修改gracle.rb文件，我们替换掉下面的一段：

homepage "https://www.gradle.org/"
  url "https://services.gradle.org/distributions/gradle-6.7-all.zip"
  sha256 "0080de8491f0918e4f529a6db6820fa0b9e818ee2386117f4394f95feb1d5583"

url替换成为http://localhost:63345/gradle/gradle-6.7-all.zip，而sha256可以使用 sha256sum gradle-6.7-all.zip这个命令来获取。

替换之后，重新执行brew install gradle即可安装完成。

安装完毕之后，我们使用gradle -v命令可以验证是否安装成功：

gradle -v
Welcome to Gradle 6.7!

Gradle特性

gradle作为一种新的构建工具，因为它是依赖于groovy和kotlin脚本的，基于脚本的灵活性，我们通过自定义脚本基本上可以做任何想要的构建工作。

虽然说gradle可以做任何构建工作，但是gradle现在还是有一定的限制，那就是项目的依赖项目前只支持于maven和Ivy兼容的存储库以及文件系统。

gradle通过各种预定义的插件，可以轻松的构建通用类型的项目，并且支持自定义的插件类型。

另外一个非常重要的特性是gradle是以任务为基础的，每一个build都包含了一系列的task，这些task又有各自的依赖关系，然后这些task一起构成了一个有向无环图Directed Acyclic Graphs (DAGs)。

有了这个DAG，gradle就可以决定各个task的顺序，并执行他们。

我们看两个task DAG的例子，一个是通用的task，一个是专门的编译java的例子：

task可以依赖task，我们看个例子：

task hello {
    doLast {
        println 'Hello world!'
    }
}
task intro {
    dependsOn hello
    doLast {
        println "I'm Gradle"
    }
}

一个task可以包含Actions，inputs和Outputs。根据需要这些类型可以自由组合。

标准task

Gradle包含了下面7种标准的task：

• clean ：用来删除build目录和里面的一切。
  
• check：这是一个生命周期任务，通常做一些验证工作，比如执行测试任务等。
  
• assemble ：这是一个生命周期任务，用来生成可分发的文件，比如jar包。
  
• build： 也是一个生命周期任务，用来执行测试任务和生成最后的production文件。通常我们不在build中直接做任何特定的任务操作，它一般是其他任务的组合。
  
• buildConfiguration： 组装configuration中指定的archives。
  
• uploadConfiguration： 除了执行buildConfiguration之外，还会执行上传工作。
  
• cleanTask： 删除特定的某个task的执行结果。
  

Build phases

一个gradle的build包含了三个phases：

• Initialization： 初始化阶段。gradle支持一个或者多个project的build。在初始化阶段，gradle将会判断到底有哪些project将会执行，并且为他们分别创建一个project实例。
  
• Configuration： 配置阶段。gradle将会执行build脚本，然后分析出要运行的tasks。
  
• Execution： 执行阶段。gradle将会执行configuration阶段分析出来的tasks。
  

Gradle Wrapper

上面讲的是gradle的手动安装，如果是在多人工作的环境中使用了gradle，有没有什么办法可以不用手动安装gradle就可以自动运行gradle程序呢？

方法当然有，那就是gradle wrapper:

gradle wrapper是一个工具，通过它我们可以方便的对本地的gradle进行管理。

上图列出了gradle wrapper的工作流程，第一步是去下载gradle的安装文件，第二步是将这个安装文件解压到gradle的用户空间，第三步就是使用这个解压出来的gradle了。

我们先看下怎么创建gradle wrapper：

虽然Gradle wrapper的作用是帮我们下载和安装gradle，但是要生成gradle wrapper需要使用gradle命令才行。也就是说有了wrapper你可以按照成功gradle，有了gradle你才可以生成gradle wrapper。

假如我们已经手动按照好了gradle，那么可以执行下面的命令来生成gradle wrapper：

$ gradle wrapper
> Task :wrapper
BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed

先看下生成出来的文件结构：

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

gradle/wrapper/gradle-wrapper.properties 是 wrapper的配置文件，我们看下里面的内容：

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-6.7-all.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

其中distributionUrl就是我们要下载的gradle的路径，其他的配置是gradle的安装目录。

一般来说有两种安装文件类型：bin和all。bin和all的区别在于，bin只有安装文件，而all还包含了gradle的文档和样例代码。

我们可以通过--distribution-type参数来修改安装文件的类型。此外还有 --gradle-version ，--gradle-distribution-url和--gradle-distribution-sha256-sum 这几个参数可以使用。

$ gradle wrapper --gradle-version 6.7 --distribution-type all
> Task :wrapper
BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed

除了配置文件之外，我们还有3个文件：

• gradle-wrapper.jar： wrapper业务逻辑的实现文件。
  
• gradlew, gradlew.bat ：使用wrapper执行build的执行文件。也就是说我们可以使用wrapper来执行gradle的build任务。
  

wrapper的使用

我们可以这样使用gradlew,来执行build：

gradlew.bat build

注意，如果你是第一次在项目中执行build命令的话，将会自动为你下载和安装gradle。

wrapper的升级

如果我们想要升级gradle的版本，也很简单：

./gradlew wrapper --gradle-version 6.7

或者直接修改 gradle-wrapper.properties 也可以。

一个简单的build.gradle

我们看一个非常简单的gradle的例子：

plugins {
    id 'application' 
}
repositories {
    jcenter() 
}
dependencies {
    testImplementation 'junit:junit:4.13' 
    implementation 'com.google.guava:guava:29.0-jre' 
}
application {
    mainClass = 'demo.App' 
}

上面我们需要安装一个application plugin，使用的是jcenter的依赖仓库，还指定了几个具体的依赖项。最后，指明了我们应用程序的mainClass。

gradle使用maven仓库

build.gradle中的repositories指明的是使用的仓库选项。

默认情况下gradle有自己的本地仓库,一般在~/.gradle目录下面，如果我们之前用的是maven仓库，那么在本地的maven仓库中已经存在了很多依赖包了，如何重用呢？

我们可以这样修改repositories：

mavenLocal()
    mavenCentral()

这样的话, 就会优先从maven的仓库中查找所需的jar包。

总结

本文只是一个很简单的gradle介绍，让大家对gradle有一个基本的了解，后面我们会详细的介绍gradle的各种用法，敬请期待。