建设银行征信中心个人信用查询官方网站,画册排版设计模板,网页设计培训机构推荐,超大免费网站空间gradle构建多模块项目尽管我们可以仅使用一个模块来创建一个运行中的应用程序#xff0c;但有时将我们的应用程序划分为多个较小的模块是比较明智的。 因为这是一个相当普遍的用例#xff0c;所以每个自重的构建工具都必须支持它#xff0c;Gradle也不例外。 如果Gradl… gradle构建多模块项目 尽管我们可以仅使用一个模块来创建一个运行中的应用程序但有时将我们的应用程序划分为多个较小的模块是比较明智的。 因为这是一个相当普遍的用例所以每个自重的构建工具都必须支持它Gradle也不例外。 如果Gradle项目具有多个模块则称为多项目构建。 这篇博客文章描述了如何使用Gradle创建多项目构建。 让我们开始看看Gradle构建的需求。 补充阅读 如果您不熟悉Gradle 则应先阅读以下博客文章然后再继续阅读此博客文章 Gradle入门简介可帮助您安装Gradle描述Gradle构建的基本概念并描述如何使用Gradle插件向构建中添加功能。 Gradle入门我们的第一个Java项目描述了如何使用Gradle创建Java项目并将应用程序打包到可执行jar文件中。 Gradle入门依赖性管理介绍了如何管理Gradle项目的依赖性。 我们的Gradle构建要求 我们的示例应用程序具有两个模块 核心模块包含我们应用程序的其他模块所使用的通用组件。 在我们的例子中它仅包含一个类 MessageService类返回字符串“ Hello World”。 该模块只有一个依赖性它具有一个使用Junit 4.11的单元测试。 app模块包含HelloWorld类该类启动我们的应用程序从MessageService对象获取消息并将接收到的消息写入日志文件。 该模块具有两个依赖性它需要核心模块并使用Log4j 1.2.17作为日志记录库。 我们的Gradle版本还具有其他两个要求 我们必须能够使用Gradle运行我们的应用程序。 我们必须能够创建不使用所谓的“胖罐”方法的可运行二进制分发。 如果您不知道如何使用Gradle运行应用程序并创建可运行的二进制发行版 您应先阅读以下博客文章然后再继续阅读此博客文章 Gradle入门创建二进制分发 让我们继续前进了解如何创建满足我们要求的多项目构建。 创建多项目构建 我们的下一步是创建一个包含两个子项目的多项目Gradle构建 app和core 。 让我们从创建Gradle构建的目录结构开始。 创建目录结构 因为核心和应用程序模块使用Java所以它们都使用Java项目的默认项目布局 。 我们可以按照以下步骤创建正确的目录结构 创建核心模块 core 的根目录并创建以下子目录 src / main / java目录包含核心模块的源代码。 src / test / java目录包含核心模块的单元测试。 创建应用程序模块 app 的根目录并创建以下子目录 src / main / java目录包含应用程序模块的源代码。 src / main / resources目录包含应用程序模块的资源。 现在我们已经创建了所需的目录。 下一步是配置Gradle构建。 让我们从配置多项目构建中包含的项目开始。 配置我们的多项目构建中包含的项目 通过执行以下步骤我们可以配置包含在多项目构建中的项目 将settings.gradle文件创建到根项目的根目录。 多项目Gradle构建必须具有此文件因为它指定了多项目构建中包含的项目。 确保应用程序和核心项目包含在我们的多项目版本中。 我们的settings.gradle文件如下所示 include app
include core 补充阅读 Gradle用户指南56.2设置文件 Gradle DSL参考设置 让我们继续并配置核心项目。 配置核心项目 我们可以按照以下步骤配置核心项目 将build.gradle文件创建到核心项目的根目录。 通过应用Java插件来创建Java项目。 确保核心项目从中央Maven2存储库获取其依赖项。 声明JUnit依赖关系版本4.11并使用testCompile配置。 此配置描述了核心项目在可以对其单元测试进行编译之前需要JUnit库。 核心项目的build.gradle文件如下所示 apply plugin: javarepositories {mavenCentral()
}dependencies {testCompile junit:junit:4.11
} 补充阅读 Gradle入门我们的第一个Java项目 Gradle入门依赖管理 让我们继续并配置应用程序项目。 配置应用程序项目 在配置应用程序项目之前我们必须快速浏览属于同一多项目构建的此类依赖项的依赖项管理。 这些依赖关系称为项目依赖关系。 如果我们的多项目构建具有项目A和B并且项目B的编译需要项目A则可以通过将以下依赖项声明添加到项目B的build.gradle文件中来配置此依赖项 dependencies {compile project(:A)
} 补充阅读 Gradle用户指南51.4.3。 项目依赖 Gradle用户指南57.7。 项目库依赖项 现在我们可以按照以下步骤配置应用程序项目 将build.gradle文件创建到应用程序项目的根目录。 通过应用Java插件来创建Java项目。 确保应用程序项目从中央Maven2存储库获取其依赖项。 配置所需的依赖项。 该应用程序项目在编译时具有两个依赖项 Log4j版本1.2.17 核心模块 创建一个可运行的二进制发行版 。 该应用程序项目的build.gradle文件如下所示 apply plugin: application
apply plugin: javarepositories {mavenCentral()
}dependencies {compile log4j:log4j:1.2.17compile project(:core)
}mainClassName net.petrikainulainen.gradle.client.HelloWorldtask copyLicense {outputs.file new File($buildDir/LICENSE)doLast {copy {from LICENSEinto $buildDir}}
}applicationDistribution.from(copyLicense) {into
} 补充阅读 Gradle入门创建二进制分发 让我们继续并删除从核心和应用程序项目的构建脚本中找到的重复配置。 删除重复的配置 当我们配置多项目构建的子项目时我们向核心和应用项目的构建脚本添加了重复的配置 因为两个项目都是Java项目所以它们都应用Java插件。 这两个项目都使用中央Maven 2存储库。 换句话说两个构建脚本都包含以下配置 apply plugin: javarepositories {mavenCentral()
} 让我们将此配置移到我们的根项目的build.gradle文件中。 在执行此操作之前我们必须学习如何在根项目的build.gradle文件中配置子项目。 如果要将配置添加到名为core的单个子项目中则必须将以下代码段添加到根项目的build.gradle文件中 project(:core) {//Add core specific configuration here
} 换句话说如果要将重复的配置移到根项目的构建脚本中则必须将以下配置添加到其build.gradle文件中 project(:app) {apply plugin: javarepositories {mavenCentral()}
}project(:core) {apply plugin: javarepositories {mavenCentral()}
} 这并没有真正改变我们的处境。 我们的构建脚本中仍然有重复的配置。 唯一的区别是现在可以从根项目的build.gradle文件中找到重复的配置。 让我们消除这种重复的配置。 如果要将通用配置添加到根项目的子项目中则必须将以下代码段添加到根项目的build.gradle文件中 subprojects {//Add common configuration here
} 从根项目的build.gradle文件中删除重复的配置后其外观如下 subprojects {apply plugin: javarepositories {mavenCentral()}
} 如果我们拥有多项目构建中所有项目共享的配置则应将以下代码段添加到 我们的根项目的build.gradle文件 allprojects {//Add configuration here
} 补充阅读 Gradle用户指南57.1跨项目配置 Gradle用户指南57.2子项目配置 现在我们可以从子项目的构建脚本中删除重复的配置。 我们的子项目的新构建脚本如下所示 core / build.gradle文件如下所示 dependencies {testCompile junit:junit:4.11
} app / build.gradle文件如下所示 apply plugin: applicationdependencies {compile log4j:log4j:1.2.17compile project(:core)
}mainClassName net.petrikainulainen.gradle.client.HelloWorldtask copyLicense {outputs.file new File($buildDir/LICENSE)doLast {copy {from LICENSEinto $buildDir}}
}applicationDistribution.from(copyLicense) {into
} 现在我们已经创建了一个多项目Gradle构建。 让我们找出我们刚刚做了什么。 我们只是做什么 当我们在多项目构建的根目录中运行命令gradle projects时我们看到以下输出 gradle projects
:projects------------------------------------------------------------
Root project
------------------------------------------------------------Root project multi-project-build
--- Project :app
\--- Project :coreTo see a list of the tasks of a project, run gradle project-path:tasks
For example, try running gradle :app:tasksBUILD SUCCESSFUL 如我们所见此命令列出了根项目的子项目 app和core 。 这意味着我们刚刚创建了一个具有两个子项目的多项目Gradle构建。 当在多项目构建的根目录中运行命令gradle任务时我们看到以下输出下面仅显示了相关部分 gradle tasks
:tasks------------------------------------------------------------
All tasks runnable from root project
------------------------------------------------------------Application tasks
-----------------
distTar - Bundles the project as a JVM application with libs and OS specific scripts.
distZip - Bundles the project as a JVM application with libs and OS specific scripts.
installApp -Installs the project as a JVM application along with libs and OS specific scripts
run - Runs this project as a JVM application 如我们所见我们可以使用Gradle运行应用程序并创建一个不使用所谓的“胖罐”方法的二进制发行版。 这意味着我们已经满足了Gradle构建的所有要求。 附加信息 Gradle用户指南11.6。 获取有关构建的信息 让我们继续前进找出从这篇博客文章中学到的知识。 摘要 这篇博客文章教会了我们三件事 多项目构建必须在根项目的根目录中具有settings.gradle文件因为它指定了多项目构建中包含的项目。 如果必须在多项目构建的所有项目中添加通用配置或行为则应将此配置使用allprojects 添加到根项目的build.gradle文件中。 如果必须在根项目的子项目中添加通用配置或行为则应将此配置使用subprojects 添加到根项目的build.gradle文件中。 PS您可以从Github获得此博客文章的示例应用程序 。 翻译自: https://www.javacodegeeks.com/2015/01/getting-started-with-gradle-creating-a-multi-project-build.htmlgradle构建多模块项目
