一、Gradle 手动创建一个项目

Gradle 介绍

Gradle 是一个快速的、可信的、适应性强的自动化构建工具，它是开源的。它使用优雅的并且可扩展的描述性语言。其他的介绍在官网可以了解。

Gradle Wrapper

官方建议使用 Gradle Wrapper 来执行任何构建，有如下好处：

1. 统一 Gradle 版本，并且是自动化的统一，当多个用户协作开发项目时，不需要每个人手动配置 Gradle，可由 IDE（如 IntelliJ IDEA） 自动配置。
2. 更改简单的 Wrapper 定义即可为不同用户配置不同的 Gradle 版本。
3. 更改简单的 Wrapper 定义即可为不同的构建环境配置不同的 Gradle 版本。

基于以上好处，我们就开始使用 Gradle Wrapper 来构建一个新的项目。

Gradle 使用

手动安装 Gradle

ℹ️ 注意
此处安装 Gradle 是为了执行后面的 Gradle 命令，实际项目中，即使版本和此 Gradle 一致，也不会使用此 Gradle。

使用 Gradle Wrapper 需要一个提前安装好的 Gradle，所以我们需要先安装一个可用的 Gradle，安装的这个 Gradle 只用于初始化用 Gradle Wrapper 构建的项目。

安装 Gradle 的步骤很简单，就是下载 Gradle 发行包，然后解压并配置环境变量（不配置环境变量也可以，在执行命令的时候要带上解压后 Gradle 的 bin 目录的相对路径或者绝对路径）。

此处下载的是 gradle-8.4-bin.zip 文件。

Gradle 发布地址在：https://gradle.org/releases/

将文件解压到 D:\tools，那么目录结构如下：

新增环境变量 GRADLE_HOME，值为 D:\tools\gradle-8.4。编辑 PATH 变量，增加条目 %GRADLE_HOME%\bin。

打开 CMD 窗口，输入以下命令测试 Gradle 是否安装成功。

$ gradle -v


------------------------------------------------------------
Gradle 8.4
------------------------------------------------------------

Build time:   2023-10-04 20:52:13 UTC
Revision:     e9251e572c9bd1d01e503a0dfdf43aedaeecdc3f

Kotlin:       1.9.10
Groovy:       3.0.17
Ant:          Apache Ant(TM) version 1.10.13 compiled on January 4 2023
JVM:          11.0.17 (Oracle Corporation 11.0.17+10-LTS-269)
OS:           Windows 11 10.0 amd64

初始化

参数介绍

初始化的构建任务名称是 wrapper，在初始化之前先介绍一下这个任务支持的参数：

• --gradle-version，作用是指定指定构建 Wrapper 的 Gradle 的版本，默认情况下是使用和执行 wrapper 任务相同的 Gradle 的版本，指定了之后会下载指定版本的 Gradle 并执行 wrapper 构建。使用方式是在后面增加 --gradle-version=xxx，此属性允许以下值：

  • latest
  • release-candidate
  • nightly
  • release-nightly
  • 具体的版本号，比如：7.5

• --distribution-type，Wrapper 使用的 Gradle 的类型，分别有 bin（默认） 和 all。这两种区别是 bin 仅含有二进制文件，而 all 还包含源码和 demo 代码，可以在 IDEA 中编写 Gradle 文件获得代码自动补全。当然下载 all 类型的文件的体积比 bin 的大。

• --gradle-distribution-url，Wrapper 下载 Gradle 发布包的 HTTP 链接。这个默认是使用官方的链接，当然可以替换成国内的镜像源，速度 可能 会快一点。

• --gradle-distribution-sha256-sum，验证下载的 Gradle 文件的 SHA256 哈希值，确保文件在下载过程中没有被篡改或者损坏。

• --network-timeout，指定下载 Gradle 文件的超时时间，默认 10000，单位是毫秒（ms）。

• --no-validate-url、--validate-url，这两个是成对的参数，表示是否启用对 URL（--gradle-distribution-url参数指定） 的验证，默认启用。

  验证 URL 的方式为：假如是 HTTPS 就发送一个 HEAD 请求；如果是文件系统，就检查文件是否存在。

开始初始化

参数介绍完毕，现在可以执行初始化了，

1. 首先新建 D:\test\gradle-wrapper-test 目录，这个是我们本次实验用到的目录，

2. 因为 Gradle 在运行 wrapper 任务时，会校验当前是否是一个 Gradle 项目，所以还需要新建一个 settings.gradle 文件，

3. 我在这里就写一个平时最基本的使用 Gradle Wrapper 的命令，特殊的可以根据上面的介绍自定义一些参数，在这个目录里面运行终端：

   $ gradle wrapper --gradle-version=7.5 --gradle-distribution-url=https://mirrors.cloud.tencent.com/gradle/gradle-7.5-bin.zip
   

ℹ️提示
https://mirrors.cloud.tencent.com/gradle/gradle-7.5-bin.zip 是腾讯云镜像。
此处未指定 --distribution-type 参数，因此默认为 bin 类型的压缩包，若手动指定了 --distribution-type=all，那么 --gradle-distribution-url 对应使用 https://mirrors.cloud.tencent.com/gradle/gradle-7.5-all.zip。

执行完成后，目录下会出现一个 gradle 目录，分别有两个文件：

• gradle/wrapper/gradle-wrapper.jar
• gradle/wrapper/gradle-wrapper.properties

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-7.5-bin.zip
networkTimeout=10000
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

到此就已经完成了使用 Wrapper 方式创建 Gradle 项目的实验了。

需要版本控制的文件和文件夹

对于 Git 等版本控制系统来说，需要记录的是下面的文件和文件夹：

• gradle
• gradlew
• gradlew.bat

使用 Gradle 构建项目

使用 Gradle wrapper 构建项目时，应使用项目中自动生成的两个文件来执行 Gradle 任务：

• gradlew：用于 Linux 环境
• gradlew.bat：用于 Windows 环境

另外假如需要使用 Gradle 构建此项目，比如运行 build 任务，注意要使用项目下的 gradlew.bat（Unix 系统使用 gradlew）。