Maven 项目添加本地jar包的三种方式
翻译自
[TOC]
简介
在构建 Maven 项目时，有时候需要导入本地的jar包，本文介绍了三种添加本地jar包的方法。
- 手动添加jar包到本地仓库
- 添加为 system scope 依赖
- 创建一个不同的本地仓库
- 使用 Nexus 仓库管理器
1. 手动添加jar包到本地仓库
第一种解决方法是通过 Maven goal install:install-file 命令将jar包安装到本地仓库。该插件的使用方法很简单，如下所示：
mvn install:install-file -Dfile=<path-to-file>
注意：我们没有定义依赖包的 groupId、articleId、version、packaging 这些属性。其实，从 Maven-install-plugin 插件2.5版本开始，这些信息可以从特定的pom文件中获取。
这些属性信息同时也可以添加到命令行中：
mvn install:install-file -Dfile=<path-to-file> -DgroupId=<group-id> -DartifactId=<artifact-id> -Dversion=<version>
其中：
<path-to-file>为 jar 包的文件路径
<group-id>为 jar 包的 GroupId
<artifact-id>为 jar 包的 ArtifactId
<version>为 jar 包的版本号
示例：
mvn install:install-file –Dfile=C:\dev\app.jar -DgroupId=com.roufid.tutorials -DartifactId=example-app -Dversion=1.0
同过添加 pom 依赖包的方式，可以将上面的 jar 包引入到 maven 项目中：
com.roufid.tutorials example-app 1.0
这种添加本地依赖包的方式代价非常高。因为它将依赖文件直接添加到了本地 maven 仓库中，如果有一天你切换了本地仓库，那么你必须重新安装一遍 jar 包。同时，也不利于项目的移植和协同开发。
另一种方案是在 pom 文件中使用 maven-install-plugin 插件的方式，这种方式会在 maven initialize 阶段添加相应的 jar 包。为了实现上述效果，你必须定义好需要安装 jar 包的路径。最好的方式是将所需要安装的 jar 包放置在项目根路径的某个文件夹内（和 pom.xml 同级目录中）。
我们假设 jar 包存放位置为 <PROJECT_ROOT_FOLDER>/lib/app.jar。以下是 maven-install-plugin 的配置：
org.apache.maven.plugins maven-install-plugin 2.5 initialize install-file com.roufid.tutorials example-app 1.0 jar ${basedir}/lib/app.jar
${basedir}指的是 pom.xml 所在的根路径。
在添加上述代码的时候，你可能会遇到一个错误（没遇到>_<），那么添加下面的配置来允许 maven 生命周期的映射关系：
org.eclipse.m2e lifecycle-mapping 1.0.0 org.codehaus.mojo aspectj-maven-plugin [1.0,) test-compile compile org.apache.maven.plugins maven-install-plugin [2.5,) install-file false
2. 直接将依赖包添加为 system 范围
这种方案（不是特别好方案）通过添加 system scope 并指向 jar 包的全路径。假如 jar 包的路径为 <PROJECT_ROOT_FOLDER>/lib , 那么它的配置如下所示：
com.roufid.tutorials example-app 1.0 system ${basedir}/lib/yourJar.jar
${basedir}指的是 pom.xml 所在的根路径。
3. 创建一个不同的本地仓库
第三种方案和第一种方案相似，不同在于 jar 包安装的仓库位置。假如我们有一个本地仓库，名称为 maven-repository,位置在 ${basedir}(pom.xml所在的根路径)。第一步要做的就是将 jar 包部署到本地仓库，如下所示：
mvn deploy:deploy-file -Dfile=<path-to-file> -DgroupId=<group-id> -DartifactId=<artifact-id> -Dversion=<version> -Dpackaging=jar -Durl=file:./maven-repository/ -DrepositoryId=maven-repository -DupdateReleaseInfo=true
通常 Maven 命令 deploy:deploy-file 会将 artificial 安装在远端仓库中，但是在本例子中仓库地址在本地。 添加完 jar 包后需要在对应的 pom 文件添加对应的仓库：
maven-repository file:///${project.basedir}/maven-repository
然后添加对应的依赖：
com.roufid.tutorials example-app 1.0
4. 使用Nexus仓库管理工具
最好的方式当然是建立自己的私有云仓库了，怎么安装?