maven-assembly-plugin插件的使用方法

一. Assembly 是什么意思？

二. maven-assembly-plugin是什么？

它是maven中针对打包任务而提供的标准插件。

 

三. maven-assembly-plugin插件的作用？

　　摘自官网：http://maven.apache.org/plugins/maven-assembly-plugin/

　　英文原文：The Assembly Plugin for Maven is primarily intended to allow users to aggregate the project output along with its dependencies, 

　　                  modules, site documentation, and other files into a single distributable archive.

　　中文翻译：Assembly 插件的主要作用是，允许用户将项目输出与它的依赖项、模块、站点文档、和其他文件一起组装成一个可分发的归档文件。

　　　　　　　（翻译不一定准确，以英文为准）

 

四.maven-assembly-plugin插件在maven项目中如何使用（即使用步骤）？

　　1.  需要指定一个Assembly描述符文件。该文件指定了打包格式，包含的文件/过滤的文件等信息，可以同时指定多个描述符文件，打包成不同的格式。

　　2.  在Maven工程的pom.xml文件里配置maven-assembly-plugin插件，引入Assembly描述符文件。

 

五. maven项目中Assembly描述符文件详解

　　示例： 

xml version="1.0" encoding="utf-8"?>
<assembly
    xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2 http://maven.apache.org/xsd/assembly-1.1.2.xsd">
    
    
    <id>${project.version}id>
    
    
    <formats>
        <format>jarformat>
    formats>
    
    
    <includeBaseDirectory>trueincludeBaseDirectory>
    
    
    <dependencySets>
        <dependencySet>
            <useProjectArtifact>trueuseProjectArtifact> 
            <outputDirectory>liboutputDirectory> 
            <scope>runtimescope> 
        dependencySet>
    dependencySets>
    
    
    <fileSets>
        <fileSet>
            <directory>src/main/script/linux/bindirectory> 
            <outputDirectory>binoutputDirectory> 
            <includes>
                <include>terminal-dispatchinclude> 
                <include>serverinclude>
            includes>
            <fileMode>0755fileMode> 
        fileSet>        
        <fileSet>
            <directory>src/main/resourcesdirectory>
            <outputDirectory>confoutputDirectory>
            <includes>
                <include>config.propertiesinclude>
                <include>logback.xmlinclude>
            includes>
            <fileMode>0644fileMode>
        fileSet>
        <fileSet>
            <directory>src/main/script/confdirectory>
            <outputDirectory>confoutputDirectory>
            <includes>
                <include>wrapper.confinclude>
            includes>
            <fileMode>0644fileMode>
        fileSet>
        <fileSet>
            <directory>src/main/script/linux/libdirectory>
            <outputDirectory>liboutputDirectory>
            <includes>
                <include>libwrapper.soinclude>
                <include>wrapper.jarinclude>
            includes>
            <fileMode>0755fileMode>
        fileSet>
    fileSets>
    
assembly>

 

　　1.  true标签作用？

 　　　　指定打的包是否包含打包层目录，比如finalName是terminal-dispatch，当值为true，所有文件被放在包内的terminal-dispatch目录下，否则直接放在包的根目录下，

　　如下图所示：

　　2. 0755标签作用？

　　　　设置文件的unix属性，好像是一种读写权限的设定，linux的内容，我没有深究，不是特别懂，暂时不多说。 

序号	取值	意义
1	compile	缺省值，适用于所有阶段，会随着项目一起发布
2	provided	类似compile，期望JDK、容器或使用者会提供这个依赖。如servlet.jar
3	runtime	只在运行时使用，如JDBC驱动，适用运行和测试阶段
4	test	只在测试时使用，用于编译和运行测试代码。不会随项目发布
5	system	类似provided，需要显式提供包含依赖的jar，Maven不会在Repository中查找它

 

六. maven中的pom.xml配置(引入assembly描述符文件)

<build>
    <plugins>
       <plugin>
       　　<groupId>org.apache.maven.pluginsgroupId>
　　　　　　<artifactId>maven-assembly-pluginartifactId>
　　　　　　<version>2.4version>
　　　　　　　　<executions>
　　　　　　　　　　<execution> 
　　　　　　　　　　　　<id>make-zipid> 
　　　　　　　　　　　　<phase>packagephase> 
　　　　　　　　　　　　<goals>
　　　　　　　　　　　　　　<goal>singlegoal> 
　　　　　　　　　　　　goals>
　　　　　　　　　　　　<configuration>
　　　　　　　　　　　　　　<descriptors
　　　　　　　　　　　　　　　　<descriptor>src/main/script/assembly.xmldescriptor> 
　　　　　　　　　　　　　　descriptors>
　　　　　　　　　　configuration>
　　　　　　　　execution>
　　　　　　executions>
　　　　plugin>
    <plugins>
build>