Java 應用程式打包部署簡化指南：JAR、Manifest 與版本管理實戰

JAR 檔案與 Manifest 角色

JAR 本質為 ZIP 格式的 class 檔案封裝，廣泛相容各類工具。但 ZIP 本身無法表達應用程式中繼資料，故引入 META-INF/MANIFEST.MF 提供：

• 封裝內容描述
• 執行期資訊（主類別、類別路徑、版本資訊）

預設 Manifest 僅含版本與建構工具資訊，實用性有限：

Manifest-Version: 1.0
Created-By: 1.4.0-beta (Sun Microsystems Inc.)

Manifest 格式規範

• 名值對格式：屬性名: 屬性值
• 每行上限 72 字元，續行以空格開頭
• 開頭屬性為全域屬性，可定義特定套件/類別屬性

自訂 Manifest 整合至 JAR

命令列：

jar cvfm myapp.jar myapp.mf -C classdir .

Ant 建構：

<target name="jar">
  <jar jarfile="myapp.jar" manifest="myapp.mf">
    <fileset dir="classdir" includes="**/*.class"/>
  </jar>
</target>

核心 Manifest 屬性實戰

主類別指定 — 簡化啟動指令

Manifest-Version: 1.0
Created-By: JDJ example
Main-Class: com.example.myapp.MyAppMain

啟動指令從 java -classpath myapp.jar com.example.myapp.MyAppMain 簡化為 java -jar myapp.jar。

Class-Path 管理依賴 JAR — 解決跨平台路徑問題

Manifest-Version: 1.0
Main-Class: com.example.myapp.MyAppMain
Class-Path: mail.jar activation.jar

關鍵優勢：

• 空格分隔多個 JAR（非平台相依的冒號/分號）
• 路徑統一使用正斜線 /（跨平台相容）
• 相對路徑基準為 JAR 檔案所在目錄
• 特殊字元以 URL 編碼表示（空格 → %20）

多主類別架構設計

策略：共享類別打包為 myapplib.jar，不同進入點分別打包：

# myapplib.jar
Manifest-Version: 1.0
Class-Path: mail.jar activation.jar

# myappconsole.jar
Manifest-Version: 1.0
Class-Path: myapplib.jar
Main-Class: com.example.myapp.MyAppMain

# myappadmin.jar
Manifest-Version: 1.0
Class-Path: myapplib.jar
Main-Class: com.example.myapp.MyAdminTool

套件版本資訊與查詢

Manifest 中定義規格與實作版本

Name: com/example/myapp/
Specification-Title: MyApp
Specification-Version: 2.4
Specification-Vendor: example.com
Implementation-Title: com.example.myapp
Implementation-Version: 2002-03-05-A
Implementation-Vendor: example.com

執行期查詢 API

• Package.getPackages()：取得所有已定義套件
• Package.getPackage(String name)：依名稱取得套件
• Class.getPackage()：取得類別所屬套件

注意：套件下無類別被載入時無法取得 Package 物件。

Manifest 撰寫最佳實踐

1. 首行必為 Manifest-Version
2. 行長 ≤ 72 字元，超長續行
3. 每行以換行符結尾，否則被忽略
4. Class-Path 路徑統一用 / 分隔目錄
5. 空行分隔主屬性與套件屬性區塊
6. 套件名稱用 / 分隔且以 / 結尾（如 com/example/myapp/）
7. 類別以 .class 結尾