使用maven-assembly-plugin如何打包多模块项目

maven-assembly-plugin打包多模块项目

概述

maven-assembly-plugin 是目前maven项目中最常用的打包工具,它便利、配置简单,因此可以满足我们大部分的需求。

实际开发过程中大部分Maven项目都是多模块的,因为工作需要,对其进行了研究与尝试,目前可以将多模块按照自己需求打包到一起。

1. 需求

项目本身代码非常复杂,最深可以到三层模块,即GrandFather -> Parent -> child,要求打包后的结构如下:

​​​​

目录的含义不

再追溯,下面直接将打包方法。

2. 打包流程

2.1 新建打包模块

Maven多模块打包在一起时,需要新建一个专门用于打包的模块,该模块不需要有任何Java代码,只需要配置一些最终形成的环境即可。但是该模块有一个非常重要的要求: 该模块必须是整个项目最后一个进行打包的。

可以通过配置pom.xml中加载模块的顺序来控制,最后配置进入的即最后进行打包的:

使用maven-assembly-plugin如何打包多模块项目_第1张图片

使用maven-assembly-plugin如何打包多模块项目_第2张图片

本人项目比较复杂,最终配置的打包是在tools子模块下的tools-package模块中进行配置。

2.2 配置打包模块

根据最终生成的路径需求,将所有的相关路径及一些命令、配置文件等按照要求在打包模块中实现,放在resources目录即可。

使用maven-assembly-plugin如何打包多模块项目_第3张图片

注:该项目中不需要任何Java代码

2.3 配置打包模块的pom.xml


        
            
                org.apache.maven.plugins
                maven-assembly-plugin
                2.4.1
                
                    
                        make-assembly
                        package
                        
                            single
                        
                        
                            xxxxx
                            
                                src/main/resources/assemble/assemble.xml
                            
                        
                    
                
            
        
    

2.4 配置其他模块打包方式

因为项目中使用的SpringBoot,SpringBoot也提供了一种打包方式:spring-boot-maven-plugin,这种方式打包时会将该项目中所有依赖的包(包括静态文件)统一打包至一个jar中,这个不是我们项目的需求,我们的需求是将所有的jar包(包括第三方及当前项目的jar包)都放在lib目录,且是单独存在。

因此需要将其他模块的打包配置修改,修改分为两步:

1)不再使用spring-boot-maven-plugin进行打包,即将其从pom.xml中删除;

2)在pom.xml文件中使用maven-jar-plugin进行打包,该打包如何配置请参考文章(待定)。

2.5 配置assemble.xml文件

assemble.xml文件中描述了具体如何打包,该打包过程和实际需求关系密切



    ${project.version}
    
        tar.gz
    
    true
    
        
            true
            
                xxx.xx.x:base1
                xxx.xx.x:base2
                xxx.xx.x:base3
                xxx.xx.x:base4
            
            
                lib
                false
            
        
    
    
        
            src/main/resources/bin
            bin
        
        
            src/main/resources/conf
            conf
        
        
            src/main/resources/docs
            docs
        
        src/main/resources/keys
        keys
    
        
            
                README.md
            
            
        
    
    
        
            false
            true
            lib
            provided
        
        
            false
            true
            lib
            system
        
        
            false
            true
            lib
            runtime
        
    

具体的配置参数可以查看 https://maven.apache.org/plugins/maven-assembly-plugin/assembly.html

本人在实验过程中重点是处理了dependencySet这个配置:


        
            false
            true
            lib
            provided
        
        
            false
            true
            lib
            system
        
        
            false
            true
            lib
            runtime
        
    

请配置上上述三个部分,要不然总是会缺少一些依赖包打不进来,Mark一下,很重要!

使用maven-assembly-plugin插件来定制化打包

简单的说,maven-assembly-plugin 就是用来帮助打包用的,比如说打出一个什么类型的包,包里包括哪些内容等等。

目前至少支持以下打包类型:

  • zip
  • tar
  • tar.gz
  • tar.bz2
  • jar
  • dir
  • war

默认情况下,打jar包时,只有在类路径上的文件资源会被打包到jar中,并且文件名是${artifactId}-${version}.jar,下面看看怎么用maven-assembly-plugin插件来定制化打包。

首先需要添加插件声明:


    org.apache.maven.plugins
    maven-assembly-plugin
    2.4
    
        
            
            package
            
                
                single
            
        
    

使用内置的Assembly Descriptor

要使用maven-assembly-plugin,需要指定至少一个要使用的assembly descriptor 文件。默认情况下,maven-assembly-plugin内置了几个可以用的assembly descriptor:

  • bin : 类似于默认打包,会将bin目录下的文件打到包中;
  • jar-with-dependencies : 会将所有依赖都解压打包到生成物中;
  • src :只将源码目录下的文件打包;
  • project : 将整个project资源打包。

要查看它们的详细定义,可以到maven-assembly-plugin-2.4.jar里去看,例如对应 bin 的assembly descriptor 如下:


    bin
    
        tar.gz
        tar.bz2
        zip
    
    
        
            ${project.basedir}
            /
            
                README*
                LICENSE*
                NOTICE*
            
        
        
            ${project.build.directory}
            /
            
                *.jar
            
        
        
            ${project.build.directory}/site
            docs
        
    

自定义Assembly Descriptor

一般来说,内置的assembly descriptor都不满足需求,这个时候就需要写自己的assembly descriptor的实现了。先从一个最简单的定义开始:



    demo
    
        jar
    
    false
    
        
            ${project.build.directory}/classes
            /
        
    

这个定义很简单:

  • format:指定打包类型;
  • includeBaseDirectory:指定是否包含打包层目录(比如finalName是output,当值为true,所有文件被放在output目录下,否则直接放在包的根目录下);
  • fileSets:指定要包含的文件集,可以定义多个fileSet;
  • directory:指定要包含的目录;
  • outputDirectory:指定当前要包含的目录的目的地。

要使用这个assembly descriptor,需要如下配置:

  
    demo  
    
        
        assemblies/demo.xml  
      
    output
 

最后会生成一个demo-demo.jar 文件在目录 output 下,其中前一个demo来自finalName,后一个demo来自assembly descriptor中的id,其中的内容和默认的打包出来的jar类似。

如果只想有finalName,则增加配置:

false  

添加文件

上面演示了添加所有编译后的资源,同样的可以增加其他资源,例如想添加当前工程目录下的某个文件 b.txt ,在assembly descriptor的assembly结点下增加


    
        b.txt
        /
    

这里用到了 files 元素类型,可以想象 fileSets 下的结点都是针对文件夹的;files 下的结点都是针对文件的。

也可以改变打包后的文件名,例如上面的 b.txt ,希望打包后的名字为 b.txt.bak, 只需要在file 里添加以下配置 :

b.txt.bak

排除文件

在 fileSet 里可以使用 includes 和 excludes 来更精确的控制哪些文件要添加,哪些文件要排除。

例如要排除某个目录下所有的txt文件:

  
    ${project.build.directory}/classes  
    /  
      
        **/*.txt  
      

或者某个目录下只想 .class 文件:


    ${project.build.directory}/classes
    /
    
        **/*.class
    

添加依赖

如果想把一些依赖库打到包里,可以用 dependencySets 元素,例如最简单的,把当前工程的所有依赖都添加到包里:


    
        /
    

在assembly下添加以上配置,则当前工程的依赖和工程本身生成的jar都会被打包进来。

如果要排除工程自身生成的jar,则可以添加

false

unpack参数可以控制依赖包是否在打包进来时是否解开,例如解开所有包,添加以下配置:

true

和 fileSet 一样,可以使用 excludes 和 includes 来更详细的控制哪些依赖需要打包进来;另外 useProjectAttachments,useTransitiveDependencies,useTransitiveFiltering等参数可以对间接依赖、传递依赖进行控制。

其他选项

  • moduleSets:当有子模块时候用;
  • repositories:想包含库的时候用;
  • containerDescriptorHandlers:可以进行一些合并,定义ArtifactHandler之类的时候可以用,(可以参考:说明);
  • componentDescriptors:如上所述,可以包含一些componentDescriptor定义,这些定义可以被多个assembly共享。

Assembly Plugin更多配置

上面已经看到了一些Assembly Plugin本身的配置,例如 finalName, outputDirectory, appendAssemblyId 和 descriptors 等,除了这些还有其他的一些可配置参数,参见:single,其中某些参数会覆盖在assembly descriptor 中的参数。有一个比较有用的参数是: archive,它的详细配置在:archive。

下面介绍一些archive的用法。

指定Main-Class

archive的一个重要用处就是配置生成的MANIFEST.MF文件。默认会生成一个MANIFEST.MF文件,不过这个文件默认值没什么意义。如果想指定生成jar的Main-Class,可以如下配置:

  
      
        demo.DemoMain  
      

下面来看一个项目中实际配置的文件:

pom文件:

                                                                
    org.apache.maven.plugins                         
    maven-assembly-plugin                      
    ${maven-assembly-plugin.version}                                          
                                                         
                                                           
            package.xml                        
                                                          
                                                        
                                                            
                                                             
            make-assembly                                      
            package                                      
                                                                 
                single                                     
                                                                
                                                            
                                                           
  

assembly descriptor 文件:


    ${assembly-id}
    
    
        ${assembly-format}
    
    
        
        
            ${project.basedir}/src/main/resources/base
            WEB-INF/classes
        
        
        
            ${project.basedir}/src/main/resources/${env}
            WEB-INF/classes
        
        
        
            ${project.build.directory}
            WEB-INF/lib
            
                *.jar
            
        
        
        
            ${project.build.directory}
            /
            
                WEB-INF/lib/*.jar
            
        
    

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

你可能感兴趣的:(使用maven-assembly-plugin如何打包多模块项目)