您可以捐助,支持我们的公益事业。

1元 10元 50元





认证码:  验证码,看不清楚?请点击刷新验证码 必填



  求知 文章 文库 Lib 视频 iPerson 课程 认证 咨询 工具 讲座 Modeler   Code  
会员   
 
   
 
 
     
   
 订阅
  捐助
Gradle入门系列(下)
 
来源:伯乐在线 发布于 2015-9-8
   次浏览      
 

Gradle入门系列(4):创建二进制发布版本

在创建了一个实用的应用程序之后,我们可能想将其与他人分享。其中一种方式就是创建一个可以从网站上下载的二进制文件。

这篇教程描述了如何创建一个二进制发布版本,满足以下需求:

二进制发布一定不能使用所谓的“fat jar”方式。换句话说,我们应用程序中的所有依赖一定不能被打包到该程序相同的jar包中。

二进制发布必须包含针对*nix和Windows操作系统的启动副本。

二进制发布的根目录必须包含许可证。

我们开始吧。

创建二进制发布文件

Application插件是一种Gradle插件,让我们可以运行、安装应用程序并用非“fat jar”方式创建二进制发布版本。

还记得我们在上篇教程中提到的一个例子吗?在它的build.gradle文件中做一些相应的更改,就可以进行二进制发布了。

移除jar任务的配置。

为项目应用application插件。

对应用程序的主类进行配置,设置mainClassName属性。

在build.gradle文件中作出以上更改后,结果如下(相关部分已经高亮):

apply plugin: 'application'
apply plugin: 'java'

repositories {
mavenCentral()
}

dependencies {
compile 'log4j:log4j:1.2.17'
testCompile 'junit:junit:4.11'
}

mainClassName = 'net.petrikainulainen.gradle.HelloWorld'

Application插件在项目中添加了5个任务:

run任务用以启动应用程序。

startScripts任务会在build/scripts目录中创建启动脚本,这个任务所创建的启动脚本适用于Windows和*nix操作系统。

installApp任务会在build/install/[project name]目录中安装应用程序。

distZip任务用以创建二进制发布并将其打包为一个zip文件。可以在build/distributions目录下找到。

distTar任务用以创建二进制发布并将其打包为一个tar文件。可以在build/distributions目录下找到。

我们可以通过在项目根目录下运行以下命令:gradle distZip或gradle distTar 创建二进制文件。假设我们创建了一个打包为zip文件的二进制文件,输出如下:

> gradle distZip
:compileJava
:processResources
:classes
:jar
:startScripts
:distZip

BUILD SUCCESSFUL

Total time: 4.679 secs

如果将application插件创建的二进制文件解压缩,可以得到以下目录结构:

bin目录:包括启动脚本。

lib目录:包括应用程序的jar文件以及它的依赖。

你可以阅读Gradle Application插件用户指南(第45章)了解更多关于Application插件信息。

现在,我们可以创建一个几乎能满足所有需求的二进制发布了。不过,我们仍然需要在我们二进制发布的根目录下添加应用程序的许可证。下面我就来看一下,如何做到这一点。

在二进制发布版本中添加应用程序许可证

我们可以通过以下步骤,在二进制发布中添加应用程序许可证:

创建一个任务,将许可证从项目的根目录复制到build目录下。

将许可证加入到所创建的二进制发布的根目录下。

我们来仔细看一下这些步骤的详情。

将许可证文件复制到build目录下

LICENSE文件包含了我们应用程序的许可信息,可以在项目的根目录下找到它。

可以通过以下步骤将许可证文件复制到build目录下:

创建一个新的Copy任务,名为copyLicense。

使用CopySpec接口中的from()方法配置源文件,将“LICENSE”作为参数调用。

使用CopySpec接口中into()方法配置target目录,将$buildDir属性作为参数调用。

在完成这些步骤以后,build.gradle文件如下(相关部分已高亮):

apply plugin: 'application'
apply plugin: 'java'

repositories {
mavenCentral()
}

dependencies {
compile 'log4j:log4j:1.2.17'
testCompile 'junit:junit:4.11'
}

mainClassName = 'net.petrikainulainen.gradle.HelloWorld'

task copyLicense(type: Copy) {
from "LICENSE"
into "$buildDir"
}

现在,我们已经创建了一个任务,将LICENSE文件从项目的根目录复制到build目录下。然而,当我们在项目根目录下运行命令:gradle distZip,会看到以下输出:

> gradle distZip
:compileJava
:processResources
:classes
:jar
:startScripts
:distZip

BUILD SUCCESSFUL

Total time: 4.679 secs

换句话说,我们新的任务还没有被引入。所以理所当然的,二进制发布中也没有包含许可证。让我们来修复这个问题。

将许可证文件加入到二进制发布文件中

我们可以通过以下步骤将许可证文件加入到二进制发布文件中:

将copyLicense任务从一个Copy任务改为正常的Gradle任务,只需在它的声明中移除“(type: Copy)”字符串。

按照以下步骤修改copyLicense任务

配置copyLicense任务输出。创建一个新的文件对象,指向build目录的许可证文件,并将其设置为outputs.file属性值。

将许可证文件从项目的根目录复制到build目录下。

Application插件在项目中设置了一个CopySpec属性,名为applicationDistribution。我们可以使用这个属性在已创建的二进制文件中加入许可证文件,步骤如下:

使用CopySpec接口中的from()方法配置许可证文件的位置,将copyLicense任务的输出作为方法参数。

使用CopySpec接口中into()方法配置target目录,将一个空的字符串作为参数调用方法。

在实现了这些步骤以后,build.gradle文件如下(相关部分已高亮):

apply plugin: 'application'
apply plugin: 'java'

repositories {
mavenCentral()
}

dependencies {
compile 'log4j:log4j:1.2.17'
testCompile 'junit:junit:4.11'
}

mainClassName = 'net.petrikainulainen.gradle.HelloWorld'

task copyLicense {
outputs.file new File("$buildDir/LICENSE")
doLast {
copy {
from "LICENSE"
into "$buildDir"
}
}
}

applicationDistribution.from(copyLicense) {
into ""
}

在项目根目录下运行命令gradle distZip时,会看到以下输出:

> gradle distZip
:copyLicense
:compileJava
:processResources
:classes
:jar
:startScripts
:distZip

BUILD SUCCESSFUL

Total time: 5.594 secs

可以看到,copyLicense任务现在已经被引入了。我们可以对二进制文件解压缩,在根目录下就能发现LICENSE文件了。

最后,我们对这篇教程中所学到的东西进行总结。

总结

这篇教程为我们教授了三方面内容:

学会使用application插件创建一个二进制发布。

学会使用Copy任务将一个文件从源目录复制到目标目录。

学会如果将文件加入到由Application插件创建的二进制发布文件中。

Gradle入门系列(5):创建多项目构建

尽管我们可以仅使用单个组件来创建可工作的应用程序,但有时候更广泛的做法是将应用程序划分为多个更小的模块。

由于这是一个非常普通的案例,因此每个成熟的构建工具都必须支持这项功能,Gradle也不例外。倘若Gradle项目拥有多于一个组件,我们就将其称之为多项目构建(multi-project build)。

这篇教程描述了如何使用Gradle创建一个多项目构建。

我们先来看一看Gradle构建的一些需求。

Gradle Build 的需求

我们的示例程序拥有两个模块:

core模块包含一些通用的组件,它们能够被程序的其他模块使用。在我们的例子上,只包含一个类:MessageService类返回‘Hello World!’字符串。该模块只有一个依赖:它包含一个单元测试,使用Junit 4.11。

app模块包含HelloWorld类,是程序的开端,它从MessageService对象中获取信息,并将接收到的信息写入一个日志文件中。该模块拥有两个依赖:它需要core模块,还使用Log4j 1.2.17作为日志库。

我们的Gradle构建还有其他两个需求:

我们必须要使用Gradle运行程序。

我们必须要创建一个可运行的二进制发布,而且不能使用所谓的“fat jar”方式。

如果你还不清楚怎样使用Gradle运行程序,以及创建可运行的二进制发布,在阅读这篇教程前,你应该先阅读以下文章,《Gradle入门系列(4):创建二进制发布版本》

我们继续来探讨一下如何创建一个多项目构建来满足我们的需求。

创建一个多项目构建

下一步,我们将创建一个多项目的Gradle构建,包括两个子项目:app 和 core。初始阶段,先要建立Gradle构建的目录结构。

建立目录结构

由于core和app模块都使用Java语言,而且它们都使用Java项目的默认项目布局,我们根据以下步骤建立正确的目录结构:

建立core模块的根目录(core),并建立以下子目录:

src/main/java目录包含core模块的源代码。

src/test/java目录包含core模块的单元测试。

建立app模块的根目录(app),并建立以下子目录:

src/main/java目录包含app模块的源代码。

src/main/resources目录包含app模块的资源文件。

现在,我们已经创建了所需的目录,下一步是配置Gradle构建,先对包含在多项目构建中的项目进行配置。

对包含在多项目构建中的项目进行配置

我们可以通过以下步骤,对包含在多项目构建中的项目进行配置:

在根项目的根目录下创建settings.gradle文件,一个多项目Gradle构建必须含有这个文件,因为它指明了那些包含在多项目构建中的项目。

确保app和core项目包含在我们的多项目构建中。

我们的settings.gradle文件如下:

include 'app'
include 'core'

配置 core 项目

我们可以通过以下步骤对core项目进行配置:

1. 在core项目的根目录下创建build.gradle文件。

2. 使用Java插件创建一个Java项目。

3. 确保core项目从Maven2中央仓库(central Maven2 repository)中获取依赖。

4. 声明JUnit依赖(版本4.11),并使用testCompile配置项,该配置项表明:core项目在它的单元测试被编译前,需要JUnit库。
core项目的build.gradle文件如下:

apply plugin: 'java'

repositories {
mavenCentral()
}

dependencies {
testCompile 'junit:junit:4.11'
}

我们继续对app项目进行配置。

配置App项目

在配置app项目之前,我们先来快速浏览一下对一些特殊依赖的依赖管理,这些依赖都是同一个多项目构建的一部分,我们将其称之为”项目依赖“。

如果多项目构建拥有项目A和B,同时,项目B的编译需要项目A,我们可以通过在项目B的build.gradle文件中添加以下依赖声明来进行依赖配置。

dependencies {
compile project(':A')
}

现在,我们可以按照以下步骤配置app项目:

在app项目的根目录下创建build.gradle文件。

用Java插件创建一个Java项目。

确保app项目从Maven2中央仓库(central Maven2 repository)中获取依赖。

配置所需的依赖,app项目在编译时需要两个依赖:

1)Log4j (version 1.2.17)

2)core 模块

创建二进制发布版本

app项目的build.gradle文件如下:

apply plugin: 'application'
apply plugin: 'java'

repositories {
mavenCentral()
}

dependencies {
compile 'log4j:log4j:1.2.17'
compile project(':core')
}

mainClassName = 'net.petrikainulainen.gradle.client.HelloWorld'

task copyLicense {
outputs.file new File("$buildDir/LICENSE")
doLast {
copy {
from "LICENSE"
into "$buildDir"
}
}
}

applicationDistribution.from(copyLicense) {
into ""
}

我们继续,下面是移除core和app项目的构建脚本中的重复配置。

移除重复配置

当我们对多项目构建中的子项目进行配置时,我们在core和app项目的构建脚本中添加了重复的配置。

由于两个项目都是Java项目,因此它们都使用Java插件。

两个项目都使用Maven2中央仓库(central Maven2 repository)。

换句话说,两个构建脚本都包含以下配置:

apply plugin: 'java'

repositories {
mavenCentral()
}

让我们将这项配置转移到根项目的build.gradle文件中,在此之前,我们必须先学习一下如何在根项目的build.gradle文件中配置子项目。

如果我们想要在一个称为core的子项目中添加配置,那么就必须在根项目的build.gradle文件中添加以下片段:

project(':core') {
//Add core specific configuration here
}

换句话说,如果想要将重复的配置转移到根项目的构建脚本中,就必须将以下配置添加到build.gradle文件中:

project(':app') {
apply plugin: 'java'

repositories {
mavenCentral()
}
}

project(':core') {
apply plugin: 'java'

repositories {
mavenCentral()
}
}

不过这种做法在实质上并没有改变什么,在构建脚本中依然还存在重复配置,唯一的区别是重复配置现在转移到了根项目的build.gradle文件中。让我们来消灭这些重复配置。

如果我们想要在根项目的子项目中添加通用的配置,需要将以下片段添加到根项目的build.gradle文件中:

subprojects {
//Add common configuration here
}

在根项目的build.gradle文件中移除了重复配置后,代码如下:

subprojects {
apply plugin: 'java'

repositories {
mavenCentral()
}
}

如果我们的配置项是被多项目构建中的所有项目所共享的,那么需要在根项目的build.gradle文件中添加以下片段:

allprojects {
//Add configuration here
}

现在,我们可以从子项目的构建脚本中移除重复配置,子项目新的构建脚本如下:

core/build.gradle文件如下:

dependencies {
testCompile 'junit:junit:4.11'
}

app/build.gradle文件如下:

apply plugin: 'application'

dependencies {
compile 'log4j:log4j:1.2.17'
compile project(':core')
}

mainClassName = 'net.petrikainulainen.gradle.client.HelloWorld'

task copyLicense {
outputs.file new File("$buildDir/LICENSE")
doLast {
copy {
from "LICENSE"
into "$buildDir"
}
}
}

applicationDistribution.from(copyLicense) {
into ""
}

现在,我们已经创建了一个多项目Gradle构建,下面让我们来直观的感受一下我们做了些什么。

我们刚刚做了什么?

在我们的多项目构建的根目录下执行命令gradle projects,可以看到如下输出:

> gradle projects
:projects

------------------------------------------------------------
Root project
------------------------------------------------------------

Root project 'multi-project-build'
+--- Project ':app'
--- Project ':core'

To see a list of the tasks of a project, run gradle <project-path>:tasks
For example, try running gradle :app:tasks

BUILD SUCCESSFUL

正如我们所看到的,这条命令列出了根项目的子项目(app和core),这意味着我们刚才已经创建了一个多项目Gradle构建,它拥有两个子项目。

在我们的多项目构建的根目录下执行命令gradle tasks,可以看到如下输出(仅列出相关部分):

> 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运行程序,并创建一个可运行的二进制发布,它没有使用所谓的“fat jar”方式。这表明我们已经满足了本文中要求实现的Gradle构建的所有需求。

我们继续来看一下,从这篇教程中我们学到了什么。

总结

这篇教程教会了我们三部分内容:

一个多项目构建必须在根项目的根目录下包含settings.gradle文件,因为它指明了那些包含在多项目构建中的项目。

如果需要在多项目构建的所有项目中加入公用的配置或行为,我们可以将这项配置加入到根项目的build.gradle文件中(使用allprojects)。

如果需要在根项目的子项目中加入公用的配置或行为,我们可以将这项配置加入到根项目的build.gradle文件中(使用subprojects)。

   
次浏览       
相关文章

为什么要做持续部署?
剖析“持续交付”:五个核心实践
集成与构建指南
持续集成工具的选择-装载
相关文档

持续集成介绍
使用Hudson持续集成
持续集成之-依赖管理
IPD集成产品开发管理
相关课程

配置管理、日构建与持续集成
软件架构设计方法、案例与实践
单元测试、重构及持续集成
基于Android的单元、性能测试
最新课程计划
信息架构建模(基于UML+EA)3-21[北京]
软件架构设计师 3-21[北京]
图数据库与知识图谱 3-25[北京]
业务架构设计 4-11[北京]
SysML和EA系统设计与建模 4-22[北京]
DoDAF规范、模型与实例 5-23[北京]

集成与构建指南
项目管理:Maven让事情变得简单
持续集成工具hudson
持续集成
Maven权威指南
程序集(UML中的包)之间循环
更多...   


产品发布管理
配置管理方法、实践、工具
多层次集成配置管理
使用CC与CQ进行项目实践
CVS与配置管理
Subversion管理员


海航股份 重构及持续集成
电研华源 设计原理、建模与重构
软件配置管理日构建及持续集成
单元测试、重构及持续集成
中国软件研发中心 单元测试与重构
单元测试、重构和持续集成实践
罗克韦尔 C++单元测试+重构+Gtest
更多...