Gradle入门(5):创建二进制发布版本
在创建了一个实用的应用程序之后,我们可能想将其与他人分享。其中一种方式就是创建一个可以从网站上下载的二进制文件。
这篇教程描述了如何创建一个二进制发布版本,满足以下需求:
- 二进制发布一定不能使用所谓的“fat jar”方式。换句话说,我们应用程序中的所有依赖一定不能被打包到该程序相同的jar包中。
- 二进制发布必须包含针对*nix和Windows操作系统的启动副本。
- 二进制发布的根目录必须包含许可证。
我们开始吧。
创建二进制发布文件
Application插件是一种Gradle插件,让我们可以运行、安装应用程序并用非“fat jar”方式创建二进制发布版本。
还记得我们在上篇教程中提到的一个例子吗?在它的build.gradle文件中做一些相应的更改,就可以进行二进制发布了。
- [li]移除jar任务的配置。
- 为项目应用application插件。
- 对应用程序的主类进行配置,设置mainClassName属性。
在build.gradle文件中作出以上更改后,结果如下(相关部分已经高亮):
// Apply the java plugin to add support for Java
apply plugin: 'application'
apply plugin: 'java'
// 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. mavenCentral() } // In this section you declare the dependencies for your production and test code dependencies { compile 'log4j:log4j:1.2.17' testCompile 'junit:junit:4.11' } mainClassName = 'net.petrikainulainen.gradle.HelloWorld'
Application插件在项目中添加了5个任务:
- [li]run任务用以启动应用程序。
- startScripts任务会在build/scripts目录中创建启动脚本,这个任务所创建的启动脚本适用于Windows和*nix操作系统。
- installApp任务会在build/install/[project name]目录中安装应用程序。
- distZip任务用以创建二进制发布并将其打包为一个zip文件。可以在build/distributions目录下找到。
- distTar任务用以创建二进制发布并将其打包为一个tar文件。可以在build/distributions目录下找到。
我们可以通过在项目根目录下运行以下命令:gradle distZip或gradle distTar 创建二进制文件。假设我们创建了一个打包为zip文件的二进制文件,输出如下:
wuchao@wuchao-PC:~/workspace/GradleWorkSpace/application-distribute$ gradle distZip Picked up _JAVA_OPTIONS: -Dawt.useSystemAAFontSettings=gasp :compileJava UP-TO-DATE :processResources UP-TO-DATE :classes UP-TO-DATE :jar UP-TO-DATE :startScripts UP-TO-DATE :distZip UP-TO-DATE BUILD SUCCESSFUL Total time: 0.742 secs
如果将application插件创建的二进制文件解压缩,可以得到以下目录结构:
- [li]bin目录:包括启动脚本。
- lib目录:包括应用程序的jar文件以及它的依赖。
你可以阅读Gradle Application插件用户指南(第45章)了解更多关于Application插件信息。
现在,我们可以创建一个几乎能满足所有需求的二进制发布了。不过,我们仍然需要在我们二进制发布的根目录下添加应用程序的许可证。下面我就来看一下,如何做到这一点。
在二进制发布版本中添加应用程序许可证
我们可以通过以下步骤,在二进制发布中添加应用程序许可证:- [li]创建一个任务,将许可证从项目的根目录复制到build目录下。
- 将许可证加入到所创建的二进制发布的根目录下。
我们来仔细看一下这些步骤的详情。
将许可证文件复制到build目录下
LICENSE文件包含了我们应用程序的许可信息,可以在项目的根目录下找到它。
可以通过以下步骤将许可证文件复制到build目录下:
- [li]创建一个新的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,会看到以下输出:
wuchao@wuchao-PC:~/workspace/GradleWorkSpace/application-distribute$ gradle distZip Picked up _JAVA_OPTIONS: -Dawt.useSystemAAFontSettings=gasp :compileJava UP-TO-DATE :processResources UP-TO-DATE :classes UP-TO-DATE :jar UP-TO-DATE :startScripts UP-TO-DATE :distZip UP-TO-DATE BUILD SUCCESSFUL Total time: 1.233 secs
将许可证文件加入到二进制发布文件中
我们可以通过以下步骤将许可证文件加入到二进制发布文件中:
- [li]将copyLicense任务从一个Copy任务改为正常的Gradle任务,只需在它的声明中移除“(type: Copy)”字符串。
- 按照以下步骤修改copyLicense任务 配置copyLicense任务输出。创建一个新的文件对象,指向build目录的许可证文件,并将其设置为outputs.file属性值。
- 将许可证文件从项目的根目录复制到build目录下。
-
使用CopySpec接口中的from()方法配置许可证文件的位置,将copyLicense任务的输出作为方法参数。
在实现了这些步骤以后,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时,会看到以下输出:
wuchao@wuchao-PC:~/workspace/GradleWorkSpace/application-distribute$ gradle distZip Picked up _JAVA_OPTIONS: -Dawt.useSystemAAFontSettings=gasp :copyLicense :compileJava UP-TO-DATE :processResources UP-TO-DATE :classes UP-TO-DATE :jar UP-TO-DATE :startScripts UP-TO-DATE :distZip BUILD SUCCESSFUL Total time: 1.124 secs
可以看到,copyLicense任务现在已经被引入了。我们可以对二进制文件解压缩,在根目录下就能发现LICENSE文件了。
- Gradle入门系列(4):创建二进制发布版本
- Gradle入门系列(4):创建二进制发布版本
- Gradle入门系列(4):创建二进制发布版本
- Gradle入门系列(4):创建二进制发布版本
- Gradle入门系列(4):创建二进制发布版本
- 【Tools.Gradle】Gradle入门系列(4):创建二进制发布版本
- gradle入门(1-3)使用gradle开发一个发布版本
- ActiveReports 报表控件官方中文入门教程 (2)-创建、数据源、浏览以及发布
- xcode创建一个工程的多个taget,便于测试和发布多个版本
- xcode创建一个工程的多个taget,便于测试和发布多个版本
- JAX-WS集成Web工程的Web Service的创建和发布简单入门(1)
- Gradle入门系列(5):创建多项目构建
- 【Git学习笔记】给发布的版本创建标签
- 在VC中创建两套资源解决中英文版本发布的问题
- 使用Gradle发布SNAPSHOT版本到JCenter(oss.jfrog.org)
- xcode创建一个工程的多个target,便于测试和发布多个版本
- Android通过Gradle发布多渠道版本遇到的Gradle版本问题解决
- JAX-WS集成Web工程的Web Service的创建和发布简单入门
- 用MyEclipse8.5及以上版本创建webservice实例(入门级超简单)
- jqGrid(3.6版本) 入门——创建jqGrid表格