😄作者简介： 小曾同学.com,一个致力于测试开发的博主⛽️，主要职责：测试开发、CI/CD
如果文章知识点有错误的地方，还请大家指正，让我们一起学习，一起进步。
😊 座右铭：不想当开发的测试，不是一个好测试✌️。
如果感觉博主的文章还不错的话，还请点赞、收藏哦！👍
文章目录
- 一 Gradle 是什么❤️
- 二 Gradle 安装🌟
- 三 牛刀小试 🫘
- 四 gradle wrapper 🤝
- 五 Gradle 日志级别及日志信息调试 🔥
- 5.1 Gradle 日志级别
- 5.2 日志信息调试
- 六 Gradle 如何输出堆栈信息 📖
- 七 小结 ❤️
一 Gradle 是什么❤️
Gradle 是一个基于JVM的构件工具，也是一个基于Groovy语言的，其build 脚本使用Groovy DSL编写的，（DSL是域描述性语言，在后面的文章会为小伙伴们讲解）。
Gradle是适用于自动化地进行软件构建、测试、发布、部署、软件打包的项目。
二 Gradle 安装🌟
在使用Gradle工具之前，需要具备jdk环境，我本地安装的是jdk 1.8
➜ ~java -version
java version "1.8.0_291"
Java(TM) SE Runtime Environment (build 1.8.0_291-b10)
Java HotSpot(TM) 64-Bit Server VM (build 25.291-b10, mixed mode)
因为我是Mac环境，所以在Mac中安装Gradle如下：
➜ ~ brew install gradle
# 目前最新版本是8.4
当前其他平台的安装也可以 Gradle参考官网。
验证是否安装成功：gradl -v
三 牛刀小试 🫘
Gradle 已经安装完毕，接下来我们先简单写一个 Gradle 脚本并执行。
新建一个目录文件 gradleTest,在目录下创建一个文件名为：build.gradle,
➜ ~ mkdir gradleTest
➜ ~ cd gradleTest
➜ ~ touch build.gradle
在build.gradle中输入以下内容
task hello{doLast{println "hello world"
}
}
运行Gradle脚本，gradle 任务名，例如：gradle hello
可以看到结果被打印出来，接下来我们来详细分析下：
- 首先当在命令行输入
gradle hello时，会默认加载当前目录下名为build.gradle的构建脚本文件，然后执行脚本文件中名为 hello 的Task（任务）。在上述脚本中，我们给 hello 这个Task定义了一个 action（也就是动作），doLast 也可以理解为Task执行完毕后要回调对应的信息。如果你想加载指定的文件，则可以写为 gradle hello 01 -b hello01.gradle println相当于java中的system.out.println，因为 gradle 是基于 Groovy 实现的，而 Groovy 是由Java实现的，这就不难理解了。还有一点需要说明，在Java中单引号表示字符，双引号表示字符串，而在这里都是表示字符串。- 执行命令
gradle hello时，会打印出一些详细日志信息，如果不希望展示详细信息则可写为gradle -q hello，-q （quiet静默）选项表示以简化的输出模式，只显示任务的执行结果。
四 gradle wrapper 🤝
wrapper是包装纸的意思，在这里的含义是 对Gradle 进行包装，目的是便于在团队开发过程中统一 Gradle 构建的版本，避免因为 gradle 版本不一致导致的问题。
如何生成wrapper???
Gradle提供了内置的Wrapper task，可以帮助我们自动生成wrapper 所需的目录文件。在命令行输入 gradle wrapper
ls下会看到当前目录下生成了一些新的文件，目录结构如下:
gradle--wrapper--gradle-wrapper.jar--gradle-wrapper.properties
gradlew
gradlew.bat
其中，
gradlew 是Linux和Mac下的可执行脚本；gradle.bat 是windows下的可执行脚本。gradle-wrapper.jar是具体业务逻辑实现的jar包，gradlew 最终还是使用java执行的这个jar包来执行相关 Gradle 操作。
gradle-wrapper.properties 是配置文件，用于配置使用的哪个版本的 Gradle 等信息。具体内容如下：
gradle wrapper 配置文件中相关字段说明（内容来源于《Android Gradle 权威指南》）
| distributionBase | 下载的Gradle 压缩包解压后存储的主目录 |
|---|---|
| distributionPath | 相对于distributionBase的解压后的Gradle 压缩包的路径 |
| distributionUrl | Gradle 发行版压缩包的下载地址 |
| zipStoreBase | 和distributionBase类似，存放的是zip压缩包 |
| zipStorePath | 和distributionPath类似，存放的是zip压缩包 |
distributionUrl=https://services.gradle.org/distributions/gradle-8.4-bin.zip，因为我本地安装的 gradle 版本是8.4，所以使用的 wrapper 的gradle也是8.4版本，如果想生成指定的 wrapper 的 gradle 版本，可以使用下面的两个方法
方法一：在执行gradle wrapper命令时指定版本
例如：gradle wrapper —gradle-version 8.3
当命令执行完毕后，会看到生成的gradle-wrapper.properties中的distributionUrl为https://services.gradle.org/distributions/gradle-8.3-bin.zip
方法二：通过自定义Wrapper Task，指定版本
task wrapper01(type:Wrapper){gradleVersion = '2.4'
}
执行脚本：gradle wrapper01,结果如下
值得注意的是：脚本中task wrapper01(type:Wrapper) 需要指定task的类型，如果没有指定的话则会出现以下问题
另外，避免在 Gradle 构建脚本中使用 ‘wrapper’ 作为自定义任务的名称，因为该名称已被默认任务占用。选择其他唯一的任务名称来避免冲突。
gradlew的用法和gradle一样，gradle怎么用，gradlew也就怎么用，例如 gradlew hello，具体的使用说明我们会在后续的文章中分享。
五 Gradle 日志级别及日志信息调试 🔥
5.1 Gradle 日志级别
在Gradle中 日志将被分为六个级别，分别如下：
| ERROR | 错误消息 | |
|---|---|---|
| QUIET | 重要消息 | -q 参数 |
| WARNING | 警告消息 | |
| LIFECYCLE | 进度消息 | |
| INFO | 信息消息 | -i 参数 |
| DEBUG | 调试消息 | -d 参数 |
具体使用如下：
5.2 日志信息调试
在之前的脚本中，我们使用println来输出一些日志，当然还有另一种方式，可以使用内置的logger来控制不同级别的日志，例如：
logger.quiet('quiet信息')
logger.error('error信息')
例如build.gradle 内容如下
当执行 gradle hello时，会看到相关的日志输出。
六 Gradle 如何输出堆栈信息 📖
Gradle除了上面提供的日志信息外，还提供了堆栈信息的打印，默认情况下，堆栈信息的输出是关闭的，但可以通过命令将堆栈信息打开，例如，gradle -s hello1 -b build01.gradle，使用-s选项，表示输出关键性的堆栈信息。(-b参数表示指定执行脚本文件)
因为在此处故意将gradle脚本文件内容写错，所以在执行时，会出现对应的堆栈信息。
七 小结 ❤️
在本篇文章中，我们了解到 Gradle 的基本概念以及如何生成 gradlew，这块分享了两个方法，还分享了 gradle的日志级别、日志调试信息、以及如何输出堆栈信息帮助排查日常Bug。另外 gradlew 的用法与 gradle 的用法完全一致，在后续的文章会分享。如何你想了解更多内容，赶快关注小曾吧，当然也可以关注下方，小编会源源不断的输出精彩内容。
