偶然翻阅了下 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 可以分析出声明的依赖中哪些未被使用,未被声明的包中哪些被依赖了,试了下好像并不是很好使。