从零开始,跟我一起做jblog项目(三)从Maven到Gradle
从零开始,跟我一起做jblog项目(三)从Maven到Gradle
上一节讲到项目构建工具Maven,对JAR包的管理不可谓不强大
博主在使用maven引入Spring框架时,了解到Spring推荐使用gradle工具来构建项目
百度了一下,发现Gradle也是一套很优秀的项目构建工具
Gradle使用Groovy语言配置项目和依赖,在极大地提升灵活性和配置性之外,甚至配置代码要比XML结构的POM文件少很多
鉴于我希望将jblog打造成一款modern的小型个人博客系统
而gradle的首页上介绍自己为Modern Open-Source Enterprise Build Automation
所以我决定将项目原型从maven构建转移为gradle构建
目前关于Gradle的教程还比较零散,下面我会一步一步演示如何将Gradle集成到myeclipse中去
首先,到Gradle官网下载最新版的gradle
下载地址是http://gradle.org/gradle-download/
博主下载的是2.8版本,写这篇文章的时候已经更新到2.9了
下载下来解压到任意目录
然后配置Windows环境变量,一共要配置三个,分别如下:
GRADLE_HOME:你的gradle解压路径,例如:D:\Workspaces\gradle-2.8
GRADLE_USER_HOME:你希望作为本地仓库的路径,自己建一个名为.gradle的路径,例如:D:\Workspaces\.gradle
path:这个不用说,系统路径,可以在cmd中直接敲gradle命令的,在path最后添加:%GRADLE_HOME%\bin;
这三个配置好了,我们初步验证一下,打开cmd,任意路径下敲入gradle -v命令,出现下面的响应就算安装成功了
关于gradle的详细命令和用法,大家可以参考下面的教程
http://wiki.jikexueyuan.com/project/gradle/
建议快速阅读上面的教程后,我们来将gradle植入eclipse/myeclipse中
打开eclipse,进入marketplaces,搜索gradle,找到Gradle IDE Pack,经过博主测试这个插件是最好用的
安装好Gradle IDE Pack插件后,重启eclipse,新建一个最简单的JAVA Project,或者试试Web Projec也可以
在项目根目录下新建一个build.gradle文件,如图所示
编辑build.gradle配置文件,示例如下:
apply plugin: "java" apply plugin: "eclipse" sourceCompatibility = 1.8 version = '1.0' configurations { provided } sourceSets { main.compileClasspath += configurations.provided test.compileClasspath += configurations.provided test.runtimeClasspath += configurations.provided } repositories { mavenLocal() maven {url "http://maven.oschina.net/content/groups/public/"} mavenCentral() } dependencies { compile "org.hibernate:hibernate-core:5.+" testCompile "junit:junit:4.7" provided "javax.servlet:javax.servlet-api:4.+" } //注意下面这个配置,新版本gradle如果不使用数组添加的话会导致eclipse频繁报错 eclipse.classpath.plusConfigurations += [configurations.provided]
保存build.gradle文件后,右键project,选择configure,选择convert to gradle project,为项目添加gradle特性
添加完gradle特性后,我们来让eclipse将build.gradle中定义的几个依赖包加入到项目中来
在这之前还需要配置一下Gradle IDE Pack插件,eclipse的window->preferencecs->Gradle,配置我们本地的gradle路径
配置好了以后就万事具备了,我们来试验一下,如何将build.gradle文件中定义的依赖引入eclipse环境中
右击project项目,选择gradle,选择Enable Dependency Management,让插件来打开依赖管理
打开之后,仍然右键项目,gradle->Refresh Dependencies,刷新一下依赖列表
在后台,gradle将按照上述文件的定义,依次检索我们系统中的maven本地仓库,chinaos提供的中国镜像仓库,以及maven中央仓库
将所需要的包下载到配置的gradle本地仓库中,再引入到eclipse的classpath中,效果如下图所示:
至此,关于gradle集成到eclipse的所有工作就结束了,项目编写过程中,如果要继续引入JAR包,就在build.gradle文件中添加
然后刷新一下gradle的依赖,就能实时添加到eclipse的环境中去了
最后着重讲解一下provided的scope(有效依赖范围),上一篇讲到maven,其中配置依赖的scope常用的有下面几种
compile:编译,测试,打包时都需要依赖,比如spring、hibernate、struts等
test:测试时需要依赖,常见的有junit
provided:一般由容器提供,只有写代码时需要依赖,比如servlet
runtime:打包运行时需要依赖
转移到gradle以后,gradle默认只为我们提供了四种scope,如下:
compile:编译范围依赖在所有的 classpath 中可用,同时它们也会被打包
runtime:依赖在运行和测试系统的时候需要,但在编译的时候不需要。比如,你可能在编译的时候只需要 JDBC API JAR,而只有在运行的时候才需要 JDBC 驱动实现
testCompile:测试期编译需要的附加依赖
testRuntime:测试运行期需要
可以看到gradle默认并未提供类似provided的scope,那比如我们需要写web project,则需要引入servlet包,而这时就比较麻烦
我们可以向eclipse的build path手工添加tomcat下的servlet包,但那样未免显得太low了,毕竟我们已经选择使用项目构建工具来管理我们的JAR包了
别着急,gradle毕竟是使用一种编程语言来配置项目构建的,所以它的灵活性相当高,在上述的配置文件中,我们人为定义了一个provided的scope
并且将这个provided使用sourceSet集合定义了范围,明确了在main目录的compile期间需要依赖,在test目录的编译期间和运行期间需要依赖
言下之意就是在main目录的运行期间不需要依赖喽,也就是运行时不需要将此provided范围的依赖打包
最后配合eclipse插件,向eclipse的classpath中添加了这一provided范围,结果eclipse会将servlet引入到项目依赖中。