背景
出于学习需要,最近开始接触IDEA和Gradle.由于接触Java时间也还很短,之前也只是用过VS里的NuGet。对于Gradle的理解也只局限于依赖管理和项目自动构建这两方面。Gradle的概念和安装这些我就不说了,百度谷歌上一大堆。下面就开始以例子的形式来体验一把Gradle的一些基本使用。
一.创建一个简单的Java应用
先看实例:
$ mkdir hello-world
$ cd hello-world
$ gradle init --type java-library
$ vim build.gradle # 添加 apply plugin: 'idea' 后保存退出
$ ./gradlew idea
$ ./gradlew build
$ open hello-world.ipr # 可以直接用IntelliJ打开该文件
上面是在Linux下的命令,Windows下只需要将用notepad++替换vim,最后直接用IDEA打开hello-world.ipr即可。
gradle init --type java-library --- 表示生成默认的目录结构以及示例代码。
apply plugin: 'idea' --- 表示应用idea插件,用于生成idea的项目。
apply plugin: 'java' --- 默认应用java插件,提供了一系列管理和构建Java项目的任务。
用idea打开此生成的目录,会发现没有src/main/resources和src/test/resources这两个目录,可以自己新建文件夹然后在文件夹上右键:
我这里是已经Mark过了,所以显示的是Unmark as Resources Root.
另外,在项目下的build.gradle是gradle的配置文件。
二.Gradle项目的标准结构
Gradle遵循COC(convention over configuration约定优于配置)的理念,默认情况下提供了与Maven相同的项目结构配置,大体结构如下:
- project root
- src/main/java(项目源码目录)
- src/main/resources(项目资源目录)
- src/test/java(测试源码目录)
- src/test/resources(测试资源目录)
- src/main/webapp(web工程目录)
当然也可以自定义目录结构。方法如下(其他具体写法请自行百度~):
sourceSets {
main {
java {
srcDir 'src/java'
}
resources {
srcDir 'src/resources'
}
}
}
当然最好还是遵循标准的目录结构,这样更方便统一。看起来也一目了然。
三.使用Gradle
将项目导入idea后,关联上Gradle后在视图菜单中打开Gradle,可以看到所有可以执行的任务:
可以直接在这里执行某个task,也可以在下面的命令行中手动键入命令执行。
可以键入gradle tasks来列出项目的所有任务. 通过这个命令来看 Java 插件在你的项目里加入了哪些命令、和每个命令的作用。
四.最简单的Gradle配置文件
前面第一步我们已经创建了一个简单的Java项目,下面就以里面的配置文件为例:
// Apply the java plugin to add support for Java
apply plugin: 'java'
apply plugin: 'idea'
// In this section you declare where to find the dependencies of your project
repositories {
// Use 'jcenter' for resolving your dependencies.
// You can declare any Maven/Ivy/file repository here.
jcenter()
//mavenCentral() //使用maven仓库
}
// In this section you declare the dependencies for your production and test code
dependencies {
// The production code uses the SLF4J logging API at compile time
compile 'org.slf4j:slf4j-api:1.7.21'
// Declare the dependency for your favourite test framework you want to use in your tests.
// TestNG is also supported by the Gradle Test task. Just change the
// testCompile dependency to testCompile 'org.testng:testng:6.8.1' and add
// 'test.useTestNG()' to your build script.
testCompile 'junit:junit:4.12'
}
这个配置文件很简单,基本上都能看懂。这里只说一下依赖项的加入。
仓库的坐标
仓库中构件(jar包)的坐标是由groupId、artifactId、version组成的字符串构成的,在仓库中通过以GAV组成的坐标来定位所需的jar包.在gradle中可以通过以下方式来声明依赖:
testCompile group: 'junit', name: 'junit', version: '4.12'
这里的testCompile 表示一个任务。更多关于任务的请看: 任务
当然如果你觉得这种方式太过繁琐,可以省略group、name、version三个单词,把构件的坐标采用以:分割的方式简写为如下方式:
testCompile 'junit:junit:4.12'
也可以这样写:
testCompile group: 'junit', name: 'junit', version: '4.+',表示使用4.X的最新版本
当然更细粒度的classifier这里也是支持的,需要你需要可以按如下方式书写:
compile group: 'org.gradle.test.classifiers', name: 'service', version: '1.0', classifier: 'jdk14'
或者简写为
compile "org.gradle.test.classifiers:service:1.0:jdk14@jar"