Maven构建的可重现性
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.juvenxu</groupId>
<artifactId>test</artifactId>
<version>1.0-SNAPSHOT</version>
<url>http://www.juvenxu.com</url>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
[WARNING] Some problems were encountered while building the effective model for
com.juvenxu:test:jar:1.0-SNAPSHOT
[WARNING] 'build.plugins.plugin.version' for org.apache.maven.plugins:maven-javadoc-plugin
is missing. @
[WARNING]
[WARNING] It is highly recommended to fix these problems because they threaten the stability
of your build.
[WARNING]
[WARNING] For this reason, future Maven versions might no longer support building
such malformed projects.
大致意思就是警告你说,maven-javadoc-plugin没有声明版本,这种配置会威胁你项目构建的稳定性,请修复该问题。
然而,如果你在使用Maven 2,那么你就不会看到这样的警告信息。因此这里实际上涉及到了一个Maven 3 对Maven 2 的改进。对于未声明版本的插件,Maven 2 会自动解析所有仓库中的最新版本(包括SNAPSHOT),Maven 3 会自动解析所有仓库中的最新RELEASE版本,同时给用户发出警告。Maven 3 这么做是为了帮助用户提高构建的可重现性。
有不少的Maven 2用户抱怨Maven插件系统的不稳定,一个项目,同样的源码,同样的POM,昨天构建还是成功的,今天就莫名其妙的失败了,这是怎么回事呢?这其中的原因往往就是因为他们使用某些插件的时候没有声明插件版本,这时可能发生的情况是:昨天Maven解析到插件X的最新版本为1.2.0,该版本与项目兼容得很好;可是今天Maven解析到X的最新版本为1.3.0-SNAPSHOT,由于是快照版且与1.2.0版本差异很大,该版本的插件就与项目出现了兼容性问题,导致了构建失败。
Maven 3 的一个改进地方在于,它在自动解析插件版本的时候,会无视 SNAPSHOT,也就是说,昨天的1.2.0版本今天不可能变成1.3.0-SNAPSHOT,只可能成为1.2.1这样的RELEASE版本,避开快照版本就意味着避开了很大程度的不稳定性。此外,Maven 3还给出警告,推荐用户声明插件的版本,为什么呢?
我们都知道 ,Maven 的行为是由插件决定的,可重现性就意味着基于同样的源码,同样的POM,Maven 的行为不应该发生变化。不幸的是,Maven 的插件版本自动解析机制在方便用户的同时也可能在不同的时间引入不同版本的插件,从而导致 Maven 构建行为的微妙差异,而这种差异是隐式地引入的,因此当出现问题时很难发现根源因素。所以 Maven 3要给出警告,Maven 用户在使用插件的时候应该一直显式地声明插件版本。
需要补充的一点是,Maven 在超级POM中为一些核心的插件声明了版本,如 maven-compiler-plugin,maven-surefire-plugin 等都在其列,因此在使用这些插件的时候你就不再需要担心版本不确定的问题。
基于可重现性原则,我们可以得到以下几条使用 Maven 的最佳实践:
- 使用插件的使用显式声明版本。原因已在本文论述。
- 配置依赖的时候显式声明版本。如果依赖声明没有版本,Maven也会自动去解析,但不能保证版本的稳定性,而依赖版本的变化也可能导致构建失败。
- 除项目内部依赖外,不要依赖其它 SNAPSHOT。项目外部的 SNAPSHOT 依赖随时可能发生变化,且不受你控制,因此不应该使用。
发现你 Maven 项目的潜在问题了么?现在就动手修复吧。
说了这么多就是加上版本呗:
- <plugins>
-
<plugin> -
<artifactId>maven-compiler-plugin</artifactId> -
<version>2.3.2</version> -
<configuration> -
<source>1.6</source> -
<target>1.6</target> -
<encoding>UTF-8</encoding> -
</configuration> -
</plugin> -
</plugins>