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

Maven 的 pom.xml 常用 变量 插件 配置 详解

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

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>