Maven打包所有依赖到一个可执行jar中
文章目录
- 需求
- 遇到的问题
- 找不到主类
- 打包时没有包含第三方依赖
- 情况1
- 情况2
- 扩展问题
- 不希望依赖的jar包变成class
- 项目里多个主类，如何动态指定
需求
普通的Maven Java项目（非Springboot项目），需要打包成一个jar包（包含所有的第三方依赖jar包），能够放在服务器上单独运行。
遇到的问题
找不到主类
大家都知道，如果使用常见的maven-jar-plugin打包，只能将自己项目里的源码编译打包，不会包含第三方的jar包。
如果该项目没有第三方依赖包，则可以通过maven-jar-plugin打包，直接执行打好的jar包（java -jar xxx.jar），可能会遇到找不到主类的情况，可以通过下面的方式解决：指定主类
<plugin><artifactId>maven-jar-plugin</artifactId><version>3.0.2</version><configuration><archive><manifest><addClasspath>true</addClasspath><mainClass>com.xxx.AppMain</mainClass></manifest></archive></configuration></plugin>
注意：
META-INF文件夹是MANIFEST.MF文件的主页。 此文件包含有关JAR内容的元数据。
JAR包中的/META-INF/MANIFEST.MF元数据文件必须包含Main-Class(主类)信息。(工程里的src/META-INF/MANIFEST.MF)
项目所有的依赖都必须在Classpath中，其可以通过 MANIFEST.MF 指定或者隐式设置。
打包时没有包含第三方依赖
如果该项目有第三方依赖包，通过上面的方式打包，是不会包含第三方依赖的，直接运行生成的jar包会出错（相关依赖不存在）。
想要打包时包含第三方依赖，又可以分两种情况：
情况1
打包成可执行jar文件，但是将所有依赖（包括外部依赖）单独打包到另外一个指定文件夹下，通过指定Class-Path的方式关联。
打包依赖到指定文件夹
org.apache.maven.plugins
maven-dependency-plugin
2.10
copy-dependencies
package
copy-dependencies
${project.build.directory}/lib
关于Maven dependency plugin可以参考我的另外一篇博客，有详细介绍：
Maven dependency plugin使用
指定启动入口，并关联依赖
org.apache.maven.plugins
maven-jar-plugin
true
lib/
com.xxx.AppMain
配置好后，可以通过下面的命令编译打包：mvn clean pacakge -DskipTests=true
注意，复杂情况下，classpath需要在运行时指定，如 java -cp …
情况2
将整个工程打成一个可执行jar包，包含所有的依赖。
需要通过maven-assembly-plugin插件来打包，可以实现该需求。
<build><plugins><plugin><artifactId>maven-compiler-plugin</artifactId><version>2.3.2</version><configuration><source>1.8</source><target>1.8</target></configuration></plugin><plugin><artifactId>maven-assembly-plugin</artifactId><configuration><descriptorRefs><descriptorRef>jar-with-dependencies</descriptorRef></descriptorRefs><archive><manifest><mainClass>com.xxx.AppMain</mainClass></manifest></archive></configuration><executions><execution><id>make-assembly</id><phase>package</phase><goals><goal>single</goal></goals></execution></executions></plugin></plugins></build>
配置好后，可以通过下面的命令编译打包：mvn assembly:assembly
执行成功后会在target文件夹下多出一个以-jar-with-dependencies结尾的jar包. 这个jar包就包含了项目所依赖的所有jar的class。
扩展问题
不希望依赖的jar包变成class
可以通过修改插件的配置做到
在本地maven仓库里找到maven-assembly-plugin
cd ~/.m2/repository/org/apache/maven/plugins/maven-assembly-plugin/
进入打包时运行使用的版本里，如2.2-beta-5；
- 解压maven-assembly-plugin-2.2-beta-5.jar；
- 进入解压好的文件夹找到assemblies\jar-with-dependencies.xml，
把里面的UNPACK改成FALSE，保存即可； 还原解压后的文件为jar包
例如，在～/.m2/repository/org/apache/maven/plugins/maven-assembly-plugin/2.2-beta-5 路径里，执行下面的命令jar cvfm maven-assembly-plugin-2.2-beta-5.jar maven-assembly-plugin-2.2-beta-5/META-INF/MANIFEST.MF -C maven-assembly-plugin-2.2-beta-5 .
再次使用
mvn assembly:assembly打包，编译好的以-jar-with-dependencies结尾的jar包. 这个jar包就包含了项目所依赖的所有jar文件，不再是class；
项目里多个主类，如何动态指定
可以通过自定义property属性，在执行maven命令时，动态指定来实现，配置如下：
例如，main.class 则为自定义的；
<properties><main.class>com.xxx.AppMain</main.class></properties><build><plugins><plugin><artifactId>maven-compiler-plugin</artifactId><version>2.3.2</version><configuration><source>1.8</source><target>1.8</target></configuration></plugin><plugin><artifactId>maven-assembly-plugin</artifactId><configuration><descriptorRefs><descriptorRef>jar-with-dependencies</descriptorRef></descriptorRefs><archive><manifest><mainClass>${main.class}</mainClass></manifest></archive></configuration><executions><execution><id>make-assembly</id><phase>package</phase><goals><goal>single</goal></goals></execution></executions></plugin></plugins></build>
运行maven命令时，动态指定：
mvn -Dmain.class=com.xxx.AppMain2 assembly:assembly
左手的ㄟ右手
曾经终败给现在
分手后的思念是犯贱
还没有评论，来说两句吧...