偶然翻阅了下 maven dependency 插件的官方文档,颇有收获,记录一下。可能有些标题党的嫌疑,并没有具体介绍怎么解决依赖冲突问题,不过既然你都打印出了依赖树,冲突关系已然在树中显示的清清楚楚了。
依赖树
dependency:tree
大概是用的最多的功能,用来排查依赖冲突,没有指定任何参数执行时打印是所有依赖信息,信息量略大,可以通过includes
参数指定想看哪些依赖,也可以通过excludes
参数指定不想看的。includes
和excludes
可以配合使用。举个例子吧:
# 只想看依赖树中包含 groupId 为 javax.serlet 的枝干
mvn dependency:tree -Dincludes=javax.servlet
# 不想看依赖树中包含 groupId 为 javax.serlet 的枝干
mvn dependency:tree -Dexcludes=javax.servlet
参数的格式(pattern)定义如下:
[groupId]:[artifactId]:[type]:[version]
每个部分(冒号分割的部分)是支持*
通配符的,如果要指定多个格式则可以用,
分割,如:
mvn dependency:tree -Dincludes=javax.servlet,org.apache.*
默认情况下 dependency:tree
打印出来的是 maven
解决了冲突后的树(解决冲突的策略是:就近原则,即离根近的依赖被采纳),通过指定 -Dverbose
参数则可以显示原始的依赖树,让你显式地看出某个包都在哪些枝干上出现了。
清空被本地仓库(purge-local-repository)
有时候打包时会遇到一些莫名其妙的问题,百思不得其解,但是清空本地仓库后问题就解决了(就像重启电脑一般神奇)。之前都是去本地私服目录把某个groupId对应的jar包都删了或者
把所有的都给删了,难免删了一些无辜的依赖,dependency
插件提供了一个goal可以方便的删除本地目录下该项目依赖的jar包:
mvn dependency:purge-local-repository
复制依赖或某些jar包到指定目录
使用 dependency 的 copy-depenecis goal 把依赖的jar复制到指定目录前,在pom文件配置如下:
<project>
[...]
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<version>2.10</version>
<executions>
<execution>
<id>copy-dependencies</id>
<phase>package</phase>
<goals>
<goal>copy-dependencies</goal>
</goals>
<configuration>
<outputDirectory>/path/to/dest</outputDirectory>
<overWriteReleases>false</overWriteReleases>
<overWriteSnapshots>false</overWriteSnapshots>
<overWriteIfNewer>true</overWriteIfNewer>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
[...]
</project>
更多参数信息参见dependency:copy-dependencies
如果只想复制极少的几个jar包到指定目录的话可以使用 copy
goal:
<project>
[...]
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<version>2.10</version>
<executions>
<execution>
<id>copy</id>
<phase>package</phase>
<goals>
<goal>copy</goal>
</goals>
<configuration>
<artifactItems>
<artifactItem>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
</artifactItem>
</artifactItems>
<outputDirectory>/path/to</outputDirectory>
<overWriteReleases>false</overWriteReleases>
<overWriteSnapshots>true</overWriteSnapshots>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
[...]
</project>
据说analyze
goal 可以分析出声明的依赖中哪些未被使用,未被声明的包中哪些被依赖了,试了下好像并不是很好使。