关于Maven dependency中外部jar包依赖的问题

在maven项目中，我们的项目依赖一般取自local的repository或者远程的repository，比如下面这个配置：

<dependency><groupId>commons-cli</groupId><artifactId>commons-cli</artifactId><version>1.2</version></dependency>

一般而言，maven会先去本地的repository寻找，如果找不到，就会依据<repository>的定义，去远程的repository去找依赖。

不过有时候，我们依赖的jar并不在任何repository中，可能就是从同事那里拷贝来的一个孤独的jar文件。怎么办？

Maven有办法处理这种情况，它支持systemscope的定义方式，可以加载本地任意路径下的jar包，定义如下：

<dependency><groupId> commons-cli </groupId><artifactId> commons-cli </artifactId><version>1.0.0</version> <scope>system</scope><systemPath>${basedir}/libs/commons-cli.jar</systemPath></dependency>

这样，把想要加载的jar包：commons-cli.jar放到工程的libs/目录下，在java code中就可以引用这个jar包中的class了。

往往在项目开发中，我们需要把整个项目加上依赖，打成一个jar包，这样放到任何地方都可以独立运行，不依赖于任何其他jar包，非常方便。

这个时候，我们会发现，对于<scope>system</scope>，maven不会把这个jar包的内容打包到最后的jar-with-dependencies.jar中，怎么办？

后来在网上找到一个有趣的办法：既然maven可以把repository中的依赖打到最后的jar包中，那么把这个外部的jar包放到repository中，也就可以让maven把这个外部的jar包打到最后的jar包中。

Maven支持安装jar包到本地的repository，所以这个方法是可行的，具体pom配置如下：

<plugin>    <groupId>org.apache.maven.plugins</groupId>    <artifactId>maven-install-plugin</artifactId>    <executions>        <execution>            <id>install-external</id>            <phase>clean</phase>            <configuration>                <file>${basedir}/libs/commons-cli.jar</file>                <repositoryLayout>default</repositoryLayout>                <groupId>commons-cli</groupId>                <artifactId>commons-cli</artifactId>                <version>1.0.0</version>                <packaging>jar</packaging>                <generatePom>true</generatePom>            </configuration>            <goals>                <goal>install-file</goal>            </goals>        </execution>    </executions></plugin>

这样：Mvn clean就会安装这个jar包，然后在mvn package就可以打出带有这个jar包的big jar包。

安装jar包的过程之所以在clean phase阶段，是因为maven需要项目的所有依赖都得到解决，之后才开始执行。

我试了试，果然work，非常好使。

 

参考：

http://eureka.ykyuen.info/2014/06/10/maven-include-system-scope-dependency-in-maven-assembly-plugin/