最新版gradle安装使用简介

客官°小女子只卖身不卖艺 2022-10-29 02:00 569阅读 0赞

### 文章目录 ###

*  简介
 *  安装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，它还能够支持多种语言的构建，所以用途非常广泛。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_0_text_aHR0cDovL3d3dy5mbHlkZWFuLmNvbQ_size_25_color_8F8F8F_t_70][]

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的例子：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_0_text_aHR0cDovL3d3dy5mbHlkZWFuLmNvbQ_size_25_color_8F8F8F_t_70 1][]

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:

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_0_text_aHR0cDovL3d3dy5mbHlkZWFuLmNvbQ_size_25_color_8F8F8F_t_70 2][]

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的各种用法，敬请期待。

> 本文已收录于 [http://www.flydean.com/gradle-kick-off/][http_www.flydean.com_gradle-kick-off]
> 
> 最通俗的解读，最深刻的干货，最简洁的教程，众多你不知道的小技巧等你来发现！
> 
> 欢迎关注我的公众号:「程序那些事」,懂技术，更懂你！

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_0_text_aHR0cDovL3d3dy5mbHlkZWFuLmNvbQ_size_25_color_8F8F8F_t_70]: /images/20221024/8d97fa1ad0b241418e38a6be32f452f3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_0_text_aHR0cDovL3d3dy5mbHlkZWFuLmNvbQ_size_25_color_8F8F8F_t_70 1]: /images/20221024/d288120a2f3e4559b1d2fa1fcbf53b7f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_0_text_aHR0cDovL3d3dy5mbHlkZWFuLmNvbQ_size_25_color_8F8F8F_t_70 2]: /images/20221024/fa64063c1b304f75a998e6983b09622a.png
[http_www.flydean.com_gradle-kick-off]: http://www.flydean.com/gradle-kick-off/