【Android Gradle】之Gradle入门及 wrapper 生成(一)

作者简介: 小曾同学.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
【Android Gradle】之Gradle入门及 wrapper 生成(一)_第1张图片

三 牛刀小试

Gradle 已经安装完毕,接下来我们先简单写一个 Gradle 脚本并执行。
新建一个目录文件 gradleTest,在目录下创建一个文件名为:build.gradle,

➜  ~ mkdir gradleTest
➜  ~ cd gradleTest
➜  ~ touch build.gradle

在build.gradle中输入以下内容

task hello{
	doLast{
		println "hello world"
}
}

运行Gradle脚本,gradle 任务名,例如:gradle hello
【Android Gradle】之Gradle入门及 wrapper 生成(一)_第2张图片
可以看到结果被打印出来,接下来我们来详细分析下:

  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
【Android Gradle】之Gradle入门及 wrapper 生成(一)_第3张图片
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 等信息。具体内容如下:
【Android Gradle】之Gradle入门及 wrapper 生成(一)_第4张图片
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,结果如下

【Android Gradle】之Gradle入门及 wrapper 生成(一)_第5张图片

值得注意的是:脚本中task wrapper01(type:Wrapper) 需要指定task的类型,如果没有指定的话则会出现以下问题

【Android Gradle】之Gradle入门及 wrapper 生成(一)_第6张图片
另外,避免在 Gradle 构建脚本中使用 ‘wrapper’ 作为自定义任务的名称,因为该名称已被默认任务占用。选择其他唯一的任务名称来避免冲突。
gradlew的用法和gradle一样,gradle怎么用,gradlew也就怎么用,例如 gradlew hello,具体的使用说明我们会在后续的文章中分享。

五 Gradle 日志级别及日志信息调试

5.1 Gradle 日志级别

在Gradle中 日志将被分为六个级别,分别如下:

ERROR 错误消息
QUIET 重要消息 -q 参数
WARNING 警告消息
LIFECYCLE 进度消息
INFO 信息消息 -i 参数
DEBUG 调试消息 -d 参数

具体使用如下:
【Android Gradle】之Gradle入门及 wrapper 生成(一)_第7张图片

5.2 日志信息调试

在之前的脚本中,我们使用println来输出一些日志,当然还有另一种方式,可以使用内置的logger来控制不同级别的日志,例如:

logger.quiet('quiet信息')
logger.error('error信息')

例如build.gradle 内容如下
【Android Gradle】之Gradle入门及 wrapper 生成(一)_第8张图片
当执行 gradle hello时,会看到相关的日志输出。
【Android Gradle】之Gradle入门及 wrapper 生成(一)_第9张图片

六 Gradle 如何输出堆栈信息

Gradle除了上面提供的日志信息外,还提供了堆栈信息的打印,默认情况下,堆栈信息的输出是关闭的,但可以通过命令将堆栈信息打开,例如,gradle -s hello1 -b build01.gradle,使用-s选项,表示输出关键性的堆栈信息。(-b参数表示指定执行脚本文件)
因为在此处故意将gradle脚本文件内容写错,所以在执行时,会出现对应的堆栈信息。
【Android Gradle】之Gradle入门及 wrapper 生成(一)_第10张图片

七 小结 ❤️

在本篇文章中,我们了解到 Gradle 的基本概念以及如何生成 gradlew,这块分享了两个方法,还分享了 gradle的日志级别、日志调试信息、以及如何输出堆栈信息帮助排查日常Bug。另外 gradlew 的用法与 gradle 的用法完全一致,在后续的文章会分享。如何你想了解更多内容,赶快关注小曾吧,当然也可以关注下方,小编会源源不断的输出精彩内容。

你可能感兴趣的:(Android开发,Android开发,Gradle命令,Wrapper,Gradle日志级别,Gradle堆栈信息)