本指南将引导您使用Gradle构建一个简单的Java项目。
你会建立什么
您将创建一个简单的应用程序,然后使用Gradle进行构建。
你需要什么
-
约15分钟
-
最喜欢的文本编辑器或IDE
-
JDK 6或更高版本
如何完成本指南
设置项目
首先,为Gradle建立一个Java项目。为了继续关注Gradle,现在使该项目尽可能简单。
创建目录结构
在您选择的项目目录中,创建以下子目录结构;例如, mkdir -p src/main/java/hello
在* nix系统上:
└── src └── main └── java └── hello
内src/main/java/hello
目录中,您可以创建所需的任何Java类。为了简单起见并与本指南的其余部分保持一致,Spring建议您创建两个类: HelloWorld.java
和Greeter.java
。
src/main/java/hello/HelloWorld.java
package hello;
public class HelloWorld {
public static void main(String[] args) {
Greeter greeter = new Greeter();
System.out.println(greeter.sayHello());
}
}
src/main/java/hello/Greeter.java
package hello;
public class Greeter {
public String sayHello() {
return "Hello world!";
}
}
安装Gradle
现在您有了可以使用Gradle生成的项目,您可以安装Gradle。
强烈建议使用安装程序:
万不得已,如果这些工具都不适合您的需求,则可以从https://www.gradle.org/downloads下载二进制文件。只需要二进制文件,因此请查找gradle- version -bin.zip的链接。(您也可以选择gradle- version -all.zip来获取源代码,文档以及二进制文件。)
将文件解压缩到您的计算机,然后将bin文件夹添加到您的路径。
要测试Gradle的安装,请从命令行运行Gradle:
gradle
如果一切顺利,您会看到一条欢迎消息:
:help Welcome to Gradle 2.3. To run a build, run gradle <task> ... To see a list of available tasks, run gradle tasks To see a list of command-line options, run gradle --help BUILD SUCCESSFUL Total time: 2.675 secs
您现在已经安装了Gradle。
找出Gradle可以做什么
现在已经安装了Gradle,看看它能做什么。在为项目创建build.gradle文件之前,您可以询问它可用的任务:
gradle tasks
您应该看到可用任务的列表。假设您在尚未具有build.gradle文件的文件夹中运行Gradle,您将看到一些非常基本的任务,例如:
:tasks == All tasks runnable from root project == Build Setup tasks setupBuild - Initializes a new Gradle build. [incubating] == Help tasks dependencies - Displays all dependencies declared in root project 'gs-gradle'. dependencyInsight - Displays the insight into a specific dependency in root project 'gs-gradle'. help - Displays a help message projects - Displays the sub-projects of root project 'gs-gradle'. properties - Displays the properties of root project 'gs-gradle'. tasks - Displays the tasks runnable from root project 'gs-gradle'. To see all tasks and more detail, run with --all. BUILD SUCCESSFUL Total time: 3.077 secs
即使这些任务可用,但如果没有项目构建配置,它们也不会提供太多价值。当你充实build.gradle
文件,一些任务会更有用。当您向其中添加插件时,任务列表将增加build.gradle
,因此您偶尔会想再次运行任务以查看可用的任务。
说到添加插件,接下来添加一个启用基本Java构建功能的插件。
建立Java程式码
从简单开始,创建一个非常基础的build.gradle
文件在
apply plugin: 'java'
构建配置中的这一行带来了巨大的力量。再次运行gradle任务 ,您会看到新任务已添加到列表中,包括用于构建项目,创建JavaDoc和运行测试的任务。
您将经常使用gradle构建任务。该任务将代码编译,测试并将其组装为一个JAR文件。您可以这样运行它:
gradle build
几秒钟后,“ BUILD SUCCESSFUL”指示构建已完成。
要查看构建工作的结果,请查看构建文件夹。在其中,您将找到几个目录,包括以下三个著名的文件夹:
-
类 。项目的已编译.class文件。
-
报告 。构建生成的报告(例如测试报告)。
-
库 。组装的项目库(通常是JAR和/或WAR文件)。
classes文件夹包含.class文件,这些文件是通过编译Java代码生成的。具体来说,您应该找到HelloWorld.class和Greeter.class。
此时,该项目没有任何库依赖项,因此dependency_cache文件夹中没有任何内容。
reports文件夹应包含项目上正在运行的单元测试的报告。由于该项目尚无任何单元测试,因此该报告将变得毫无意义。
libs文件夹应包含以项目文件夹命名的JAR文件。接下来,您将看到如何指定JAR的名称及其版本。
声明依赖
简单的Hello World示例是完全独立的,并且不依赖于任何其他库。但是,大多数应用程序都依赖于外部库来处理常见和/或复杂的功能。
例如,假设除了说“你好,世界!”,则您希望应用程序打印当前日期和时间。您可以使用本机Java库中的日期和时间工具,但可以使用Joda Time库使事情变得更有趣。
首先,将HelloWorld.java更改如下:
package hello;
import org.joda.time.LocalTime;
public class HelloWorld {
public static void main(String[] args) {
LocalTime currentTime = new LocalTime();
System.out.println("The current local time is: " + currentTime);
Greeter greeter = new Greeter();
System.out.println(greeter.sayHello());
}
}
这里HelloWorld
使用乔达时间LocalTime
类以获取并打印当前时间。
如果你跑了gradle build
要立即构建项目,构建将失败,因为您尚未在构建中将Joda Time声明为编译依赖项。
对于初学者,您需要添加第三方库的源。
repositories {
mavenCentral()
}
的repositories
块指示该构建应从Maven Central存储库中解决其依赖项。Gradle在很大程度上依赖于Maven构建工具建立的许多约定和功能,包括使用Maven Central作为库依赖源的选项。
现在我们已经准备好第三方库了,让我们声明一下。
sourceCompatibility = 1.8
targetCompatibility = 1.8
dependencies {
compile "joda-time:joda-time:2.2"
testCompile "junit:junit:4.12"
}
随着dependencies
块,您声明Joda Time的单个依赖项。具体来说,您要在joda-time组中要求(从右到左阅读)joda-time库的2.2版。
关于此依赖项要注意的另一件事是,它是一个compile
依赖关系,表示在编译时应该可用(如果正在构建WAR文件,则包含在WAR的/ WEB-INF / libs文件夹中)。其他值得注意的依赖类型包括:
-
providedCompile
。编译项目代码所需的依赖关系,但是将在运行时由运行代码的容器(例如Java Servlet API)提供。 -
testCompile
。用于编译和运行测试的依赖关系,但对于构建或运行项目的运行时代码不是必需的。
最后,让我们为我们的JAR工件指定名称。
jar {
baseName = 'gs-gradle'
version = '0.1.0'
}
的jar
块指定如何命名JAR文件。在这种情况下,它将呈现gs-gradle-0.1.0.jar
。
现在,如果您运行gradle build
,Gradle应该从Maven Central存储库中解决Joda Time依赖关系,并且构建将成功。
使用Gradle Wrapper构建项目
Gradle包装器是开始Gradle构建的首选方法。它由Windows的批处理脚本以及OS X和Linux的Shell脚本组成。这些脚本使您可以运行Gradle构建,而无需在系统上安装Gradle。这曾经是添加到您的构建文件中的东西,但已被折叠到Gradle中,因此不再需要。相反,您只需使用以下命令。
$ gradle wrapper --gradle-version 2.13
该任务完成后,您会注意到一些新文件。这两个脚本位于文件夹的根目录中,而包装jar和属性文件已添加到新文件夹中。 gradle/wrapper
夹。
└── <project folder> └── gradlew └── gradlew.bat └── gradle └── wrapper └── gradle-wrapper.jar └── gradle-wrapper.properties
Gradle包装器现在可用于构建您的项目。将其添加到您的版本控制系统中,每个克隆您的项目的人都可以相同地构建它。它可以与已安装的Gradle版本完全相同地使用。运行包装程序脚本以执行构建任务,就像之前一样:
./gradlew build
第一次为指定版本的Gradle运行包装程序时,它将下载并缓存该版本的Gradle二进制文件。Gradle Wrapper文件旨在用于源代码控制,因此任何人都可以构建项目,而无需首先安装和配置特定版本的Gradle。
在这一阶段,您将构建代码。您可以在此处查看结果:
build ├── classes │ └── main │ └── hello │ ├── Greeter.class │ └── HelloWorld.class ├── dependency-cache ├── libs │ └── gs-gradle-0.1.0.jar └── tmp └── jar └── MANIFEST.MF
包括两个预期的类文件Greeter
和HelloWorld
,以及JAR文件。快速浏览:
$ jar tvf build/libs/gs-gradle-0.1.0.jar 0 Fri May 30 16:02:32 CDT 2014 META-INF/ 25 Fri May 30 16:02:32 CDT 2014 META-INF/MANIFEST.MF 0 Fri May 30 16:02:32 CDT 2014 hello/ 369 Fri May 30 16:02:32 CDT 2014 hello/Greeter.class 988 Fri May 30 16:02:32 CDT 2014 hello/HelloWorld.class
类文件捆绑在一起。需要注意的重要一点是,即使您将joda-time声明为依赖项,该库也不包含在此处。而且JAR文件也不可运行。
为了使此代码可运行,我们可以使用gradle的application
插入。将此添加到您的build.gradle
文件。
apply plugin: 'application' mainClassName = 'hello.HelloWorld'
然后即可运行该应用程序!
$ ./gradlew run :compileJava UP-TO-DATE :processResources UP-TO-DATE :classes UP-TO-DATE :run The current local time is: 16:16:20.544 Hello world! BUILD SUCCESSFUL Total time: 3.798 secs
捆绑依赖项需要更多的思考。例如,如果我们要构建WAR文件(一种通常与打包第三方依赖相关的格式),则可以使用gradle的WAR插件 。如果您使用的是Spring Boot,并且想要一个可运行的JAR文件,那么spring-boot-gradle-plugin非常方便。在此阶段,gradle对您的系统了解不足,无法做出选择。但是就目前而言,这应该足以开始使用gradle。
为了完成本指南的内容,以下是完整的build.gradle
文件:
build.gradle
apply plugin: 'java'
apply plugin: 'eclipse'
apply plugin: 'application'
mainClassName = 'hello.HelloWorld'
// tag::repositories[]
repositories {
mavenCentral()
}
// end::repositories[]
// tag::jar[]
jar {
baseName = 'gs-gradle'
version = '0.1.0'
}
// end::jar[]
// tag::dependencies[]
sourceCompatibility = 1.8
targetCompatibility = 1.8
dependencies {
compile "joda-time:joda-time:2.2"
testCompile "junit:junit:4.12"
}
// end::dependencies[]
// tag::wrapper[]
// end::wrapper[]
这里嵌入了许多开始/结束注释。这样就可以将构建文件的某些内容提取到本指南中,以进行上述详细说明。您的生产构建文件中不需要它们。 |
摘要
恭喜你!现在,您已经创建了一个简单而有效的Gradle构建文件,用于构建Java项目。
也可以看看
以下指南也可能会有所帮助:
是否要编写新指南或为现有指南做出贡献?查看我们的贡献准则 。
所有指南均以代码的ASLv2许可证和写作的Attribution,NoDerivatives创作共用许可证发布 。 |