使用Gradle构建项目

使用Gradle构建项目
http://blog.javachen.com/2014/09/15/build-project-with-gradle.html

Gradle 是一款基于 Groovy 语言、免费开源的构建工具,它既保持了 Maven 的优点,又通过使用 Groovy 定义的 DSL 克服了 Maven 中使用 XML 繁冗以及不灵活的缺点。

Gradle 官方网站:http://www.gradle.org/downloads

安装

一种方式是从 官方 下载解压然后配置环境变量。

Mac 上安装:

$ brew install gradle

测试是否安装成功:

$ gradle -v

------------------------------------------------------------
Gradle 2.12
------------------------------------------------------------

Build time:   2016-03-14 08:32:03 UTC
Build number: none
Revision:     b29fbb64ad6b068cb3f05f7e40dc670472129bc0

Groovy:       2.4.4
Ant:          Apache Ant(TM) version 1.9.3 compiled on December 23 2013
JVM:          1.7.0_80 (Oracle Corporation 24.80-b11)
OS:           Mac OS X 10.11.6 x86_64

简单使用

Gradle 使用 约定优于配置(Convention over Configuration)的理念。使用与maven兼容的目录结构布局。完全按照约定的目录结构来布置工程文件,会大大简化编译配置文件。

除了常见的src/main/java等目录,默认的 web 应用程序根目录为 src/main/webapp,也就是包含 WEB-INF 目录的上一级目录。如果工程没有完全依照约定布局,可以通过脚本文件指定相应的路径。

Gradle 中有两个最基本的对象:project 和 task。每个 Gradle 的构建由一个 project 对象来表达,它代表着需要被构建的组件或者构建的整个项目。每个 project 对象由一个或者多个 task 对象组成。

Gradle 已经自带了很多 pugins,可以满足大部分的常见构建任务。

Gradle 的默认构建脚本文件为工程根目录下的 build.gradle。

创建项目

作为测试,创建一个 test 目录,然后通过下面命令来初始化一个项目:

$ mkdir test
$ cd test
$ gradle init
:wrapper
:init

BUILD SUCCESSFUL

Total time: 3.058 secs

$ ls
build.gradle    gradle          gradlew         gradlew.bat     settings.gradle

可以看到生成了 gradle 的一些配置文件。接下来在 build.gradle 文件中添加下面代码,可以支持生成 jar 包:

apply plugin: 'java'

这就是你定义一个Java项目所需要做的一切。这就会在你项目里使用Java插件,该插件会给你的项目增加很多任务。

Gradle 期望在 src/main/java 路径下找到你项目的源代码,并且测试在 src/test/java 路径下的代码。同时,在src/main/resources 路径下的文件也会作为资源文件包含在JAR包中,并且 src/test/resources 下的所有文件会包含在 classpath 下以运行测试程序。所有的输出文件都生成在 build 目录下,JAR 包生成在 build/libs 目录下。

运行下面命令即可生成 jar 包:

$ gradle jar

如果 jar 包中有一个包含 main 方法的主类,想让其打包之后能够运行其 main 方法,则需要添加下面代码:

apply plugin: 'java'

jar {
    manifest {
        attributes 'Main-Class': 'com.javachen.gradle.HelloWorld'
    }
}

通常,JAR 包需要被发布到某个地方。为了完成这个功能,你需要告诉 Gradle 把 JAR 包发布到哪里。在 Gradle 中,如 JAR 之类的压缩包都被发布到库中。在我们的样例中,我们将会发布到本地仓库。你也可以发布到一个或多个远端地址。

发布 jar 包添加如下配置:

uploadArchives {
    repositories {
       flatDir {
           dirs 'repos'
    } }
}

此外,你还可以添加下面代码,引入 Eclipse 插件以支持生成 Eclipse 工程:

apply plugin: 'eclipse'

添加Maven库:

repositories {
    mavenCentral()
}

如果想添加依赖,也是非常简单,例如添加 spring 依赖:

apply plugin: 'java'
dependencies {
    compile 'org.springframework:spring-context:3.2.6.RELEASE'
    testCompile group: 'junit', name: 'junit', version: '4.+'
}

gradle 便会自动地到 maven 服务器下载 spring-context-3.2.6.RELEASE.jar,以及它所依赖的 jar 包。

常用的依赖:

  • (1)compile:编译生产代码的依赖环境,即src/main/下
  • (2)runtime:生产代码运行时的依赖(包含编译生产代码时的依赖)
  • (3)testCompile:编译测试代码的依赖环境,即src/test下
  • (4)testRuntime:测试代码运行时的依赖(包含编译测试代码时的依赖)

当然,也可以直接依赖本地的 jar 包,例如:

apply plugin: 'java'
dependencies {
    compile fileTree(dir: 'libs', include: '*.jar')
}

也可以通过 buildscript{} 中添加依赖的方式,将相关 jar 包加入到 classpath 中,如:

buildscript {  
    repositories {  
        mavenCentral()  
    }  
    dependencies {  
        classpath group: 'commons-codec', name: 'commons-codec', version: '1.2'  
    }  
}

综上,完成的配置如下:

apply plugin: 'java'
apply plugin: 'eclipse'

jar {
    manifest {
        attributes 'Main-Class': 'com.javachen.gradle.HelloWorld'
    }
}

repositories {
    mavenLocal()
    mavenCentral()
    mavenRepo urls: "http://repository.sonatype.org/content/groups/forge/"
}

dependencies {
    compile 'org.springframework:spring-context:3.2.6.RELEASE'
    testCompile group: 'junit', name: 'junit', version: '4.+'
    compile fileTree(dir: 'libs', include: '*.jar')
}

buildscript {  
    repositories {  
        mavenLocal()
        mavenCentral()
        mavenRepo urls: "http://repository.sonatype.org/content/groups/forge/"
    }  
    dependencies {  
        classpath group: 'commons-codec', name: 'commons-codec', version: '1.2'  
    }  
}  

uploadArchives {
    repositories {
        flatDir {
            dirs 'repos'
        }
    }
}

其他使用

创建项目目录结构

gradle 不像 maven 那样有固定的项目结构,gradle 原声 API 是不支持的,要想做到这一点,我们可以自定义一个 task。

apply plugin: 'idea'
apply plugin: 'java'
apply plugin: 'war'

task createJavaProject << {
  sourceSets*.java.srcDirs*.each { it.mkdirs() }
  sourceSets*.resources.srcDirs*.each { it.mkdirs()}
}

task createWebProject(dependsOn: 'createJavaProject') << {
  def webAppDir = file("$webAppDirName")
  webAppDir.mkdirs()
}

然后运行下面命令:

$ gradle createJavaProject

另外,还可以使用 gradle templates 创建项目目录结构,这里不做研究。

更加标准的方法是使用 gradle 自带的插件创建项目目录结构,例如创建 java 项目结构:

$ gradle init --type java-library

这时候的目录结果如下:

$ tree -L 4
.
├── build.gradle
├── gradle
│   └── wrapper
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
├── settings.gradle
└── src
    ├── main
    │   └── java
    │       └── Library.java
    └── test
        └── java
            └── LibraryTest.java

7 directories, 8 files

如果想要导入到 idea 中,先执行下面命令:

$ gradle idea

这时候的 build.gradle 如下:

apply plugin: 'idea'
apply plugin: 'java'
apply plugin: 'war'

task createJavaProject << {
      sourceSets*.java.srcDirs*.each { it.mkdirs() }
        sourceSets*.resources.srcDirs*.each { it.mkdirs()}
}

task createWebProject(dependsOn: 'createJavaProject') << {
      def webAppDir = file("$webAppDirName")
        webAppDir.mkdirs()
}

将Java项目从maven迁移到gradle

如何将一个 java 项目从maven迁移到 gradle 呢?gradle 集成了一个很方便的插件:Build Init Plugin,使用这个插件可以很方便地创建一个新的 gradle 项目,或者将其它类型的项目转换为 gradle 项目。

要将 maven 项目转换为 gradle 项目,只需要在项目的 pom 文件所在的目录下执行以下命令:

$ gradle init --type pom

上面的命令会根据 pom 文件自动生成 gradle 项目所需的文件和配置,然后以 gradle 项目重新导入即可。

参考

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

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,651评论 18 139
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,803评论 6 342
  • 什么是Gradle? Gradle是一种依赖管理工具,基于Groovy语言,面向Java应用为主,它抛弃了基于XM...
    MrMagicWang阅读 375评论 0 1
  • 1.介绍 如果你正在查阅build.gradle文件的所有可选项,请点击这里进行查阅:DSL参考 1.1新构建系统...
    Chuckiefan阅读 12,131评论 8 72
  • 一份温馨的情愫 六月十日,天气放晴,我们一行七人参加朱志东老师女儿回门宴热闹而温馨。 有幸和王溢作协的各位老师认...
    小河映月阅读 332评论 2 2