用dependency插件解决依赖包冲突

tunzao bio photo By tunzao Comment

偶然翻阅了下 maven dependency 插件的官方文档,颇有收获,记录一下。可能有些标题党的嫌疑,并没有具体介绍怎么解决依赖冲突问题,不过既然你都打印出了依赖树,冲突关系已然在树中显示的清清楚楚了。

##依赖树 dependency:tree 大概是用的最多的功能,用来排查依赖冲突,没有指定任何参数执行时打印是所有依赖信息,信息量略大,可以通过includes参数指定想看哪些依赖,也可以通过excludes参数指定不想看的。includesexcludes可以配合使用。举个例子吧:

# 只想看依赖树中包含 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 可以分析出声明的依赖中哪些未被使用,未被声明的包中哪些被依赖了,试了下好像并不是很好使。

参考:

Apache Maven Dependency Plugin

comments powered by Disqus