gradle入门(1-3)使用gradle开发一个发布版本

需求描述

1、使用Maven central仓库。
2、使用Log4j写入日志。
3、包含单元测试,保证正确的信息返回,单元测试必须使用JUnit编写。
4、创建一个可执行的Jar文件。

我们来看一下怎样实现这些需求。

一、开发一个胖的可执行jar

1、配置仓库

我们的演示程序的一个需求是构建脚本必须使用Maven central仓库,在我们使用Maven central仓库配置构建脚本后,源代码如下:

apply plugin: 'java'
repositories {
    mavenCentral()
}
jar {
      manifest {
          attributes 'Main-Class': 'com.inspur.example.gradle.HelloWorld'
      }
}

我们再来看一下如何对我们的演示程序进行依赖声明。

2、依赖声明

在build.gradle文件中,我们声明了两个依赖:

Log4j(版本1.2.17)用来记录日志。
JUnit(版本4.11)用来编写单元测试。
在我们声明了这些依赖后,build.gradle文件是这样的:

apply plugin: 'java'
repositories {
    mavenCentral()
}
dependencies {
        compile 'log4j:log4j:1.2.17'
        testCompile 'junit:junit:4.11'
}
jar {
    manifest {
        attributes 'Main-Class': 'com.inspur.example.gradle.HelloWorld'
    }
}

3、编写代码

public class MessageService {
    public String getMessage() {
        return "Hello World!";
    }
}

import org.junit.Before;
import org.junit.Test;
import static org.junit.Assert.assertEquals;
public class MessageServiceTest {
    private MessageService messageService;
    @Before
    public void setUp() {
        messageService = new MessageService();
    }
    @Test
    public void getMessage_ShouldReturnMessage() {
        assertEquals("Hello World!", messageService.getMessage());
    }
}

import org.apache.log4j.Logger;
public class HelloWorld {
    private static final Logger LOGGER = Logger.getLogger(HelloWorld.class);
    public static void main(String[] args) {
        MessageService messageService = new MessageService();
        String message = messageService.getMessage();
        LOGGER.info("Received message: " + message);
    }
}

配置log4j,log4j.properties文件如下:
log4j.appender.Stdout=org.apache.log4j.ConsoleAppender
log4j.appender.Stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.Stdout.layout.conversionPattern=%-5p - %-26.26c{1} - %m\n
log4j.rootLogger=DEBUG,Stdout

4、执行测试

执行测试
gradle test

测试输出:
> gradle test
:compileJava
:processResources
:classes
:compileTestJava
:processTestResources
:testClasses
:test
BUILD SUCCESSFUL
Total time: 4.678 secs
然而,如果测试失败,我们将看到如下输出:

执行单元测试时,Gradle会在相应目录创建测试报告:
build/test-results目录包含每次测试执行的原始数据。
build/reports/tests目录包含一个HTML报告,描述了测试的结果。
HTML测试报告是一个非常有用的工具,因为它描述了测试失败的原因。

5、打包和运行例子

我们能够可以使用以下任意一种命令打包程序:gradle assemblygradle build,这两个命令都会在build/libs目录中创建xxx.jar文件。
当我们使用java -jar xxx.jar命令运行演示程序时,我们可以看到如下输出:

java -jar xxx.jar
Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/log4j/Logger
at net.petrikainulainen.gradle.HelloWorld.<clinit>(HelloWorld.java:10)
Caused by: java.lang.ClassNotFoundException: org.apache.log4j.Logger
at java.net.URLClassLoader$1.run(URLClassLoader.java:372)
at java.net.URLClassLoader$1.run(URLClassLoader.java:361)
at java.security.AccessController.doPrivileged(Native Method)
at java.net.URLClassLoader.findClass(URLClassLoader.java:360)
at java.lang.ClassLoader.loadClass(ClassLoader.java:424)
at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:308)
at java.lang.ClassLoader.loadClass(ClassLoader.java:357)
... 1 more
抛出异常的原因是,当我们运行程序时,Log4j的依赖在classpath中没有找到。

解决这个问题最简单的方式是创建一个所谓的“胖”Jar文件,即把所有程序运行所需的依赖都打包到Jar文件中去。

通过查阅Gradle Cookbook中的教程,可以修改构建脚本,如下:

apply plugin: 'java'
repositories {
    mavenCentral()
}

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

jar {
    from { configurations.compile.collect { it.isDirectory() ? it : zipTree(it) } }
    manifest {
        attributes 'Main-Class': 'com.inspur.example.gradle.HelloWorld'
    }
}
现在,我们可以运行演示程序了(打包后),一切正常:

java -jar xxx.jar 

INFO - HelloWorld - Received message: Hello World!

二、创建二进制发布版本(瘦jar)

二进制发布版本需要满足以下需求:

  • 二进制发布一定不能使用所谓的“fat jar”方式。换句话说,我们应用程序中的所有依赖一定不能被打包到该程序相同的jar包中。
  • 二进制发布必须包含针对*nix和Windows操作系统的启动副本。
  • 二进制发布的根目录必须包含许可证。

1、使用Application插件

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

修改上文的build.gradle配置文件:

  1. 移除jar任务的配置。
  2. 为项目应用application插件。
  3. 对应用程序的主类进行配置,设置mainClassName属性。

1.1、修改前:

1.2、修改后:(移除jar任务,应用application插件,设置mainClassName属性)

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目录下找到。

2、打包二进制发布文件

我们可以通过在项目根目录下运行以下命令:gradle distZip 或 gradle distTar 创建二进制文件。

假设我们创建了一个打包为zip文件的二进制文件,输出如下:

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

  • bin目录:包括启动脚本。
  • lib目录:包括应用程序的jar文件以及它的依赖。

3、添加应用程序的许可证

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

以下步骤创建一个任务,将LICENSE文件从项目的根目录复制到build目录下。

3.1、创建copyLicense任务

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

3.2、在已创建的二进制文件中加入许可证文件

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

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

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

在项目根目录下运行命令:gradle distZip输出如下:

可以看到,copyLicense任务现在已经被引入了。

我们可以对二进制文件解压缩,在根目录下就能发现LICENSE文件了。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值