Java 使用 jar 命令打包

叁歲伎倆 2022-11-16 10:57 117阅读 0赞

### Java 使用 jar 命令打包 ###

为何打包（jar包）？为了项目的部署和发布，你的程序可能使用很多个类，把这些类和他们的目录一起压缩到一个文件中给别人，可以方便使用，通常在打包时候，会在里面加上部署的相关信息。打包实际上就是把代码和依赖的东西压缩在一起，变成后缀名为. jar包，别人拿到这个jar包之后，双击它从而运行。

**jar包和Manifest文件**

jar包（文件）就是 Java Archive File（Java档案\[归档\]文件），是 Java 的一种文件格式，可将多个文件组合成一个文件。一个JAR文件由一系列采用Zip压缩格式的文件构成，同时还有一张“清单（Manifest）”，对所有这些文件进行了描述。JDK提供的许多类，也是以jar包的形式提供的。

jar包用于部署和封装库、组件和插件程序，并可被像编译器和 JVM 这样的工具直接使用。jar文件中有一个特定目录——META-INF，其中包含特殊的文件——MANIFEST.MF，用来定义扩展与档案打包相关数据信息，运行时向JVM提供应用程序的有关数据信息。

清单（Manifest）文件格式规则：

1.文件中的内容以键值对的形式出现，键值对之间采用"冒号和空格"进行分隔(注意：冒号后的空格必须有，不然格式有错误).

2.每行最多72个字符，换行继续必须以空格开头 。

3. Class-Path指定引用jar包的目录。调用多个jar时，每一个用空格（由一个或多个空格）隔开，不是逗号或分号，一行写不下（超过72个字符），从第二行开始，每行开头要至少一个空格。如：

Class-Path: lib/tools.jar lib/guava-r09.jar lib/guice-2.0.jar

lib/jakarta.commons.lang-2.2.jar

4. 文件的最后必需要空行，而且必须顶格。

更详细的说明，参考oracle提供的文档：[http://docs.oracle.com/javase/1.5.0/docs/guide/jar/jar.html][http_docs.oracle.com_javase_1.5.0_docs_guide_jar_jar.html]

一个简单的Manifest文件示例：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NuZHMxMjM_size_16_color_FFFFFF_t_70][]

其中：

Manifest-Version

用来定义manifest文件的版本，例如：Manifest-Version: 1.0

Created-By

声明该文件的生成者，这行信息没什么用

Main-Class

定义jar文件的入口类，如果 JAR 文件被用作可执行的应用程序，那么应用程序需要告诉 Java 虚拟机入口点位置，任意包含 public static void main(String\[\] args) 方法的类即为入口点。该信息由文件头 Main-Class 提供，基本格式如下：

Main-Class: classname

classname值可由应用程序的入口点代替。

** jar 命令介绍**

当我们安装好JDK，设置好path路径，就可以正常使用jar.exe命令打包了。

在cmd中，可以使用jar --help 或 ar -h 获取详细信息。

JDK9之后引入了模块化的概念，所以JDK9之后jar命令有了比较大的变化，下面JDK11中的jar命令的用法：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NuZHMxMjM_size_16_color_FFFFFF_t_70 1][]

作为对照了解，给出JDK8中jar命令如下图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NuZHMxMjM_size_16_color_FFFFFF_t_70 2][]

**简要补充说明：**

\-c  创建一个jar包

\-t  显示jar中的内容列表

\-x  解压jar包

\-u  添加文件到jar包中

\-f  指定jar包的文件名

\-v  生成详细的报造，并输出至标准设备

\-m  指定manifest.mf文件.(manifest.mf文件中可以对jar包及其中的内容作一些一设置)

\-0  产生jar包时不对其中的内容进行压缩处理

\-M  不产生所有文件的清单文件(Manifest.mf)。这个参数与忽略掉-m参数的设置

\-i    为指定的jar文件创建索引文件

\-C dir  相当于切换到dir目录执行jar命令，也就是将dir目录中的全部内容打入包中。 其中C大写，dir表示目录，根据实际而定。

更详细的说明，参考oracle提供的文档（其中的数字为版本号）：

[https://docs.oracle.com/javase/8/docs/technotes/tools/windows/jar.html\#examples][https_docs.oracle.com_javase_8_docs_technotes_tools_windows_jar.html_examples]

[https://docs.oracle.com/en/java/javase/11/tools/jar.html][https_docs.oracle.com_en_java_javase_11_tools_jar.html]

[https://docs.oracle.com/en/java/javase/12/docs/specs/man/jar.html][https_docs.oracle.com_en_java_javase_12_docs_specs_man_jar.html]

**例**、打包，把manifest文件插入JAR文件使用 m 选项，把指定文件名的manifest文件传入（这里是预先准备好的myapplication.mf ），用jar命令如下  
jar cvfm myapplication.jar myapplication.mf -C classdir

将 -C classdir指定的路径下的全部内容，生成名为myapplication.jar的包，并将清单文件myapplication.mf的内容提取到META-INF/MANIFEST.MF文件中

** jar 命令的使用**

java打jar包的几种方式详解 [https://www.cnblogs.com/flashsun/p/7246260.html][https_www.cnblogs.com_flashsun_p_7246260.html]

**附录**

使用JDK命令行编译、运行Java程序 及相关常见问题的解决 [https://blog.csdn.net/cnds123/article/details/101674527][https_blog.csdn.net_cnds123_article_details_101674527]

使用Eclipse导出向导生成jar包 [https://blog.csdn.net/cnds123/article/details/80463293][https_blog.csdn.net_cnds123_article_details_80463293]

[http_docs.oracle.com_javase_1.5.0_docs_guide_jar_jar.html]: http://docs.oracle.com/javase/1.5.0/docs/guide/jar/jar.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NuZHMxMjM_size_16_color_FFFFFF_t_70]: /images/20221022/e02f74cab4914c5499cbcddfc49c41a5.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NuZHMxMjM_size_16_color_FFFFFF_t_70 1]: /images/20221022/881dd89d9a584ac2b535db6f723c1adc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NuZHMxMjM_size_16_color_FFFFFF_t_70 2]: /images/20221022/c0b7583336d746b1807e592a53753e96.png
[https_docs.oracle.com_javase_8_docs_technotes_tools_windows_jar.html_examples]: https://docs.oracle.com/javase/8/docs/technotes/tools/windows/jar.html#examples
[https_docs.oracle.com_en_java_javase_11_tools_jar.html]: https://docs.oracle.com/en/java/javase/11/tools/jar.html
[https_docs.oracle.com_en_java_javase_12_docs_specs_man_jar.html]: https://docs.oracle.com/en/java/javase/12/docs/specs/man/jar.html
[https_www.cnblogs.com_flashsun_p_7246260.html]: https://www.cnblogs.com/flashsun/p/7246260.html
[https_blog.csdn.net_cnds123_article_details_101674527]: https://blog.csdn.net/cnds123/article/details/101674527
[https_blog.csdn.net_cnds123_article_details_80463293]: https://blog.csdn.net/cnds123/article/details/80463293