你是否想要創建一個包含腳本、配置文件以及所有運行時所依賴的元素（jar）Assembly插件能幫你構建一個完整的發布包。

Assembly插件會生成 “assemblies”， 此特性等同於的Maven 1 distribution plug-in.。該插件不僅支持創建二進制歸檔文件，也支持創建源碼歸檔文件。這些assemblies定義在一個assembly描述符文件裏。你可以選擇自定義assembly描述符或者直接使用插件自帶的三個預定義描述符中的任何一個.

目前Assembly插件支持如下格式的歸檔文件:

• zip
• tar.gz
• tar.bz2
• jar
• dir
• war
• and any other format that the ArchiveManager has been configured for

Maven 2上使用assembly的簡單步驟:

• 從預定義描述符裏選擇一個或者自己編寫一個assembly描述符號。
• 工程的pom.xml裏配置Assembly插件。
• 在工程根目錄下運行”mvn assembly:assembly”命令 。

如何自定義assembly描述符，詳見Assembly Descriptor Format.

什麽是Assembly?

“assembly”是把一組文件、目錄、依賴元素組裝成一個歸檔文件. 比如, 假設一個 Maven project定義了一個JAR artifact，它包含控制臺應用程序和Swing應用程序 。這樣一個工程可以定義兩套包含描述符，一套給給控制臺應用，另一套給Swing應用程序，它們包含各自的腳本、目錄和依賴。

Assembly Plugin的描述符可以定義任何一個文件或者目錄歸檔方式。舉個例子，如果的你的Maven 2工程包含”src/main/bin”這個目錄，你可以指示Assembly插件復制“src/main/bin”目錄下所有的文件到bin目錄裏（歸檔文件裏的目錄），並且可以修改它們的權限屬性（UNIX mode）。見 assembly descriptor.

The Maven Assembly Plugin

Maven 2.0的Assembly插件目的是提供一個把工程依賴元素、模塊、網站文檔等其他文件存放到單個歸檔文件裏。

使用任何一個預定義的描述符你可以輕松的構建一個發布包。這些描述符能處理一些常用的操作,如：把依賴的元素的歸檔到一個jar文件. 當然, 你可以自定義描述符來更靈活的控制依賴，模塊，文件的歸檔方式。

maven-assembly-plugin : 是maven中針對打包任務而提供的標準插件

(1)、在pom.xml 文件裏面的配置說明

<plugin>  
    <artifactId>maven-assembly-plugin</artifactId>  
    <executions>  <!--執行器 mvn assembly:assembly-->  
        <execution>  
            <id>make-zip</id><!--名字任意 -->    
        <phase>package</phase><!-- 綁定到package生命周期階段上 -->    
        <goals>    
           <goal>single</goal><!-- 只運行一次 -->    
        </goals>    
            <configuration>  
                     <descriptors> <!--描述文件路徑-->  
                          <descriptor>src/main/resources/zip.xml</descriptor>  
                    </descriptors>  
            </configuration>  
        </execution>  
    </executions>  
 </plugin>  

(2)、zip.xml 文件配置如下

<assembly  
    xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0"  
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0 http://maven.apache.org/xsd/assembly-1.1.0.xsd">  
    <id>release</id>  
    <formats>  
        <format>zip</format>  
    </formats>  
    <fileSets>  
        <fileSet>  
            <directory>${project.basedir}\src\main\config</directory>  
            <!-- 過濾 -->  
            <excludes>  
                <exclude>*.xml</exclude>  
            </excludes>  
            <outputDirectory>\</outputDirectory>  
        </fileSet>  
    </fileSets>  
      
    <dependencySets>  
        <dependencySet>  
            <useProjectArtifact>true</useProjectArtifact>  
            <outputDirectory>lib</outputDirectory><!-- 將scope為runtime的依賴包打包到lib目錄下。 -->  
            <scope>runtime</scope>  
        </dependencySet>  
    </dependencySets>  
</assembly>  

(3)、zip.xml 格式屬性說明

打包的文件格式
可以有：tar.zip war zip
<formats>
<format>zip</format>
</formats>

需要打包的路徑
<directory>${project.basedir}</directory>

打包後輸出的路徑
<outputDirectory>/</outputDirectory>

打包需要包含的文件

<excludes>
<exclude>junit:junit</exclude>
<exclude>commons-lang:commons-lang</exclude>
<exclude>commons-logging:commons-logging</exclude>
</excludes>

當前項目構件是否包含在這個依賴集合裏。

<useProjectArtifact>true</useProjectArtifact>

依賴包打包到目錄下
<dependencySets>
<dependencySet>
<outputDirectory>lib</outputDirectory><!-- 將scope為runtime的依賴包打包到lib目錄下。 -->
<useProjectArtifact>true</useProjectArtifact>
<scope>runtime</scope>
</dependencySet>
</dependencySets>

Maven Assembly插件介