Maven工程打入本地包问题记录

怎么将没有通过maven拉取的本地jar包，在使用maven打jar包时将其打入，jar包不再依赖外部jar包内容，试验成功，特此举例撰文记录。

使用org.apache.maven.plugins解决

背景

我们在做功能时，有时因为无法连接maven仓库，或者公共仓库中没有我们需要的jar包，就会用手动导入的方式将本地jar包引入工程，如我要将hutool工具引入工程。

• 在工程根目录新建lib文件夹，将jar包放入

• 在pom文件中，将该jar包加入：

<dependency>
  <groupId>hutool</groupId>
  <artifactId>hutool</artifactId>
  <version>4.3.2</version>
  <scope>system</scope>
  <systemPath>${project.basedir}/lib/hutool-all-4.3.2.jar</systemPath>
</dependency>

我们如果要将该工程打成一个可执行的jar包，这时就出现了问题。

问题

利用maven，执行mvn install，生成SpringDemo01-2.0.1.jar，此时的jar包内容如下：

发现jar包中并没有我们引入的hutool工具jar包，使用java -jar执行jar包时，会报类找不到的错误：

解决

通过pom文件中加入maven插件及相关配置，可以实现，具体步骤如下：

• 在项目根目录新增文件夹assembly，将release.xml文件放入，文件内容如下：

<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0 http://maven.apache.org/xsd/assembly-1.1.0.xsd">
    <id>release</id>
    <formats>
        <format>jar</format>
    </formats>
    <includeBaseDirectory>false</includeBaseDirectory>
    <dependencySets>
        <dependencySet>
            <outputDirectory>/</outputDirectory>
            <useProjectArtifact>true</useProjectArtifact>
            <unpack>true</unpack>
            <scope>runtime</scope>
        </dependencySet>
        <dependencySet>
            <outputDirectory>/</outputDirectory>
            <useProjectArtifact>true</useProjectArtifact>
            <unpack>true</unpack>
            <scope>system</scope>
        </dependencySet>
    </dependencySets>
</assembly>

• pom.xml文件中做如下配置

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://maven.apache.org/POM/4.0.0"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.huawei</groupId>
    <artifactId>SpringDemo01</artifactId>
    <version>2.0.1</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>
 
    <dependencies>
        <dependency>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-assembly-plugin</artifactId>
            <version>3.0.0</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>5.3.16</version>
        </dependency>
        <dependency>
            <groupId>hutool</groupId>
            <artifactId>hutool</artifactId>
            <version>4.3.2</version>
            <scope>system</scope>
            <systemPath>${project.basedir}/lib/hutool-all-4.3.2.jar</systemPath>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-assembly-plugin</artifactId>
                <configuration>
                    <archive>
                        <manifest>
                            <!--程序入口-->
                            <mainClass>com.huawei.Main</mainClass>
                        </manifest>
                        <manifestEntries>
                            <Class-Path>${basedir}/lib/*.jar</Class-Path>
                        </manifestEntries>
                    </archive>
                    <descriptorRefs>
                        <!--文件名后缀-->
                        <descriptorRef>jar-with-dependencies</descriptorRef>
                    </descriptorRefs>
                    <descriptors>
                        <!--assembly配置文件路径，注意需要在项目中新建文件assembly/release.xml-->
                        <descriptor>${basedir}/assembly/release.xml</descriptor>
                    </descriptors>
                </configuration>
                <executions>
                    <execution>
                        <id>make-assembly</id>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

• 执行如下命令生成jar包：

mvn clean
mvn package assembly:single

此时查看jar包中的内容如下：

hutool工具类的内容已经在jar包中，执行jar包也正常：