maven-assembly-plugin使用的心得

普通的maven打包是打包成jar或者war包。如果想打包成zip、tar.gz等格式的时候，就要使用maven-assembly这个插件了。最初认识这个插件的时候，觉得它和resource插件差不多。确实有相似的地方，resource控制的是项目生成到target目录的情况。而assembly这个插件可以控制各阶段怎么打包，可以在maven生成target之后，控制把什么东西打包进assembly最终生成的包中，甚至可以把target中生成的jar也打包进去。废话不多说了，首先看怎么用：
1、首先把<build>中<plugins>标签内添加assembly插件：

<build>
 ……
 <plugins>
  ……
  <plugin>
   <groupId>org.apache.maven.plugins</groupId>
   <artifactId>maven-assembly-plugin</artifactId>
   <version>2.4</version>
   <configuration>
    <encoding>UTF-8</encoding>
    <descriptors>
     <descriptor>src/main/assembly/package.xml</descriptor>
    </descriptors>
    <outputDirectory>c:\\</outputDirectory>
   </configuration>
   <executions>
    <execution>
     <id>make-assembly</id>
     <phase>package</phase>
     <goals>
      <goal>single</goal>
     </goals>
    </execution>
   </executions>
  </plugin>
 </plugins>
</build>

这是我项目中的一个例子。<descriptor>标签里的文件后面详细讲讲，主要是配置assembly打包相关目录、文件、依赖包等等的路径及对应输出的问题。<outputDirectory>标签表示打包生成的文件输出路径。我把它放在c盘主要是为了方便点，各位可以按需放置。<execution>标签中的<id>名字可以随便起，但是后面<descriptor>的文件里的<id>要和这里的id对应。

2、配置<descriptor>对应的文件：

<?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>make-assembly</id>
 <formats>
  <format>zip</format>
 </formats>
 <includeBaseDirectory>true</includeBaseDirectory>
 <fileSets>
  <fileSet>
   <directory>${project.build.directory}/classes</directory>
   <outputDirectory>/class</outputDirectory> 
  </fileSet>
  <fileSet>
   <directory>src/main/resources</directory>
   <outputDirectory>/conf</outputDirectory>
  </fileSet>
  <fileSet>
   <directory>src/webapp</directory>
   <outputDirectory>src/webapp</outputDirectory>
  </fileSet>
  <fileSet>
            <directory>bin</directory>
            <outputDirectory>/bin</outputDirectory>
        </fileSet>
 </fileSets>
 <dependencySets>
  <dependencySet>
   <outputDirectory>lib</outputDirectory>
   <scope>runtime</scope>
  </dependencySet>
 </dependencySets>
</assembly>

这里的<id>就是和前面<execution>里的<id>对应的。<includeBaseDirectory>这个表示最终打包文件最外层是否要加一个包装的目录，读者可以试试改成false就体会到区别了。<fileSet>就是要把什么文件打包到什么目录下，例如我这里就把target中的classes全部打包到最终的/class目录下，把resources目录里的打包进conf里面。<dependencySets>则会把相关的依赖包进行打包。

这篇文章只是举一个简单的速成例子。maven-assembly还有很多细节的控制，例如可以有多个xml配置，也可以不配置xml直接使用简单几种配置方式，还可以控制打包哪些文件，排除哪些文件等等，这些请读者自行百度，我就没必要再搬运过来了。