Maven 变量及常见插件配置详解

- 一、变量 - 自定义变量及内置变量
  - 1. 自定义变量
  - 2. 内置变量
- 二、常见插件配置

一、变量 - 自定义变量及内置变量

1. 自定义变量

<properties>
    <project.build.name>tools</project.build.name>
    <project.build.sourceencoding>UTF-8</project.build.sourceencoding>
</properties>

2. 内置变量

${basedir} 项目根目录    
${project.build.directory} 构建目录，缺省为target    
${project.build.outputDirectory} 构建过程输出目录，缺省为target/classes    
${project.build.finalName} 产出物名称，缺省为${project.artifactId}-${project.version}    
${project.packaging} 打包类型，缺省为jar    
${project.xxx} 当前pom文件的任意节点的内容

二、常见插件配置

1. 编译插件

<plugin>
    <groupid>org.apache.maven.plugins</groupid>
    <artifactid>maven-compiler-plugin</artifactid>
    <configuration>
        <source>1.6</source>
        <target>1.6</target>
        <encoding>${project.build.sourceEncoding}</encoding>
    </configuration>
</plugin>

source：源代码编译版本
target：目标平台编译版本
encoding：字符集编码

2. 设置资源文件的编码方式

<plugin>
    <groupid>org.apache.maven.plugins</groupid>
    <artifactid>maven-resources-plugin</artifactid>
    <version>2.4.3</version>
    <executions>
        <execution>
            <phase>compile</phase>
        </execution>
    </executions>
    <configuration>
        <encoding>${project.build.sourceEncoding}</encoding>
    </configuration>
</plugin>

xml、properties 文件都是资源文件，编码的时候遇到中文总要进行转码！用什么编码？UTF-8，那就记得强制 <encoding>${project.build.sourceEncoding}</encoding>

3. 自动拷贝 jar 包到 target 目录

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <version>2.6</version>
    <executions>
        <execution>
            <id>copy-dependencies</id>
            <phase>compile</phase>
            <goals>
                <goal>copy-dependencies</goal>
            </goals>
            <configuration>
                <!-- ${project.build.directory}为Maven内置变量，缺省为target -->
                <outputDirectory>${project.build.directory}/lib</outputDirectory><!-- 表示是否不包含间接依赖的包 -->
                <excludeTransitive>false</excludeTransitive><!-- 表示复制的jar文件去掉版本信息 -->
                <stripVersion>true</stripVersion>
            </configuration>
        </execution>
    </executions>
</plugin>

关于 maven-dependency-plugin：用得最多的几个操作： copy , copy-dependencies 和它们对应的 unpack , unpack-dependencies

描述：copy 和 unpack 操作是由要拷某个包，这个包需要具体指定要拷哪个包，与当前工程的依赖没有关系。这两者区别 - 是否解压

copy-dependencies 和 unpack-dependencies ，但是它是用来拷当前工程的依赖包的。这两者区别 - 是否解压

参考链接：http://liugang594.iteye.com/blog/2093082

4. 生成源代码 jar 包

<plugin>
    <artifactId>maven-source-plugin</artifactId>
    <version>2.1</version>
    <configuration>
        <!-- <finalName>${project.build.name}</finalName> -->
        <attach>true</attach>
        <encoding>${project.build.sourceEncoding}</encoding>
    </configuration>
    <executions>
        <execution>
            <phase>compile</phase>
            <goals>
                <goal>jar</goal>
            </goals>
        </execution>
    </executions>
</plugin>

5. 将项目打成 jar 包

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <version>2.4</version>
    <configuration>
        <archive>
            <manifest>
                <!-- 告知 maven-jar-plugin添加一个 Class-Path元素到 MANIFEST.MF文件，以及在Class-Path元素中包括所有依赖项 -->
                <addClasspath>true</addClasspath><!-- 所有的依赖项应该位于 lib文件夹 -->
                <classpathPrefix>lib/</classpathPrefix><!-- 当用户使用 lib命令执行JAR文件时，使用该元素定义将要执行的类名 -->
                <mainClass>com.zhengtian.tools.service.phone.MobilePhoneTool</mainClass>
            </manifest>
        </archive>
    </configuration>
</plugin>

在将项目打成 jar 包时，有时会需要将项目打成可以直接运行的 jar 包，因此就需要将项目依赖的 jar 包也打入 jar 包中，此时需要在 Eclipse 上安装例外一个插件，用来打可执行 jar 包，详情见链接 http://zheng12tian.iteye.com/blog/1765626

更多 maven 配置详见：https://my.oschina.net/zh119893/blog/276090

关于 maven-assembly-plugin 的使用

“assembly” 是把一组文件、目录、依赖元素组装成一个归档文件

参考链接：http://blog.csdn.net/WANGYAN9110/article/details/38646677

pom 中配置

<plugin>
    <artifactId>maven-assembly-plugin</artifactId>
    <version>2.4.1</version>
    <executions>
        <execution>
            <id>make-zip</id><!-- 绑定到package生命周期阶段上 -->
            <phase>package</phase>
            <goals>
                <!-- 绑定到package生命周期阶段上 -->
                <goal>single</goal>
            </goals>
            <configuration>
                <descriptors>
                    <!--描述文件路径-->
                    <descriptor>src/assembly/assembly.xml</descriptor>
                </descriptors>
            </configuration>
        </execution>
    </executions>
</plugin>

assembly.xml 配置

<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>distribution</id>
    <formats>
        <format>zip</format>
    </formats>
    <fileSets>
        <fileSet>
            <directory>${project.basedir}\src\main\resources</directory>
            <outputDirectory>\</outputDirectory>
        </fileSet>
        <fileSet>
            <directory>${project.basedir}\src\bin</directory>
            <outputDirectory>\bin</outputDirectory>
        </fileSet>
    </fileSets>
    <dependencySets>
        <dependencySet>
            <useProjectArtifact>true</useProjectArtifact>
            <outputDirectory>lib</outputDirectory><!-- 将scope为runtime的依赖包打包到lib目录下。 -->
            <scope>runtime</scope>
        </dependencySet>
    </dependencySets>
</assembly>