Maven程序打包成单个Jar Part 1 -- Maven assembly plugin

薛涛
2023-12-01

之前介绍过如何使用assembly打包配置文件,这里想介绍一下如何把整个project打包成一个单独的可执行jar。在系统测试过程中,要求提供一个单独的jar给其他集成team做测试。第一次进行jar打包,最开始就选择了用assembly plugin,因为我们的测试程序在src/test/java里面,而assembly可以自动打包test包以及test依赖,实现如下:
1. 创建打包test class和test dependency的assembly配置文件package.xml在src/main/resources/assembly/里:

<assembly
    xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 http://maven.apache.org/xsd/assembly-1.1.3.xsd">
    <id>test-executable</id>
    <formats>
        <format>jar</format>
    </formats>
    <includeBaseDirectory>false</includeBaseDirectory>
    <dependencySets>
        <dependencySet>
            <outputDirectory>/</outputDirectory>
            <useProjectArtifact>true</useProjectArtifact>
            *<unpack>true</unpack>
            <scope>test</scope>*
        </dependencySet>
    </dependencySets>
    <fileSets>
        <fileSet>
            <directory>${project.build.directory}/classes</directory>
            <outputDirectory>/</outputDirectory>
            <includes>
                <include>**/*</include>
            </includes>
            <useDefaultExcludes>true</useDefaultExcludes>
        </fileSet>
        <fileSet>
            <directory>${project.build.directory}/test-classes</directory>
            <outputDirectory>/</outputDirectory>
            <includes>
                <include>**/*</include>
            </includes>
            <useDefaultExcludes>true</useDefaultExcludes>
        </fileSet>
    </fileSets>
</assembly>
  1. 创建maven-assembly-plugin打包配置:
<plugin>
                <artifactId>maven-assembly-plugin</artifactId>
                <version>2.3</version>
                <configuration>
                    <descriptor>src/main/resources、assembly/package.xml</descriptor>
                </configuration>
                <executions>
                    <execution>
                        <id>make-package</id>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                        <configuration>
                            <archive>
                                <manifest>
                        <!-- main class -->            <mainClass>com.cloud.....PublisherTest</mainClass>
                                </manifest>
                            </archive>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

执行maven package之后就会有*-test-executable.jar在target folder里面,包含了所有需要的class文件。不过这种打包方式有问题,因为遇到同名文件assembly会直接忽略,对于spring相关的jar来说,xsd文件都在meta-inf里面保存(META-INF/spring.handlers and META-INF/spring.schemas),如此打包会导致很多的xsd在无网络的情况下无法解析,报以下的问题:

Unable to locate NamespaceHandler when using ***

这个时候就需要使用maven-shade-plugin,在下一篇中介绍。

 类似资料: