Maven JAR Plugin 插件使用说明

1 Maven JAR Plugin 插件地址

https://maven.apache.org/plugins/maven-jar-plugin/index.html

2 Maven JAR Plugin 特点

maven-assembly-plugin： maven 生命周期 package 阶段的默认打包插件，用于将 Maven 项目打包成jar（注意该插件不会将项目中引入的依赖打进最终的 Jar 文件）

3 maven-jar-plugin 的用法

3.1 无依赖项 maven-jar-plugin 配置

<build>
	<plugins>
		<plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
             <version>3.4.2</version>
            <configuration>
                <archive>
                    <manifest>
                    	<!--主类入口-->
                        <mainClass>com.yq.Main</mainClass>
                    </manifest>
                </archive>
            </configuration>
        </plugin>
	</plugins>
</build>

以上配置是打包成可执行jar包，
如果打包成不可执行的jar包，只需不配置 mainClass 即可，如果打包成不可执行jar包，都可以不配置maven-jar-plugin插件，maven-jar-plugin 是maven 生命周期 package 阶段的默认打包插件。

3.2 有依赖项 maven-jar-plugin 配置

文章最开始已经说过，通过 maven-jar-plugin 生成 Jar 文件时，不会将依赖包函进去；因此需要配置依赖项所在位置

<plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.4.2</version>
                <configuration>
                    <archive>
                        <manifest>
                            <!--主类入口-->
                            <mainClass>com.yq.Main</mainClass>
                            <!--将项目的依赖位置添加到 MANIFEST.MF 中的Class-Path-->
                            <addClasspath>true</addClasspath>
                            <!--依赖的存放位置 和生成的jar放在同一级目录下-->
                            <classpathPrefix>lib/</classpathPrefix>
                            <!--是否使用-SNAPSHOT 命名版本。默认值为true-->
                            <useUniqueVersions>false</useUniqueVersions>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>

上述配置生成的 MANIFEST.MF 中多了依赖的信息：

Manifest-Version: 1.0
Created-By: Maven JAR Plugin 3.4.2
Build-Jdk-Spec: 17
Class-Path: lib/hutool-all-5.8.39.jar
Main-Class: com.yq.Main

实际并没有下载依赖到lib 目录，需要借助maven-dependency-plugin插件下载依赖到lib目录

3.3 配合maven-dependency-plugin 将依赖复制到指定位置

它可以从本地或远程存储库复制或解压构件到指定位置

  <plugin>
	  <groupId>org.apache.maven.plugins</groupId>
	  <artifactId>maven-dependency-plugin</artifactId>
	  <version>3.8.1</version>
	  <executions>
	      <execution>
	          <id>copy-dependencies</id>
	          <phase>package</phase>
	          <goals>
	              <goal>copy-dependencies</goal>
	          </goals>
	          <configuration>
	              <outputDirectory>${project.build.directory}/lib</outputDirectory>
	              <!-- 间接依赖也拷贝 -->
	              <excludeTransitive>false</excludeTransitive>
	              <!-- 依赖带上版本号  -->
	              <stripVersion>false</stripVersion>
	              <!--覆盖发布工件-->
	              <overWriteReleases>false</overWriteReleases>
	              <!--覆盖快照项目-->
	              <overWriteSnapshots>false</overWriteSnapshots>
	              <!--覆盖不存在或比源文件更旧的构建产物-->
	              <overWriteIfNewer>true</overWriteIfNewer>
	          </configuration>
	      </execution>
	  </executions>
 </plugin>