java项目打包（maven+原生）
一、maven打包
1.1 普通jar
java -jar maven项目打包提示.jar中没有主清单属性
<build>
<finalName>${project.artifactId}</finalName><!--修改编译出来的jar包名，仅为{artifactId}.jar-->
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>3.2.0</version>
<configuration>
<archive>
<manifest>
<addClasspath>true</addClasspath>
<mainClass>com.leon.Main</mainClass> <!-- 此处为主入口-->
</manifest>
</archive>
</configuration>
</plugin>
</plugins>
</build>
原文链接：https://blog.csdn.net/whq12789/article/details/106568531
1.2 有依赖的jar
How can I create an executable/runnable JAR with dependencies using Maven?
1. 一个jar
最高赞
<build>
<plugins>
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
<archive>
<manifest>
<mainClass>fully.qualified.MainClass</mainClass>
</manifest>
</archive>
<descriptorRefs>
<descriptorRef>jar-with-dependencies</descriptorRef>
</descriptorRefs>
</configuration>
<executions>
<execution>
<id>make-assembly</id> <!-- this is used for inheritance merges -->
<phase>package</phase> <!-- bind to the packaging phase -->
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
2 把依赖放入其他目录
需要两个plugin结合使用
注意
- outputDirectory，就是生成的可运行的jar的依赖的目录
- maven-jar-plugin的classpathPrefix，作用是生产的可运行jar的MANIFEST.MF里面的Class-Path
- 这个方法，并不用我手动copy lib到项目里面，maven会自己从仓库里面copy
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<executions>
<execution>
<id>copy-dependencies</id>
<phase>prepare-package</phase>
<goals>
<goal>copy-dependencies</goal>
</goals>
<configuration>
<outputDirectory>${project.build.directory}/lib</outputDirectory>
<overWriteReleases>false</overWriteReleases>
<overWriteSnapshots>false</overWriteSnapshots>
<overWriteIfNewer>true</overWriteIfNewer>
</configuration>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<configuration>
<archive>
<manifest>
<addClasspath>true</addClasspath>
<classpathPrefix>lib/</classpathPrefix>
<mainClass>theMainClass</mainClass>
</manifest>
</archive>
</configuration>
</plugin>
二、java命令打包
0、代码目录结构
projectDir\
└—— src\com\leon\xxx.java....
└—— lib\xxx.jar
└—— META-INF\MANIFEST.MF
└—— target\classes
- 4个目录的结构都不是死的，都可以改变，但是以上的结构比较符合一般的项目结构
- lib下放三方依赖
- META-INF，一般是hyphen而不是underline，别记错写错。MANIFEST.MF可以写成txt，只要在参数里指定就好
1、javac编译成classes
javac -encoding UTF-8 -classpath .\lib\commons-lang3-3.7.jar -d .\classes src\com\leon\Main.java
| option参数 | 说明 |
|---|---|
| -encoding UTF-8 | java文件中文编码 |
| -d .\target\classes | 将打包的class文件输出到指定目录 |
| -classpath .\lib\xxx.jar | 简写-cp 指定依赖的第三方jar 目录以【.\】开头或者省略【.\】似乎没关系，并不会导致固定死目录（包含本地目录比如D盘） |
| source file参数 | |
| src\......java | 应该能简写成目录 |
2、验证classes的正确性
java -cp target\classes;lib\commons-lang3-3.7.jar com.leon.Main abc
- java运行class，首先需要指定自定义的classes的位置，-cp target\classes
- java命令的class参数要写【package的路径+class名字】，com.leon.Main
如下
这个路径，没有包含目录src，src仅仅是一个目录，它不在java文件的package命令里面
package com.leon;
public class Main {
}
- 注意 -cp命令没有以【.\】开头
可能的错误
- java.lang.NoClassDefFoundError: xxx第三方引用
-cp要指定第三方包，lib\commons-lang3-3.7.jar，多个第三方jar以semicolon分割
3、jar打包
95%内容参考自oracle的官方文档，Packaging Programs in JAR Files
jar的命令格式以jdk的帮助讲解，如下
jar {ctxui}[vfmn0PMe] [jar-file] [manifest-file] [entry-point] [-C dir] files ...
jar命令是打包，命令很类似ta
{}参数（只能选一个）
| 参数 | 说明 |
|---|---|
| c | 打包成成为jar |
| 基本不用 | |
| x | 解压jar |
| t | 显示jar中的内容 |
| u | 更新jar |
| x或i | 没试过 |
[]参数
| 重要参数 | 说明 |
|---|---|
| m | 指定MANIFEST文件 |
| f | 打包的jar的名字，这个参数不传会output will go to a stdout（什么人或者为啥要go to stdout？） |
| e | 可以指定class的入口。 |
| C | 去掉指定的目录层级。看实例。 |
| 不重要参数 | |
| v | 打包时，显示详细的信息 |
| 0 | 不压缩。不压缩的jar据oracle网站说运行更快，压缩体积更小 |
| M | jar内不要MANIFEST，为啥不要？ |
注意：
m与f参数的顺序与[jar-file] [manifest-file]顺序是必须对应的。
正确jar命令
jar cvfm Main.jar META-INF\MANIFEST.MF com\leon\Main.class -C target\classes .
MANIFEST.MF
- 自定义的MF文件，每行都是键值对的形式，以colon分割
These lines show that a manifest's entries take the form of "header: value" pairs. - 自定义的MF文件可以写成txt，也可以.MF，文件名也可以任意，但是需要通过【m 参数+[manifest-file]】
- 自定义的MF文件最后一行不会被写入到jar包中的MANIFEST.MF中，所以自定义的MF文件最后一行必须是空行
来源：
Modifying a Manifest File，Warning: The text file from which you are creating the manifest must end with a new line or carriage return. The last line will not be parsed properly if it does not end with a new line or carriage return. - MF文件需要以UTF-8编码
Main-Class
例
Main-Class: com.leon.Main
Class-Path
格式 Class-Path: jar1-name jar2-name directory-name/jar3-name
例
Class-Path: lib\commons-lang3-3.7.jar
- 在某个回答上看，不能以\开头（linux是/）。没验证
- jar包之间以空格分割
- 我看别人打包有以【.】开头的，如下，是为了把当前文件夹也包括进去？
Class-Path: . xxx1.jar xxx2.jar
jar打包正确之后，java -jar却报错“找不到或无法加载主类 xxx”
jar包的正确结构
xxx.jar
└—— com\leon\xxx.java....
└—— META-INF\MANIFEST.MF
如果出现以上错误，很可能是jar包中目录错误，如下
xxx.jar
└—— target\classes\com\leon\xxx.java....
└—— META-INF\MANIFEST.MF
解决办法一 切换目录法
cd进入classes中package目录的上一层，以示例来说，就是target\classes
然后，jar命令打包
然后，把jar放入到合适的位置运行java -jar（主要是与第三方依赖的相对位置要放置准确）
解决办法二 -C参数(推荐)
jar cvfm Main.jar META-INF\MANIFEST.MF com\leon\Main.class -C target\classes .
注意
- com\leon\Main.class是位于target\classes中的（这里与src目录无关）
- -C参数最后有一个【空格+.】
参考，could not find or load main class with a jar file，中作者Log2的回答，他解释的非常清楚，两种解决办法都有提到。
可能的错误
- 提示 xxx.jar中没有主清单属性，打开jar
以下命令会在jar中生成默认MF，位置在xxx.jar\META-INF\MANIFEST.MF，但是里面没有Main-Class
需要用-m或-e参数指定jar -cvf Main.jar .\classes\com\leon\Main.class - 有m选项，也自定义了MANIFEST.MF，但是jar中的MANIFEST.MF还是没有Main-Class
看看是不是MF文件只写了一行，没有在后面跟一个空行 - 报错 java.io.IOException: invalid header field
前面oracle文档说了，"header: value" pairs，所以，这个报错与MF格式有关
