前言

在 Java 開(kāi)發(fā)中，打包 JAR（Java ARchive）文件是將編譯后的 .class 文件、資源文件（如配置文件、圖片等）以及依賴的庫(kù)文件打包成一個(gè)壓縮文件，便于分發(fā)和運(yùn)行的常見(jiàn)操作。本文將詳細(xì)介紹如何將 Java 文件打成獨(dú)立的 JAR 包，包括各個(gè)步驟的詳細(xì)說(shuō)明（包括maven項(xiàng)目和非maven項(xiàng)目）。

一、 非Maven項(xiàng)目如何單獨(dú)打成JAR包

1. 準(zhǔn)備工作

在開(kāi)始打包之前，確保你已經(jīng)具備以下環(huán)境和文件：

• Java Development Kit (JDK)：確保已經(jīng)安裝了 JDK 并正確配置了環(huán)境變量（JAVA_HOME）。
• Java 源代碼：已編寫(xiě)并通過(guò)編譯的 Java 程序，通常存放在 src 目錄下。
• Manifest 文件（可選）：用于指定主類和其他 JAR 文件的元數(shù)據(jù)文件（MANIFEST.MF）。

假設(shè)你有一個(gè)簡(jiǎn)單的 Java 項(xiàng)目結(jié)構(gòu)如下：

MyProject/
│
├── src/
│   └── com/
│       └── example/
│           └── MyApp.java
│
└── manifest/
    └── MANIFEST.MF

其中，MyApp.java 是你的主程序文件，MANIFEST.MF 是你的可選 manifest 文件。

2. 編譯 Java 文件

首先，你需要將 .java 源文件編譯成 .class 字節(jié)碼文件。假設(shè)你當(dāng)前位于項(xiàng)目的根目錄（即 MyProject/ 目錄下）。

命令：

javac -d out/production/classes src/com/example/MyApp.java

• -d 參數(shù)指定了編譯后的 .class 文件存放目錄。
• out/production/classes 是編譯后 .class 文件的輸出目錄。

執(zhí)行后，你將得到如下的項(xiàng)目結(jié)構(gòu)：

MyProject/
│
├── out/
│   └── production/
│       └── classes/
│           └── com/
│               └── example/
│                   └── MyApp.class
│
├── src/
│   └── com/
│       └── example/
│           └── MyApp.java
│
└── manifest/
    └── MANIFEST.MF

3. 創(chuàng)建 Manifest 文件（可選）

Manifest 文件可以指定 JAR 包的入口類以及其他元數(shù)據(jù)。如果沒(méi)有提供 manifest 文件，JAR 包將無(wú)法通過(guò)命令行直接運(yùn)行。

示例 MANIFEST.MF 文件內(nèi)容：

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

• Main-Class 指定了 JAR 包的入口類，也就是 public static void main(String[] args) 方法所在的類。

4. 打包成 JAR 文件

在編譯完成和（可選的）manifest 文件準(zhǔn)備好后，你可以使用 jar 命令將項(xiàng)目打包成 JAR 文件。

命令：

jar cvfm MyApp.jar manifest/MANIFEST.MF -C out/production/classes/ .

• c 選項(xiàng)表示創(chuàng)建一個(gè)新的 JAR 文件。
• v 選項(xiàng)表示生成詳細(xì)輸出。
• f 選項(xiàng)表示指定 JAR 文件的名稱。
• m 選項(xiàng)表示將 manifest 文件添加到 JAR 文件中。
• -C 選項(xiàng)表示切換到指定目錄并添加該目錄下的文件到 JAR 文件中。
• MyApp.jar 是生成的 JAR 文件的名稱。

執(zhí)行后，你將得到如下的項(xiàng)目結(jié)構(gòu)：

MyProject/
│
├── MyApp.jar
│
├── out/
│   └── production/
│       └── classes/
│           └── com/
│               └── example/
│                   └── MyApp.class
│
├── src/
│   └── com/
│       └── example/
│           └── MyApp.java
│
└── manifest/
    └── MANIFEST.MF

MyApp.jar 就是你打包好的 JAR 文件。

5. 運(yùn)行 JAR 文件

生成 JAR 文件后，你可以通過(guò)以下命令來(lái)運(yùn)行它：

命令：

java -jar MyApp.jar

如果 JAR 包包含正確的 Main-Class 信息，它將直接執(zhí)行主程序。

6. 常見(jiàn)問(wèn)題與解決方法

6.1 找不到主類

如果在運(yùn)行 JAR 包時(shí)出現(xiàn) Error: Could not find or load main class 錯(cuò)誤，通常是因?yàn)?nbsp;Main-Class 未正確配置或路徑錯(cuò)誤。確保 MANIFEST.MF 文件中的 Main-Class 指向正確的類，并且在打包時(shí)使用了 -m 選項(xiàng)將 manifest 文件包含在 JAR 包中。

6.2 打包后缺少依賴庫(kù)

如果你的項(xiàng)目依賴于外部庫(kù)，需要將這些庫(kù)打包到 JAR 文件中?？梢允褂?nbsp;fat JAR 或 uber JAR 的方法，將所有依賴庫(kù)打包到一個(gè) JAR 文件中。常見(jiàn)工具如 Maven 的 shade 插件或 Gradle 的 shadow 插件都可以實(shí)現(xiàn)這一點(diǎn)。

二、Maven項(xiàng)目如何單獨(dú)打成JAR包

在使用Maven進(jìn)行項(xiàng)目管理時(shí)，將項(xiàng)目打包成JAR文件是一項(xiàng)非常常見(jiàn)的操作。Maven通過(guò)提供內(nèi)置的生命周期階段，極大地簡(jiǎn)化了代碼的編譯和打包過(guò)程。接下來(lái)我們?cè)敿?xì)講解如何使用Maven將一個(gè)電商系統(tǒng)的項(xiàng)目單獨(dú)打包成JAR文件。

2.1 配置pom.xml文件

首先，確保你的pom.xml文件中已經(jīng)正確配置了相關(guān)依賴和插件。通常，我們需要使用Maven的maven-jar-plugin來(lái)幫助我們完成打包操作。

<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.ecommerce</groupId>
    <artifactId>ecommerce-system</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <dependencies>
        <!-- 這里添加項(xiàng)目所需的依賴 -->
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.2.0</version>
                <configuration>
                    <archive>
                        <manifest>
                            <mainClass>com.ecommerce.MainApplication</mainClass>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

• artifactId：表示項(xiàng)目的唯一標(biāo)識(shí)符，通常與項(xiàng)目名保持一致。
• version：項(xiàng)目的版本號(hào)，通常是SNAPSHOT（開(kāi)發(fā)中版本）或者特定的發(fā)布版本號(hào)。
• packaging：指定打包類型為jar。
• mainClass：指定項(xiàng)目的主類路徑，這個(gè)類包含main方法，是程序的入口。

2.2 使用Maven命令打包

配置好pom.xml文件后，可以使用Maven命令來(lái)打包項(xiàng)目。

mvn clean package

執(zhí)行該命令后，Maven會(huì)進(jìn)行以下步驟：

• 清理階段：刪除之前編譯生成的目標(biāo)目錄下的內(nèi)容。
• 編譯階段：編譯源代碼，將Java文件編譯為字節(jié)碼文件（.class）。
• 測(cè)試階段：執(zhí)行測(cè)試用例，確保代碼功能正常（如果有測(cè)試用例）。
• 打包階段：將編譯生成的文件和資源文件打包成一個(gè)JAR文件。

打包成功后，JAR文件會(huì)生成在target目錄下，文件名通常為artifactId-version.jar，例如ecommerce-system-1.0-SNAPSHOT.jar。

2.3 運(yùn)行生成的JAR包

打包完成后，可以通過(guò)以下命令運(yùn)行生成的JAR文件：

java -jar target/ecommerce-system-1.0-SNAPSHOT.jar

如果pom.xml文件配置正確，程序?qū)?huì)順利啟動(dòng)。

2.4 使用maven-shade-plugin合并依賴

有時(shí)候，我們可能需要將所有依賴一起打包進(jìn)JAR文件中，這時(shí)可以使用maven-shade-plugin插件。

在pom.xml中添加以下配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.2.4</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <createDependencyReducedPom>false</createDependencyReducedPom>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

然后再次執(zhí)行mvn clean package命令，生成的JAR文件將包含所有依賴，方便直接運(yùn)行。

這樣，你就成功將Maven項(xiàng)目打包成了一個(gè)可執(zhí)行的JAR文件，接下來(lái)可以繼續(xù)深入部署和運(yùn)行這個(gè)JAR文件。

總結(jié)

到此這篇關(guān)于給Java文件打成獨(dú)立JAR包的文章就介紹到這了,更多相關(guān)Java文件打成獨(dú)立JAR包內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論