Java JAR文件中的清单文件 MANIFEST.MF 介绍

1. 什么是 MANIFEST.MF 文件？

MANIFEST.MF 是一个特殊的文本文件，位于 JAR 文件的 META-INF/ 目录中。它是 JAR 文件的元数据文件，用于存储与 JAR 文件相关的配置信息和元数据。

2. 主要作用

• 定义 JAR 文件的元信息：如版本号、创建者等。
• 指定主类：用于将 JAR 文件设置为可执行文件。
• 支持扩展机制：如类路径（Class-Path）、签名信息等。
• 增强功能：如服务加载器机制（Service Provider Interface, SPI）。

3. 常见条目及其含义

4. 示例内容

以下是一个典型的 MANIFEST.MF 文件示例：

Manifest-Version: 1.0
Created-By: 17.0.5 (Oracle Corporation)
Main-Class: com.example.MainApp
Class-Path: lib/library1.jar lib/library2.jar
Implementation-Version: 1.0.0
Implementation-Vendor: Example Company

• Main-Class：指定 JAR 文件的主类为 com.example.MainApp。
• Class-Path：指定运行时依赖的外部 JAR 文件路径。
• Implementation-Version 和 Implementation-Vendor：提供版本和开发者信息。

5. 如何创建带有自定义清单的 JAR 文件？

方法 1：通过命令行指定清单文件

1. 创建一个名为 manifest.txt 的文件，内容如下：

   Main-Class: com.example.MainApp
   Class-Path: lib/library1.jar lib/library2.jar
   

2. 使用以下命令创建 JAR 文件：

   jar cfm myapp.jar manifest.txt -C build/classes .
   

方法 2：通过 IDE 自动生成

• 在大多数现代 IDE（如 IntelliJ IDEA 或 Eclipse）中，可以通过项目构建工具（如 Maven 或 Gradle）自动生成带有清单的 JAR 文件。

6. 注意事项

• 格式要求：每个条目必须以换行符结束，且每行长度不得超过 72 个字符。如果需要换行，可以使用空格作为续行符。
• 路径分隔符：Class-Path 中的路径用空格分隔，而不是逗号。
• 密封包：如果设置了 Sealed: true，则该包中的类不能被外部修改或扩展。

7. 扩展功能

• SPI 配置：MANIFEST.MF 可以配合 META-INF/services 目录中的服务提供者配置文件，实现动态加载功能。
• 数字签名：通过签名工具对 JAR 文件进行签名后，MANIFEST.MF 会包含签名相关信息。

希望以上内容能帮助你更好地理解和使用 MANIFEST.MF 文件！