1.问题与选择

Maven是一种非常通用的工具，其可用的公共存储库首屈一指。 但是，总会有一个不在任何地方托管的工件，或者托管该工件的存储库有依赖的风险，因为当您需要它时，它可能不会启动。 发生这种情况时，有几种选择：

  • 硬着头皮安装完整的版本库管理解决方案， 例如Nexus
  • 尝试将工件上传到更知名的公共存储库之一
  • 使用Maven插件在本地安装工件

Nexus当然是更成熟的解决方案，但也更复杂 。 设置一个实例来运行Nexus，设置Nexus本身，配置和维护它对于使用单个jar这样的简单问题来说可能是过大的。 但是，如果这种情况（托管自定义工件）很常见，那么存储库管理器就很有意义。

将工件直接上传到公共存储库或直接在Maven Central中也是一种很好的解决方案，但通常是一个漫长的解决方案。 另外，该库可能根本没有启用Maven，这使得处理过程变得更加困难，因此，现在就不能使用工件就不是一个现实的解决方案。 剩下的第三个选择是在源代码管理中添加工件，并使用maven插件。在这种情况下， maven-install-plugin可以在构建过程需要它之前在本地安装它 。 到目前为止，这是最简单，最可靠的选项。

2.使用

让我们从将工件安装到本地存储库所需的完整配置开始： 

<plugin>
   <groupId>org.apache.maven.plugins</groupId>
   <artifactId>maven-install-plugin</artifactId>
   <version>2.4</version>
   <configuration>
      <groupId>org.somegroup</groupId>
      <artifactId>someartifact</artifactId>
      <version>1.0</version>
      <packaging>jar</packaging>
      <file>${basedir}/dependencies/someartifact-1.0.jar</file>
      <generatePom>true</generatePom>
   </configuration>
   <executions>
      <execution>
         <id>install-jar-lib</id>
         <goals>
            <goal>install-file</goal>
         </goals>
         <phase>validate</phase>
      </execution>
   </executions>
</plugin>

现在，让我们分解并分析此配置的详细信息。

2.1。 工件信息

工件信息定义为<configuration>元素的一部分。 实际语法与声明依赖项非常相似– groupId ， artifactId和version元素。 配置的下一部分需要定义工件的包装 -指定为jar 。 接下来，我们需要使用Maven中提供的属性提供要安装的实际jar文件的位置 -这可以是绝对文件路径，也可以是相对路径。 在这种情况下， $ {basedir}属性表示项目的根，即pom.xml文件所在的位置。 这意味着someartifact-1.0.jar文件需要放在根目录下的/ dependencies /目录中。 最后，还有一些其他可选详细信息也可以配置。

2.2。 行刑

安装文件目标的执行被绑定到标准Maven 构建生命周期中的验证阶段 。 这样一来，便可以在生命周期的开始就安装工件，而在下一个编译阶段才真正需要它。 一旦执行了编译阶段， 便会将我们的artartifact-1.0.jar正确安装在我们的本地存储库中，就像从Maven Central本身中检索到的任何其他工件一样。

2.3。 生成pom与提供pom

是否需要为工件提供pom.xml文件的问题主要取决于工件本身的运行时依赖性 。 简而言之，如果工件在其他jar上具有运行时相关性，则这些jar也将需要在运行时出现在类路径上。 使用简单的工件应该不会有问题，因为它在运行时可能没有依赖关系（依赖关系图中的叶子）。 安装文件目标中的generatePom选项应足以满足以下这些条件： 

<generatePom>true</generatePom>

但是，如果工件更加复杂并且确实具有非平凡的依赖关系 ，那么，如果这些依赖关系尚未在类路径中，则必须添加它们。 一种方法是通过在项目的pom文件中手动定义这些新的依赖项。 更好的解决方案是提供一个自定义pom.xml文件以及已安装的工件： 

<generatePom>false</generatePom>
<pomFile>${basedir}/dependencies/someartifact-1.0.pom</pomFile>

这将使Maven可以解析此自定义pom.xml中定义的工件的所有依赖关系，而不必在项目的主pom文件中手动定义它们。

3.结论

本文通过使用maven-install-plugin在本地安装jar，探讨了如何使用不在Maven项目中任何地方托管的jar。

参考：在baeldung博客上，从我们的JCG合作伙伴 Eugen Paraschiv 使用Maven安装本地jar 。

翻译自: https://www.javacodegeeks.com/2013/04/install-local-jar-with-maven.html