SpringBoot添加本地jar文件.md

前言

有时候我们在项目中，会用到一些本地 jar 包文件，比如隔壁公司自己打包的；

此时无法从maven远程仓库拉取；

那么我们可以考虑把 jar 文件安装到本地 maven 库中，然后再添加依赖。

步骤

1. 添加 jar 文件到项目中

在 resources 目录中创建一个 lib 目录，将本地 jar 放进去，如下所示的 demo.jar

2. 安装 jar 包到 maven 本地仓库

这里我们可以利用 maven-install-plugin 插件来安装， pom.xml如下：

  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-install-plugin</artifactId>
        <version>2.5.2</version>
        <executions>
          <execution>
            <id>install-demo-jar</id>
            <!-- 阶段：设定在 mvn clean 时执行安装,如果设定为 validate，那么就是在 mvn validate 时才安装 -->
            <phase>clean</phase>
            <configuration>
              <!-- 路径：这就是刚才添加的 jar 路径 -->
              <file>${project.basedir}/src/main/resources/lib/demo.jar</file>
              <!-- 属性：下面的这三个属性，就是后面我们添加依赖时的值 -->
              <groupId>com.javalover</groupId>
              <artifactId>demo</artifactId>
              <version>1.0</version>
              <packaging>jar</packaging>
              <generatePom>true</generatePom>
            </configuration>
            <goals>
              <!-- 目标：安装外部的 jar 文件到 maven 本地仓库 -->
              <goal>install-file</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>

运行mvn clean后，会打印如下日志：

[INFO] --------------------------< com.example:demo >--------------------------
[INFO] Building demo 0.0.1-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] 
[INFO] --- maven-clean-plugin:3.1.0:clean (default-clean) @ demo ---
[INFO] 
[INFO] --- maven-install-plugin:2.5.2:install-file (install-demo-jar) @ demo ---
[INFO] pom.xml not found in demo.jar
[INFO] Installing /Users/jalon/Project/SpringBootProject/demo/src/main/resources/lib/demo.jar to /Users/jalon/.m2/repository/com/javalover/demo/1.0/demo-1.0.jar
[INFO] Installing /var/folders/t6/99ks0lsn0fx2j6kt4n46f_rh0000gn/T/mvninstall6930618999486285918.pom to /Users/jalon/.m2/repository/com/javalover/demo/1.0/demo-1.0.pom
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.316 s
[INFO] Finished at: 2021-09-26T22:12:47+08:00
[INFO] ------------------------------------------------------------------------
​

重点是这一行：

[INFO] Installing /Users/jalon/Project/SpringBootProject/demo/src/main/resources/lib/demo.jar to /Users/jalon/.m2/repository/com/javalover/demo/1.0/demo-1.0.jar`

可以看到，将我们本地的 demo.jar 安装到了 maven 本地仓库中

3. 添加依赖

    <dependency>
      <groupId>com.javalover</groupId>
      <artifactId>demo</artifactId>
      <version>1.0</version>
    </dependency>

此时程序就可以正常使用 demo.jar 包了，而且 maven 打包也会把 demo.jar 打包进去

参考

Apache Maven Install Plugin – Introduction

maven插件maven-install-plugin - Mars.wang - 博客园 (cnblogs.com)