最新版gradle安装使用简介

简介

gradle的最新版本是6.7,从2009年的第一个版本,到2020年的6.7,已经发展了11年了。gradle是作为android的官方构建工具引入的,除了java,它还能够支持多种语言的构建,所以用途非常广泛。

image

gradle是开源的构建工具,你可以使用groovy或者kotlin来编写gradle的脚本,所以说gradle是一个非常强大的,高度定制化的和非常快速的构建工具。

根据我的了解,虽然gradle非常强大,但是对于java程序员来说,一般还是都使用的maven,或者同时提供maven和gradle两种构建方式。

为什么会这样呢?个人觉得有两个原因:

第一个原因是gradle安装文件和依赖包的网络环境,如果单单依靠国内的网络环境的话,非常难安装完成。

第二个原因就是gradle中需要自己编写构建脚本,相对于纯配置的脚本来说,比较复杂。

安装gradle和解决gradle安装的问题

gradle需要java8的支持,所以,你首先需要安装好JDK8或者以上的版本。

❯ java -version
java version "1.8.0_151"
Java(TM) SE Runtime Environment (build 1.8.0_151-b12)
Java HotSpot(TM) 64-Bit Server VM (build 25.151-b12, mixed mode)

安装gradle有两种方式,一种就是最简单的从官网上面下载安装包。然后解压在某个目录,最后将PATH指向该目录下的bin即可:

❯ mkdir /opt/gradle
❯ unzip -d /opt/gradle gradle-6.7-bin.zip
❯ ls /opt/gradle/gradle-6.7
LICENSE  NOTICE  bin  README  init.d  lib  media

export PATH=$PATH:/opt/gradle/gradle-6.7/bin

如果你想使用包管理器,比如MAC上面的brew来进行管理的话,则可以这样安装:

brew install gradle

但是这样安装很有可能在下载gradle安装包的时候卡住。

==> Downloading https://services.gradle.org/distributions/gradle-6.4.1-bin.zip
##O#- #

怎么办呢?

这时候我们需要自行下载gradle-6.4.1-bin.zip安装包,然后将其放入http服务器中,让这个压缩包可以通过http协议来访问。

简单点的做法就是将这个zip文件拷贝到IDEA中,利用IDEA本地服务器的预览功能,获得zip的http路径,比如:http://localhost:63345/gradle/gradle-6.7-all.zip.

接下来就是最精彩的部分了,我们需要修改gradle.rb文件:

brew edit gradle

使用上面的命令可以修改gracle.rb文件,我们替换掉下面的一段:

  homepage "https://www.gradle.org/"
  url "https://services.gradle.org/distributions/gradle-6.7-all.zip"
  sha256 "0080de8491f0918e4f529a6db6820fa0b9e818ee2386117f4394f95feb1d5583"

url替换成为http://localhost:63345/gradle/gradle-6.7-all.zip,而sha256可以使用 sha256sum gradle-6.7-all.zip这个命令来获取。

替换之后,重新执行brew install gradle即可安装完成。

安装完毕之后,我们使用gradle -v命令可以验证是否安装成功:

gradle -v

Welcome to Gradle 6.7!

Gradle特性

gradle作为一种新的构建工具,因为它是依赖于groovy和kotlin脚本的,基于脚本的灵活性,我们通过自定义脚本基本上可以做任何想要的构建工作。

虽然说gradle可以做任何构建工作,但是gradle现在还是有一定的限制,那就是项目的依赖项目前只支持于maven和Ivy兼容的存储库以及文件系统。

gradle通过各种预定义的插件,可以轻松的构建通用类型的项目,并且支持自定义的插件类型。

另外一个非常重要的特性是gradle是以任务为基础的,每一个build都包含了一系列的task,这些task又有各自的依赖关系,然后这些task一起构成了一个有向无环图Directed Acyclic Graphs (DAGs)。

有了这个DAG,gradle就可以决定各个task的顺序,并执行他们。

我们看两个task DAG的例子,一个是通用的task,一个是专门的编译java的例子:

image

task可以依赖task,我们看个例子:

task hello {
    doLast {
        println 'Hello world!'
    }
}
task intro {
    dependsOn hello
    doLast {
        println "I'm Gradle"
    }
}

一个task可以包含Actions,inputs和Outputs。根据需要这些类型可以自由组合。

标准task

Gradle包含了下面7种标准的task:

  • clean :用来删除build目录和里面的一切。

  • check:这是一个生命周期任务,通常做一些验证工作,比如执行测试任务等。

  • assemble :这是一个生命周期任务,用来生成可分发的文件,比如jar包。

  • build: 也是一个生命周期任务,用来执行测试任务和生成最后的production文件。通常我们不在build中直接做任何特定的任务操作,它一般是其他任务的组合。

  • buildConfiguration: 组装configuration中指定的archives。

  • uploadConfiguration: 除了执行buildConfiguration之外,还会执行上传工作。

  • cleanTask: 删除特定的某个task的执行结果。

Build phases

一个gradle的build包含了三个phases:

  • Initialization: 初始化阶段。gradle支持一个或者多个project的build。在初始化阶段,gradle将会判断到底有哪些project将会执行,并且为他们分别创建一个project实例。

  • Configuration: 配置阶段。gradle将会执行build脚本,然后分析出要运行的tasks。

  • Execution: 执行阶段。gradle将会执行configuration阶段分析出来的tasks。

Gradle Wrapper

上面讲的是gradle的手动安装,如果是在多人工作的环境中使用了gradle,有没有什么办法可以不用手动安装gradle就可以自动运行gradle程序呢?

方法当然有,那就是gradle wrapper:

image

gradle wrapper是一个工具,通过它我们可以方便的对本地的gradle进行管理。

上图列出了gradle wrapper的工作流程,第一步是去下载gradle的安装文件,第二步是将这个安装文件解压到gradle的用户空间,第三步就是使用这个解压出来的gradle了。

我们先看下怎么创建gradle wrapper:

虽然Gradle wrapper的作用是帮我们下载和安装gradle,但是要生成gradle wrapper需要使用gradle命令才行。也就是说有了wrapper你可以按照成功gradle,有了gradle你才可以生成gradle wrapper。

假如我们已经手动按照好了gradle,那么可以执行下面的命令来生成gradle wrapper:

$ gradle wrapper
> Task :wrapper

BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed

先看下生成出来的文件结构:

.
├── gradle
│   └── wrapper
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradlew
└── gradlew.bat

gradle/wrapper/gradle-wrapper.properties 是 wrapper的配置文件,我们看下里面的内容:

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-6.7-all.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

其中distributionUrl就是我们要下载的gradle的路径,其他的配置是gradle的安装目录。

一般来说有两种安装文件类型:bin和all。bin和all的区别在于,bin只有安装文件,而all还包含了gradle的文档和样例代码。

我们可以通过--distribution-type参数来修改安装文件的类型。此外还有 --gradle-version ,--gradle-distribution-url和--gradle-distribution-sha256-sum 这几个参数可以使用。

$ gradle wrapper --gradle-version 6.7 --distribution-type all
> Task :wrapper

BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed

除了配置文件之外,我们还有3个文件:

  • gradle-wrapper.jar: wrapper业务逻辑的实现文件。

  • gradlew, gradlew.bat :使用wrapper执行build的执行文件。也就是说我们可以使用wrapper来执行gradle的build任务。

wrapper的使用

我们可以这样使用gradlew,来执行build:

gradlew.bat build

注意,如果你是第一次在项目中执行build命令的话,将会自动为你下载和安装gradle。

wrapper的升级

如果我们想要升级gradle的版本,也很简单:

./gradlew wrapper --gradle-version 6.7

或者直接修改 gradle-wrapper.properties 也可以。

一个简单的build.gradle

我们看一个非常简单的gradle的例子:

plugins {
    id 'application' 
}

repositories {
    jcenter() 
}

dependencies {
    testImplementation 'junit:junit:4.13' 

    implementation 'com.google.guava:guava:29.0-jre' 
}

application {
    mainClass = 'demo.App' 
}

上面我们需要安装一个application plugin,使用的是jcenter的依赖仓库,还指定了几个具体的依赖项。最后,指明了我们应用程序的mainClass。

gradle使用maven仓库

build.gradle中的repositories指明的是使用的仓库选项。

默认情况下gradle有自己的本地仓库,一般在~/.gradle目录下面,如果我们之前用的是maven仓库,那么在本地的maven仓库中已经存在了很多依赖包了,如何重用呢?

我们可以这样修改repositories:

    mavenLocal()
    mavenCentral()

这样的话, 就会优先从maven的仓库中查找所需的jar包。

总结

本文只是一个很简单的gradle介绍,让大家对gradle有一个基本的了解,后面我们会详细的介绍gradle的各种用法,敬请期待。

本文已收录于 http://www.flydean.com/gradle-kick-off/

最通俗的解读,最深刻的干货,最简洁的教程,众多你不知道的小技巧等你来发现!

欢迎关注我的公众号:「程序那些事」,懂技术,更懂你!

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,014评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,796评论 3 386
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,484评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,830评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,946评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,114评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,182评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,927评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,369评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,678评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,832评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,533评论 4 335
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,166评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,885评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,128评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,659评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,738评论 2 351

推荐阅读更多精彩内容