在本文中,将探讨如何使用Eclipse IDE和Buildship插件来创建和构建一个简单的GradleJava应用程序。将从安装Buildship插件开始,然后创建一个最小的Gradle项目,并逐步了解Gradle Wrapper的工作原理。接着,将创建一个典型的Gradle构建文件,并探索Eclipse的外部工具功能,以简化构建过程。最后,将通过一个Spring Boot JAR示例来展示如何将Maven项目转换为Gradle项目。
要开始使用Gradle,首先需要在Eclipse中安装Buildship插件。可以通过Eclipse菜单中的“帮助”选项找到Eclipse Marketplace,并搜索“Buildship”来找到Gradle Integration插件。按照提供的指示安装Buildship,安装完成后需要重启Eclipse。
安装Buildship后,可以在Eclipse中创建一个Gradle项目。通过选择“文件”->“新建”->“其他…”->“Gradle”->“Gradle项目”来启动Gradle项目向导。在询问Gradle分发版本时,确保选择“Gradle Wrapper”。按照向导步骤完成,将在Eclipse中拥有一个最小的Gradle项目。
Gradle Wrapper是一个工具,它允许在团队和构建服务器上使用相同版本的Gradle来构建项目,无论是否有本地Gradle安装。Gradle Wrapper包括四个文件,这些文件需要检入源代码控制中以与团队共享。
gradle/wrapper/gradle-wrapper.jar
gradle/wrapper/gradle-wrapper.properties
gradlew
gradlew.bat
文件gradle-wrapper.properties
指定了用于构建项目的Gradle版本。例如:
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-4.3-bin.zip
文件gradlew
和gradlew.bat
是批处理文件,用于通过Wrapper发出Gradle命令。在Linux中使用gradlew
,在Windows中使用gradlew.bat
。如果想改变Wrapper使用的Gradle版本,可以执行以下命令:
gradlew wrapper --gradle-version=4.5 --distribution-type=bin
在Gradle中,一个典型的项目需要两个文件:settings.gradle
和build.gradle
。对于Buildship向导生成的最小项目,settings.gradle
文件可能如下所示:
rootProject.name = 'minimal-project'
对于单项目应用,settings.gradle
文件主要用于指定项目名称。实际上,如果从项目中删除这个文件,Gradle仍然可以构建项目。在讨论多项目应用时,将更多地了解settings.gradle
的用途。
build.gradle
文件告诉Gradle如何构建项目。例如:
apply plugin: 'java-library'
repositories { jcenter() }
dependencies {
api 'org.apache.commons:commons-math3:3.6.1'
testImplementation 'junit:junit:4.12'
}
在repositories
部分,Gradle被告知从Bintray jcenter仓库查找依赖项;在dependencies
部分,Gradle被告知构建应用程序需要commons-math3
库,运行单元测试需要junit
。apply plugin: 'java-library'
告诉Gradle项目将被构建成一个Java库。
如果想在Eclipse中更容易地通过gradlew
发出构建命令,可以使用Eclipse的外部工具功能。可以通过点击外部工具图标->外部工具配置...来添加外部工具配置。可以为配置选择任何名称。为了方便,简单地称之为gradlew clean build
。在将gradlew clean build
配置添加到Eclipse后,可以使用以下命令通过外部工具配置在Eclipse中构建项目:
gradlew clean build
应该能够看到项目成功构建,并且单元测试也成功运行。
为了比Buildship向导创建的最小项目有更好的评估,将之前创建的一个Maven项目转换为Gradle项目。示例是一个Spring Boot可执行JAR应用程序。如果想查看这个Gradle示例,强烈建议查看之前的笔记。这篇笔记是关于Gradle的,不是关于Spring Boot的。在这篇笔记中,不会花时间讨论如何将Spring Boot应用程序打包成JAR文件。
如果在Eclipse中安装了Buildship,可以导入附加的项目。可以通过点击“文件”->“导入…”->“Gradle”->“现有Gradle项目”来导入项目。项目结构与之前笔记中的示例完全相同。唯一的区别是这个项目将使用Gradle构建。
如果已经成功地将项目导入到Eclipse中,可以在Eclipse中调试/运行应用程序。可以通过右键点击项目->调试为/运行为->Java应用程序,并选择ApplicationStart
作为应用程序的入口类来调试/运行应用程序。
可以通过以下命令使用GradleWrapper构建应用程序:
gradlew clean build install
构建成功后,在项目目录下的build/libs
目录中会创建spring-boot-example-gradle-0.0.1.jar
文件。可以通过以下命令从项目目录运行JAR文件:
java -jar build/libs/spring-boot-example-gradle-0.0.1.jar
无论以何种方式启动应用程序,如果启动成功,可以通过浏览器测试它。