【Gradle】二、全新项目构建工具Gradle的体验

矫情吗；* 2023-10-09 15:08 24阅读 0赞

#### 全新项目构建工具Gradle的体验 ####

*  一、Gradle的项目结构
 *  二、Gradle 创建第一个项目
 *  三、Gradle 中的常用指令
 *  四、Wrapper 包装器
 *   *  1、Wrapper 介绍
     *  2、如何使用 Gradle Wrapper 呢？
     *  3、GradleWrapper 的执行流程：
     *  4、gradle-wrapper.properties 文件解读:
     *   *  \*\*那什么时候选择使用 gradle wrapper、什么时候选择使用本地 gradle?
         *  切换项目依赖的gradle

## 一、Gradle的项目结构 ##

Gradle 项目默认目录结构和 Maven 项目的目录结构一致,都是基于约定大于配置【Convention Over Configuration】。  
其完整项目目录结构如下所示：  
![在这里插入图片描述][eb2c503a746642cf8f4e7427a2a4b998.png]

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

## 二、Gradle 创建第一个项目 ##

spring 脚手架创建 gradle 第一个项目：[https://start.spring.io/][https_start.spring.io]  
![在这里插入图片描述][3d13dd2e5e9844d4b69b81048912623c.png]

![在这里插入图片描述][04d9bc369e0041dcb0fc09c6a3ea8edb.png]

![在这里插入图片描述][5b17aa18c09b432c9376ee81cc67cff0.png]

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

## 三、Gradle 中的常用指令 ##

![在这里插入图片描述][2ef1fcc5dfd34d659da422b49e1b9e2e.png]  
需要注意的是：gradle 的指令要在含有 build.gradle 的目录执行。

## 四、Wrapper 包装器 ##

### 1、Wrapper 介绍 ###

Gradle Wrapper 实际上就是对 Gradle 的一层包装，用于解决实际开发中可能会遇到的不同的项目需要不同版本的 Gradle 问题。例如：把自己的代码共享给其他人使用，可能出现如下情况:  
1.对方电脑没有安装 gradle 2.对方电脑安装过 gradle，但是版本太旧了

这时候，可以考虑使用 Gradle Wrapper 了。这也是官方建议使用 Gradle Wrapper 的原因。  
实际上有了 Gradle Wrapper 之后，我们本地是可以不配置 Gradle 的,  
下载 Gradle 项目后，使用 gradle 项目自带的 wrapper 操作也是可以的。

### 2、如何使用 Gradle Wrapper 呢？ ###

项目中的gradlew、gradlew.cmd脚本用的就是wrapper中规定的gradle版本。参见源码 而我们上面提到的gradle指令用的是本地gradle,所以gradle指令和gradlew指令所使用的gradle版本有可能是不一样的。  
`gradlew`、`gradlew.cmd`的使用方式与gradle使用方式完全一致，只不过把gradle指令换成了gradlew指令。  
当然,我们也可在终端执行 gradlew 指令时，指定指定一些参数,来控制 Wrapper 的生成，比如依赖的版本等，如下：  
![在这里插入图片描述][f7bb1b71e834409da8b881c7f3be12e6.png]

gradle wrapper --gradle-version=4.4：升级wrapper版本号,只是修改gradle.properties中wrapper版本，未实际下载 
    gradle wrapper --gradle-version 5.2.1 --distribution-type all :关联源码用

### 3、GradleWrapper 的执行流程： ###

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

![在这里插入图片描述][2bdc875c96ff4ec4b048964e5b9fb7b3.png]

### 4、gradle-wrapper.properties 文件解读: ###

![在这里插入图片描述][686daf2a2068440f9349a081aa9aaa99.png]  
注意：前面提到的 GRALE\_USER\_HOME 环境变量用于这里的 Gradle Wrapper 下载的特定版本的 gradle 存储目录。  
如 果我们没有配置过 GRALE\_USER\_HOME 环境变量,默认在当前用户目录下的.gradle 文件夹中。

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

下载别人的项目或者使用操作以前自己写的不同版本的gradle项目时：用Gradle wrapper,也即:gradlew  
什么时候使用本地gradle?  
新建一个项目时: 使用gradle指令即可。

#### 切换项目依赖的gradle ####

可自定义使用项目的gradle  
![在这里插入图片描述][a90744680f81437588c44903f5058713.png]  
也可以 修改gradle-wrapper.properties 配置文件。  
![在这里插入图片描述][1a32447818ce4e7bb5b43307e1b89ad0.png]

![在这里插入图片描述][7a008e7ff6344de7b50fe95189ad60a1.png]

[eb2c503a746642cf8f4e7427a2a4b998.png]: https://img-blog.csdnimg.cn/eb2c503a746642cf8f4e7427a2a4b998.png
[https_start.spring.io]: https://start.spring.io/
[3d13dd2e5e9844d4b69b81048912623c.png]: https://img-blog.csdnimg.cn/3d13dd2e5e9844d4b69b81048912623c.png
[04d9bc369e0041dcb0fc09c6a3ea8edb.png]: https://img-blog.csdnimg.cn/04d9bc369e0041dcb0fc09c6a3ea8edb.png
[5b17aa18c09b432c9376ee81cc67cff0.png]: https://img-blog.csdnimg.cn/5b17aa18c09b432c9376ee81cc67cff0.png
[2ef1fcc5dfd34d659da422b49e1b9e2e.png]: https://img-blog.csdnimg.cn/2ef1fcc5dfd34d659da422b49e1b9e2e.png
[f7bb1b71e834409da8b881c7f3be12e6.png]: https://img-blog.csdnimg.cn/f7bb1b71e834409da8b881c7f3be12e6.png
[2bdc875c96ff4ec4b048964e5b9fb7b3.png]: https://img-blog.csdnimg.cn/2bdc875c96ff4ec4b048964e5b9fb7b3.png
[686daf2a2068440f9349a081aa9aaa99.png]: https://img-blog.csdnimg.cn/686daf2a2068440f9349a081aa9aaa99.png
[a90744680f81437588c44903f5058713.png]: https://img-blog.csdnimg.cn/a90744680f81437588c44903f5058713.png
[1a32447818ce4e7bb5b43307e1b89ad0.png]: https://img-blog.csdnimg.cn/1a32447818ce4e7bb5b43307e1b89ad0.png
[7a008e7ff6344de7b50fe95189ad60a1.png]: https://img-blog.csdnimg.cn/7a008e7ff6344de7b50fe95189ad60a1.png