如何在可执行 JAR 的清单文件中指定主类

简介

本教程将指导你完成在 Java 中为可执行 JAR 的清单文件指定主类的过程。在本文结束时，你将了解如何正确配置清单文件并创建一个可轻松执行的自包含 Java 应用程序。

Skills Graph

理解可执行 JAR 文件

在 Java 开发领域，可执行 JAR（Java 归档）文件在打包和分发 Java 应用程序方面起着至关重要的作用。可执行 JAR 文件是一种特殊类型的 JAR 文件，它可以直接从命令行运行，无需手动指定主类。

什么是可执行 JAR？

可执行 JAR 文件是一个已配置了特殊清单文件的 JAR 文件。清单文件包含有关 JAR 文件的元数据，包括在运行 JAR 文件时应执行的主类。

可执行 JAR 文件的优点

使用可执行 JAR 文件有几个优点：

1. 可移植性：可执行 JAR 文件可以在任何安装了 Java 运行时环境（JRE）的系统上运行，使你的应用程序更具可移植性。
2. 简单性：用户只需双击 JAR 文件或从命令行执行它，就可以运行你的应用程序，而无需知道具体的主类。
3. 分发：可执行 JAR 文件可以轻松地分发并与他人共享，因为它们包含运行应用程序所需的所有必要组件。

可执行 JAR 的剖析

可执行 JAR 文件由以下关键组件组成：

1. JAR 文件：JAR 文件本身，它包含已编译的 Java 类、资源和其他支持文件。
2. 清单文件：一个名为 MANIFEST.MF 的特殊文件，位于 JAR 文件的 META-INF 目录中。此文件包含有关 JAR 文件的元数据，包括要执行的主类。

通过了解可执行 JAR 文件的结构和组件，你将更有能力配置清单文件并创建自己的可执行 JAR 文件。

配置清单文件

创建可执行 JAR 文件的关键在于正确配置清单文件。清单文件是位于 JAR 文件的 META-INF 目录中的一个特殊文件，它包含有关 JAR 文件的元数据，包括运行 JAR 文件时应执行的主类。

清单文件结构

清单文件遵循特定格式，每个条目由换行符和冒号（:）分隔，以分隔键和值。以下是一个基本清单文件的示例：

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

在此示例中，Main-Class 属性指定了运行 JAR 文件时应执行的主类的全限定名。

配置清单文件

要配置清单文件，你可以使用文本编辑器或像 jar 命令行工具这样的工具。以下是在 Ubuntu 22.04 系统上使用 jar 命令创建清单文件的示例：

## 为项目创建一个新目录
mkdir my-project
cd my-project

## 编译 Java 类
javac com/labex/example/Main.java

## 创建清单文件
echo "Main-Class: com.labex.example.Main" > MANIFEST.MF

## 使用清单创建 JAR 文件
jar cvfm my-app.jar MANIFEST.MF com/

在此示例中，我们首先为项目创建一个新目录并编译 Java 类。然后，我们创建清单文件，将 Main-Class 属性设置为主类的全限定名。最后，我们使用 jar 命令创建可执行 JAR 文件，指定清单文件和已编译的 Java 类。

通过正确配置清单文件，你可以确保你的 JAR 文件是可执行的，并且用户可以轻松地分发和运行它。

构建并运行可执行 JAR

既然你已经配置好了清单文件，那么就可以准备构建并运行可执行 JAR 文件了。这个过程包括编译 Java 类、创建 JAR 文件，然后执行 JAR 文件。

构建可执行 JAR

要构建可执行 JAR 文件，你可以使用 jar 命令行工具。以下是在 Ubuntu 22.04 系统上如何操作的示例：

## 编译 Java 类
javac com/labex/example/Main.java

## 创建清单文件
echo "Main-Class: com.labex.example.Main" > MANIFEST.MF

## 使用清单创建 JAR 文件
jar cvfm my-app.jar MANIFEST.MF com/

在此示例中，我们首先编译 Java 类，然后创建带有 Main-Class 属性的清单文件，最后使用 jar 命令创建可执行 JAR 文件，指定清单文件和已编译的 Java 类。

运行可执行 JAR

构建好可执行 JAR 文件后，你可以使用 java 命令来运行它。以下是一个示例：

java -jar my-app.jar

此命令将执行清单文件中指定的主类，并运行你的 Java 应用程序。

你也可以在文件管理器中双击 JAR 文件，或者在 macOS 上使用 open 命令来运行可执行 JAR 文件。操作系统会自动将 JAR 文件识别为可执行文件并启动 Java 应用程序。

通过遵循这些步骤，你可以轻松地构建并运行自己的可执行 JAR 文件，从而更方便地分发和运行你的 Java 应用程序。

总结

在本 Java 教程中，你已经学会了如何配置清单文件以指定可执行 JAR 的主类。通过了解清单文件的结构以及构建和运行可执行 JAR 的必要步骤，你现在可以创建自包含的 Java 应用程序，这些应用程序可以轻松地在不同系统上分发和执行。