Maven JAR Plugin 插件使用说明
- 1 Maven JAR Plugin 插件地址
- 2 Maven JAR Plugin 特点
- 3 maven-assembly-plugin 的用法
- 3.1 无依赖项 maven-jar-plugin 配置
- 3.2 有依赖项 maven-jar-plugin 配置
- 3.3 配合maven-dependency-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-assembly-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>
)
