一、Gradle入门

【尚硅谷】Gradle教程-讲师：刘辉

生活明朗，万物可爱，人间值得，未来可期

一、Gradle入门

1.1 Gradle 简介

Gradle 是一款 Google 推出的基于 JVM、通用灵活的项目构建工具，支持 Maven，JCenter 多种第三方仓库。

支持传递性依赖管理、废弃了繁杂的 xml 文件，转而使用简洁的、支持多种语言(例如：java、groovy 等)的build 脚本文件。

Gradle官网地址

学习 Gradle 的原因：

1. 目前已经有相当一部分公司在逐渐使用Gradle作为项目构建工具了。
2. 作为Java开发程序员,如果想下载Spring、SpringBoot等Spring家族的源码，基本上基于Gradle构建的。

总之，虽然目前市面上常见的项目构建工具有 Ant、Maven、Gradle，主流还是 Maven，但是未来趋势 Gradle。

1.2 常见的项目构建工具

• Ant: 2000 年 Apache 推出的纯 Java 编写构建工具，通过 xml[build.xml]文件管理项目
  • 优点：使用灵活，速度快(快于 gradle 和 maven)。
  • 缺点：Ant 没有强加任何编码约定的项目目录结构，开发人员需编写繁杂 XML 文件构建指令，对开发人员是一个挑战。
• Maven：2004 年 Apache 组织推出的再次使用 xml 文件[pom.xml]管理项目的构建工具
  • 优点：遵循一套约定大于配置的项目目录结构，使用统一的 GAV 坐标进行依赖管理，侧重于包管理。
  • 缺点：项目构建过程僵化，配置文件编写不够灵活、不方便自定义组件，构建速度慢于 gradle。
• Gradle：2012 年 Google 推出的基于 Groovy 语言的全新项目构建工具，集合了 Ant 和 Maven 各自的优势
  • 优点：集 Ant 脚本的灵活性+Maven 约定大于配置的项目目录优势，支持多种远程仓库和插件，侧重于大项目构建。
  • 缺点：学习成本高、资料少、脚本灵活、版本兼容性差等。

Whatever:无论哪种项目构建工具，都有自身的优势和劣势，所以选择一款最适合自己的就是最好的。

1.3 Gradle 安装

1.3.1 Gradle 安装说明

SpringBoot 官方文档明确指出，目前 SpringBoot 的 Gradle 插件需要 gradle6.8 版本及以上，所以我们这里选择 7.x 版本。

其中 SpringBoot 与 Gradle 存在版本兼容问题，Gradle 与 Idea 也存在兼容问题，所以考虑到 java 程序员会使用 SpringBoot，所以要选择 6.8 版本及高于 6.8 版本的 Gradle，那么相应的 idea 版本也要升级,不能太老。

具体参考文档

在IDEA的目录中查看与当前版本匹配的gradle版本（IntelliJ IDEA 2022.1.3\plugins\gradle\lib）

1.3.2 安装 JDK

要求 Jdk 为 1.8 或者 1.8 版本以

1.3.3 下载并解压到指定目录

• 下载
  Gradle官网下载地址
  
  完整版与二进制的区别：
  增加Gradle文档与Gradle源码

• 解压到指定目录: D:\Environment\gradle-7.5.1（这个地址随意，自己能找到就可以）

1.3.4 配置环境变量

GRADLE_USER_HOME 相当于配置 Gradle 本地仓库位置和 Gradle Wrapper 缓存目录。

GRADLE_HOME
GRADLE_USER_HOME

1.3.5 检测是否安装成功

gradle -v 或者 gradle --version: 通过gradle -v或者 gradle --version检测是否安装成功

1.4 Gradle 项目目录结构

Gradle 项目默认目录结构和 Maven 项目的目录结构一致，都是基于约定大于配置【Convention Over Configuration】。
其完整项目目录结构如下所示：

Tipe：

1. 只有war工程才有webapp目录，对于普通的jar工程并没有webapp目录。
2. gradlew与gradlew.bat执行的指定wrapper版本中的gradle指令，不是本地安装的gradle指令哦。

1.5 Gradle 创建第一个项目

借助于 spring 脚手架创建 gradle第一个项目

查看生成的 gradle 项目目录结构如下所

与上图对比会发现：总体的目录结构与上图说明的是一致的。

1.5.1 Gradle 中的常用命令

Gradle 常用命令说明:

需要注意的是：gradle 的指令要在含有 build.gradle 的目录执行。

1.5.2 修改 maven 下载源

Gradle 自带的 Maven 源地址是国外的，该 Maven 源在国内的访问速度是很慢的，除非使用了特别的手段。

一般情况下，我们建议使用国内的第三方开放的 Maven 源或企业内部自建 Maven 源。

认识 init.d 文件夹

我们可以在 gradle 的 init.d 目录下创建以.gradle 结尾的文件，.gradle 文件可以实现在 build 开始之前执行，所以你可以在
这个文件配置一些你想预先加载的操作。

在 init.d 文件夹创建 init.gradle文件

allprojects {
	repositories { 
		mavenLocal()
		maven { name "Alibaba" ; url "https://maven.aliyun.com/repository/public" }
		maven { name "Bstek" ; url "https://nexus.bsdn.org/content/groups/public/" }
		mavenCentral()
	}
	buildscript {
		repositories { 
			maven { name "Alibaba" ; url 'https://maven.aliyun.com/repository/public' }
			maven { name "Bstek" ; url 'https://nexus.bsdn.org/content/groups/public/' }
			maven { name "M2" ; url 'https://plugins.gradle.org/m2/' }
		}
	}
}

拓展 1：启用 init.gradle

1. 在命令行指定文件,例如：gradle --init-script yourdir/init.gradle -q taskName。
   你可以多次输入此命令来指定多个init文件。
2. 把init.gradle文件放到 USER_HOME/.gradle/ 目录下（当前用户家目录下的.gradle文件夹下）。
3. 把以.gradle结尾的文件放到 USER_HOME/.gradle/init.d/ 目录下（当前用户家目录下的.gradle/init.d文件夹下）。
4. 把以.gradle结尾的文件放到 GRADLE_HOME/init.d/ 目录下。
   如果存在上面的4种方式的2种以上，gradle会按上面的1-4序号依次执行这些文件。
   如果给定目录下存在多个init脚本，会按拼音a-z顺序执行这些脚本，每个init脚本都存在一个对应的gradle实例。
   你在这个文件中调用的所有方法和属性，都会委托给这个gradle实例，每个init脚本都实现了Script接口。

拓展 2：仓库地址说明

mavenLocal()：指定使用maven本地仓库，而本地仓库在配置maven时settings文件指定的仓库位置。

如E:/repository，gradle 查找jar包顺序如下：USER_HOME/.m2/settings.xml >> M2_HOME/conf/settings.xml >> USER_HOME/.m2/repository

maven { url 地址}，指定maven仓库，一般用私有仓库地址或其它的第三方库【比如阿里镜像仓库地址】。

mavenCentral()：这是Maven的中央仓库，无需配置，直接声明就可以使用。

jcenter():JCenter中央仓库，实际也是是用的maven搭建的，但相比Maven仓库更友好，通过CDN分发，并且支持https访
问，在新版本中已经废弃了，替换为了mavenCentral()。

总之，gradle可以通过指定仓库地址为本地maven仓库地址和远程仓库地址相结合的方式，避免每次都会去远程仓库下载依赖库。

这种方式也有一定的问题，如果本地maven仓库有这个依赖，就会从直接加载本地依赖，如果本地仓库没有该依赖，那么还是会从远程下载。

但是下载的jar不是存储在本地maven仓库中，而是放在自己的缓存目录中，默认在USER_HOME/.gradle/caches目录，当然如果我们配置过GRADLE_USER_HOME环境变量，则会放在GRADLE_USER_HOME/caches目录。

不可以将gradle caches指向maven repository，caches下载文件不是按照maven仓库中存放的方式。

拓展 3：阿里云仓库地址

在 gradle 中的使用说明：

1.5.3 Wrapper 包装器

Gradle Wrapper 实际上就是对 Gradle 的一层包装，用于解决实际开发中可能会遇到的不同的项目需要不同版本的 Gradle 问题。

例如：把自己的代码共享给其他人使用，可能出现如下情况:

1. 对方电脑没有安装 gradle
2. 对方电脑安装过 gradle，但是版本太旧

这时候，我们就可以考虑使用 Gradle Wrapper 了。
这也是官方建议使用 Gradle Wrapper 的原因。

实际上有了 Gradle Wrapper 之后，我们本地是可以不配置 Gradle 的，下载 Gradle 项目后，使用 gradle 项目自带的 wrapper 操作也是可以的。

那如何使用 Gradle Wrapper 呢？

1. 项目中的gradlew、gradlew.cmd脚本用的就是wrapper中规定的gradle版本。参见源码
2. 而我们上面提到的gradle指令用的是本地gradle，所以gradle指令和gradlew指令所使用的gradle版本有可能是不一样的。
3. gradlew、gradlew.cmd的使用方式与gradle使用方式完全一致，只不过把gradle指令换成了gradlew指令。

当然,我们也可在终端执行 gradlew 指令时，指定指定一些参数,来控制 Wrapper 的生成，比如依赖的版本等，如下：

具体操作如下所示 ：
gradle wrapper --gradle-version=4.4：升级wrapper版本号，只是修改gradle.properties中wrapper版本，未实际下载
gradle wrapper --gradle-version 5.2.1 --distribution-type all

GradleWrapper 的执行流程：

1. 当我们第一次执行 ./gradlew build 命令的时候，gradlew 会读取 gradle-wrapper.properties 文件的配置信息
2. 准确的将指定版本的 gradle 下载并解压到指定的位置(GRADLE_USER_HOME目录下的wrapper/dists目录中)
3. 并构建本地缓存(GRADLE_USER_HOME目录下的caches目录中),下载再使用相同版本的gradle就不用下载了
4. 之后执行的 ./gradlew 所有命令都是使用指定的 gradle 版本。如下图所示：
   

gradle-wrapper.properties 文件解读

注意：
前面提到的 GRALE_USER_HOME 环境变量用于这里的 Gradle Wrapper 下载的特定版本的 gradle 存储目录。
如果我们没有配置过 GRALE_USER_HOME 环境变量，默认在当前用户家目录下的.gradle 文件夹中。

那什么时候选择使用 gradle wrapper、什么时候选择使用本地 gradle?

下载别人的项目或者使用操作以前自己写的不同版本的gradle项目时：用Gradle wrapper，也即:gradlew

当新建一个项目时: 使用gradle指令即可。