【Android Gradle】之Gradle入门及 wrapper 生成（一）

作者简介： 小曾同学.com,一个致力于测试开发的博主⛽️，主要职责：测试开发、CI/CD
如果文章知识点有错误的地方，还请大家指正，让我们一起学习，一起进步。
座右铭：不想当开发的测试，不是一个好测试✌️。
如果感觉博主的文章还不错的话，还请点赞、收藏哦！

一 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

可以看到结果被打印出来，接下来我们来详细分析下：

1. 首先当在命令行输入 gradle hello 时，会默认加载当前目录下名为build.gradle的构建脚本文件，然后执行脚本文件中名为 hello 的Task（任务）。在上述脚本中，我们给 hello 这个Task定义了一个 action（也就是动作），doLast 也可以理解为Task执行完毕后要回调对应的信息。如果你想加载指定的文件，则可以写为 gradle hello 01 -b hello01.gradle
2. println 相当于java中的system.out.println，因为 gradle 是基于 Groovy 实现的，而 Groovy 是由Java实现的，这就不难理解了。还有一点需要说明，在Java中单引号表示字符，双引号表示字符串，而在这里都是表示字符串。
3. 执行命令 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 的用法完全一致，在后续的文章会分享。如何你想了解更多内容，赶快关注小曾吧，当然也可以关注下方，小编会源源不断的输出精彩内容。