Java命令行如何打包jar文件？

在Java开发中，命令行打包是开发者必须掌握的基础技能之一，它通过使用Java Development Kit（JDK）提供的工具将编译后的.class文件、资源文件等打包成可执行的JAR文件或WAR文件，便于部署和分发，本文将详细介绍Java命令行打包的完整流程，包括环境准备、常用工具、打包步骤及常见问题的解决方案。

环境准备

在进行Java命令行打包之前，需确保已正确安装JDK并配置环境变量,具体步骤如下：

1. 安装JDK：从Oracle官网或OpenJDK下载适合操作系统的JDK版本,并完成安装。
2. 配置环境变量：在系统环境变量中添加JAVA_HOME变量，指向JDK的安装目录（如C:\Program Files\Java\jdk-11），并将%JAVA_HOME%\bin添加到Path变量中,以便在命令行中直接使用Java命令。
3. 验证安装：打开命令行工具，输入java -version和javac -version,若显示版本信息则表示配置成功。

常用打包工具

Java命令行打包主要依赖以下工具：

• jar工具：JDK自带的命令行工具,用于创建和管理JAR文件。
• javac工具：用于将.java源文件编译为.class文件。
• java工具：用于运行已编译的Java程序。

打包步骤

编译源代码

假设有一个简单的Java项目，包含src/com/example/Main.java和src/com/example/Utils.java两个源文件，以及resources/config.properties资源文件，首先使用javac编译源代码：

javac -d bin src/com/example/*.java

• -d bin：指定编译后的.class文件输出目录为bin。
• 编译完成后，bin目录下会生成com/example/Main.class和com/example/Utils.class文件。

创建JAR文件

使用jar工具将编译后的文件和资源文件打包为JAR文件,以下是具体命令：

jar cvf myapp.jar -C bin . -C resources .

• c：创建新的JAR文件。
• v：生成详细输出,显示打包过程。
• f：指定JAR文件名（如myapp.jar）。
• -C bin .：切换到bin目录，并将所有文件（表示当前目录所有内容）添加到JAR中。
• -C resources .：切换到resources目录,并将资源文件添加到JAR中。

创建可执行JAR文件

若需将JAR文件设为可执行（通过java -jar运行），需在JAR中添加META-INF/MANIFEST.MF文件，并指定主类,步骤如下：

1. 创建MANIFEST.MF文件：在项目根目录下创建META-INF文件夹，并添加MANIFEST.MF如下：

   Manifest-Version: 1.0
   Main-Class: com.example.Main

2. 重新打包JAR文件：

   jar cvfm myapp.jar META-INF/MANIFEST.MF -C bin . -C resources .

   • m：从指定文件（META-INF/MANIFEST.MF）中提取清单信息。

验证JAR文件

使用以下命令验证JAR文件是否创建成功：

jar tf myapp.jar

• t：列出JAR文件的内容。
• 若输出包含com/example/Main.class和config.properties等文件,则表示打包成功。

高级选项

• 排除文件：使用排除特定文件，例如jar cvf myapp.jar -C bin . '!com/example/Utils.class'。
• 压缩级别：通过0(不压缩)到9(最高压缩)调整压缩率，默认为6，例如jar cvf0 myapp.jar -C bin .。
• 签名JAR文件：使用jarsigner工具对JAR文件进行数字签名，确保安全性：

  jarsigner -keystore mykeystore.jks -storepass password myapp.jar alias_name

常见问题与解决方案

1. 问题：运行java -jar myapp.jar时提示“Failed to load Main-Class manifest attribute”。
   解决方案：检查MANIFEST.MF文件是否正确包含Main-Class属性，且属性值与主类的全限定名一致（如com.example.Main），确保JAR打包时通过m选项指定了清单文件。

2. 问题：JAR文件运行时提示“ClassNotFoundException”。
   解决方案：检查jar tf myapp.jar命令输出，确认依赖的.class文件或资源文件是否已正确包含在JAR中，若依赖外部库，需使用Class-Path属性在MANIFEST.MF中指定路径（如Class-Path: lib/*.jar）,并将依赖库放在指定目录下。

   
   （图片来源网络，侵删）

相关问答FAQs

Q1: 如何在JAR文件中包含第三方依赖库？
A1: 若需将第三方JAR库（如mysql-connector-java.jar）打包到主JAR中，可使用以下方法：

1. 将依赖库放入lib目录。
2. 使用jar工具将依赖库与主程序一同打包：

   jar cvf myapp.jar -C bin . -C resources . -C lib .

3. 在MANIFEST.MF中添加Class-Path属性指向依赖库（若不打包进主JAR，则需将依赖库放在运行目录下）。

Q2: 如何创建多模块项目的可执行JAR文件？
A2: 对于多模块项目（如Maven/Gradle项目），建议使用构建工具（如Maven的maven-assembly-plugin或Gradle的Shadow插件）自动合并依赖，若需手动操作，可按以下步骤：

1. 分别编译各模块并生成JAR文件。
2. 使用jar工具合并所有JAR文件：

   jar cvf myapp.jar -C module1/bin . -C module2/bin . -C resources .

3. 确保主类的MANIFEST.MF配置正确,且依赖模块的类路径已包含在最终JAR中。