在 Eclipse 中快速建立 JAR 文件

1. 概述

在本文中，我們將學習如何在Eclipse IDE 中快速建立 JAR 檔案。我們將遵循兩種方法。首先，我們將使用 Eclipse 特定的.jardesc檔案來快速建立 JAR。我們也將了解.jardesc檔案的結構。

然後，我們將建立一個自訂 Ant Builder，以在成功建置後自動產生專案的 JAR 檔案。

2.使用`.jardesc`文件

.jardesc檔案定義如何將 Java 專案轉換為 JAR（Java 檔案）檔案。 JAR 檔案包括必要的原始檔案和類別檔案、相依性、資源以及包含有關 JAR 檔案資訊的清單檔案。

2.1.創建`.jardesc`

.jardesc是一個 XML 文件，我們可以使用它在 Eclipse IDE 中透過幾個簡單的步驟快速建立 JAR。我們可以在 JAR 匯出精靈中以相當用戶友好的方式產生檔案。

例如，我們有以下項目佈局：

md2epub

 ├── pom.xml

 └── src

 ├── main

 │   ├── java

 │   │   └── app

 │   │   └── Application.java

 │   └── resources

 └── test

 ├── java

 └── resources

我們透過右鍵單擊套件資源管理器視圖中的項目並從選單中選擇“ Export ”選項來建立專案的 JAR：

出口項目

一旦我們選擇“ Export ”，我們將看到匯出嚮導，我們可以在其中選擇匯出格式：

選擇匯出精靈

從樹中，我們選擇“ JAR file ”並按下“ Next ”：

JAR

在這裡，我們選擇要包含在 JAR 檔案中的所需檔案。然後，我們選擇 JAR 檔案的目標位置並檢查所需的選項。完成後，按“ Next ”：

這是重要的一步。在這裡，我們選中“ Save the description of this JAR in the workspace ”選項，這將創建一個.jardesc檔案。在這種情況下，將在專案的根目錄下建立debug.jardesc檔案。設定完成後，我們按「 Next 」：

客製化清單

在此視圖中，我們可以透過選擇「 Use existing manifest from workspace 」選項來產生或選擇現有清單檔案。但是，在這種情況下，我們會建立一個預設清單檔案。

至此，我們就完成了，我們按「 Finish 」。文件創建後，我們可以在Package Explorer中看到它：

.jardesc

現在，每次需要建立 JAR 文件時，我們都會雙擊該文件，它會向我們顯示選項對話框：

JAR

值得注意的是，它會記住我們在創建 JAR 檔案時最初選擇的所有選項。我們可以更改這些選項並按“ Finish ”以在指定位置生成 JAR。

2.2. `.jardesc`的結構

.jardesc檔案是標準 XML 檔案：

<?xml version="1.0" encoding="UTF-8" standalone="no"?>

 <jardesc>

 <jar path="C:/Users/Haidar Ali/Documents/md2epub.jar"/>

 <options buildIfNeeded="true" compress="true" descriptionLocation="/md2epub/debug.jardesc"

 exportErrors="true" exportWarnings="true" includeDirectoryEntries="false" overwrite="true"

 saveDescription="true" storeRefactorings="false" useSourceFolders="false"/>

 <storedRefactorings deprecationInfo="true" structuralOnly="false"/>

 <selectedProjects/>

 <manifest generateManifest="true" manifestLocation="" manifestVersion="1.0" reuseManifest="false"

 saveManifest="false" usesManifest="true">

 <sealing sealJar="false">

 <packagesToSeal/>

 <packagesToUnSeal/>

 </sealing>

 </manifest>

 <selectedElements exportClassFiles="true" exportJavaFiles="false" exportOutputFolder="false">

 <folder path="/md2epub/src"/>

 <folder path="/md2epub/target"/>

 ...

 </selectedElements>

 </jardesc>

我們可以毫無問題地更改這些選項。更好的是，我們可以創建此文件的副本，針對預設.jardesc配置進行調整，並在新專案中使用該文件。

這種做法確實非常有成效。然而，它也有一些限制。限制之一是無法向檔案名稱新增動態資訊。例如，我們無法在檔案名稱中新增內部版本號或日期。因此，我們必須手動添加此資訊。

3. 使用 Ant Builder 建立 JAR

在 Eclipse 中，我們可以建立自訂建構器，以便在專案建置期間執行自動化任務。對於我們的用例，我們將定義一個 Ant Builder，它在專案建置期間建立 JAR 檔案。

首先，我們需要透過前往New → File在工作區根目錄中建立一個build.xml檔：

<?xml version="1.0" ?>



 <!-- Build file for creating JAR file -->

 <project name="md2epub" default="CreateJar">

 <target name="CreateJar" description="Create JAR file">

 <!-- JAR Options -->

 <jar jarfile="debug.jar" basedir="." includes="*.class" />

 </target>

 </project>

該檔案指定 JAR 的基本項目資訊和選項。接下來，我們將透過前往File -> Properties來建立自訂 Ant Builder：

項目屬性