Eclipse程序打包

    當項目完成後接下來的就是打包發行了,應用程序(Application)項目和Eclipse插件項目(plugin)的打包是不同的,本章將分別介紹兩者的打包方法,並給出實際的打包例子。

1.1  簡介

       Java應用程序項目完成後是可以脫離Eclipse運行的,要運行程序先要打它打成一個JAR包,它打包的大部份方法和標準Java的AWT/SWING的打包方法一樣,主要有以下幾個要點

l           MANIFEST.MF -  打包清單。它是打包的關鍵性文件,主要是設置執行入口類和支持庫的路徑,在運行Java應用程序時是要根據此文件中給出的信息來查找入口類和支持庫。

l           支持包 -如果Java應用程序用到了一些Eclipse包,那麼就必須將這些包也複製到程序運行目錄,否則程序將無法運行。如swt組件支持包swt.jar,jface組件支持包jface.jar。這些包都要在MANIFEST.MF文件中設置好。

l           本地化文件 - 如果用到了SWT組件,則還需要將SWT的本地化文件swt-win32-3063.dll(3063是版本號)複製到程序運行目錄,否則程序將無法運行。

1.2  打包的具體操作步驟

本節將用前幾章開發的SWT/JFace項目“myswt”的打包爲例,來介紹打包應用程序項目的方法。

1、編輯清單MANIFEST.MF

(1)Eclipse提供了用於打包項目的“導出”嚮導,但本例運行此嚮導之前先需要創建一個MANIFEST.MF清單文件,其內容如下:

Manifest-Version: 1.0

Main-Class: book.chapter_4.wizard_dialog.WizardDialog1

Class-Path: ./lib/swt.jar ./lib/jface.jar ./lib/runtime.jar

說明:

l           Manifest-Version - 指定清單文件的版本號

l           Main-Class - 指定程序運行的入口類。本例設爲運行4.5.2節開發的嚮導式對話框。注意:類名後不要加class擴展名

l           Class-Path - 指定支持庫的路徑。“.”指程序運行目錄,即導出的JAR包所在目錄。程序運行時依據Class-Path項的設置路徑來查找支持庫。每一個支持庫之間用空格隔開。在這裏jface.jar需要用到runtime.jar包,所以runtime.jar包也要加入到Class-Path中。

l           除了入口類的包名和類名之外,其他設置項都不分大小寫,比如:Class-Path寫成class-path或CLASS-PATH也可以,swt.jar寫成SWT.JAR也行。

(2)將清單文件保存下來,建議放在myswt項目的根目錄下。它的文件名可以任意取,本例取名爲manifes.txt,Eclipse嚮導在打包時會自動的將manifes.txt的內容複製到JAR包的META-INF目錄下的MANIFEST.MF文件中。

2、使用Eclipse“導出”嚮導來打包項目

(1)右鍵單擊myswt項目的項目名,在彈出菜單中選擇“導出”。在彈出的如下圖7.1所示的對話框中,選擇“JAR文件”,單擊“下一步”。

圖7.1  導出對話框

(2)如下圖7.2所示,將右邊不需要的文件都取消勾選。在“選擇導出目標”項文本框中設置JAR包的輸出路徑和包名(可以任意取名)爲“D:\myswt_application\myswt.jar”。接受其他的默認設置不變,單擊“下一步”。

附註:左邊雖然選擇了src目錄,但源文件並不會導出到包中,除非勾選了“導出Java源代碼文件和資源”項。

圖7.2  選擇導入文件

(3)如下圖7.3所示,接受默認設置不變,單擊“下一步”。

圖7.3  導出類的選項

(4)這一步較關鍵。如下圖7.4所示,選擇“從工作空間中使用現有清單”項,將創建的清單文件輸入,也可以通過旁邊的“瀏覽”按鈕來選擇清單文件。輸入清單文件後,單擊“完成”,Eclipse開始將項目打包。

圖7.4  清單文件設置

       經過以上四步後,在“D:\myswt_application”路徑下生成了一個名爲“myswt.jar”的文件。myswt.jar是一個ZIP格式的壓縮文件,可以用WinRAR或WinZip軟件打開,也就是說用這兩個軟件也可以替代Eclipse嚮導來打包文件。如果用WinRAR來打包文件,則壓縮格式要選擇ZIP格式而非RAR格式,壓縮率倒可以任意選。

用WinRAR打開myswt.jar文件後其內部的目錄結構如下圖7.5所示:

圖7.5  myswt.jar文件的內部目錄結構

       在myswt.jar文件的內部目錄META-INF中僅一個文件:MANIFEST.MF,它和以前創建的清單文件manifest.txt的內容是一樣的,如下:

Manifest-Version: 1.0

Class-Path: ./lib/swt.jar ./lib/jface.jar ./lib/runtime.jar

Main-Class: book.chapter_4.wizard_dialog.WizardDialog1

3、複製Java應用程序的支持包及本地化文件

在MANIFEST.MF文件中的Class-Path項設置了三個包,從Eclipse的plugins目錄中將此三個支持包複製到D:\myswt_application\lib目錄,本地化文件swt-win32-3063.dll複製到D:\myswt_application目錄中。此三個文件在Eclipse中的路徑爲:

plugins\org.eclipse.swt.win32_3.0.1\ws\win32\swt.jar

plugins\org.eclipse.jface_3.0.0\jface.jar

plugins\org.eclipse.core.runtime_3.0.1\runtime.jar

plugins\org.eclipse.swt.win32_3.0.1\os\win32\x86\swt-win32-3063.dll

       複製完成後的目錄結構如下圖7.6所示:

圖7.6  目錄結構圖

4、編寫運行myswt.jar包的批處理程序“run.bat”

在myswt_application目錄下創建一個批處理程序run.bat(名字任取,擴展名必須是bat),其內容僅一句語句,如下:

javaw -jar myswt.jar

       說明:

l           javaw對應c:\jdk\jre\bin\javaw.exe文件,如果windows提示命令未發現,則需要將c:\jdk\jre\bin路徑加入到windows環境變量path中。

l           在運行程序的時候有一個討厭的黑色命令行窗口,要去掉它,可以將run.bat內容更改如下:“start javaw -jar myswt.jar”,start是指調用了windows的“運行”命令。

l           如果想將swt-win32-3063.dll也放在單獨的目錄中,如“D:\myswt_application\native”目錄,則需將run.bat內容更改爲:

start javaw -Djava.library.path=./native/ -jar myswt.jar

5、運行程序

雙擊run.bat文件,得到如下圖7.7所示的程序界面。

圖7.7  程序運行效果圖

6、注意事項

本例只需要三個支持包,但你的程序也許會需要更多的支持包才能運行。如果你想一次到位,則可以將“Java構建路徑”的“庫”選項卡中所有引用的包都複製到lib目錄中。如果你喜歡用到什麼包才加入什麼包,希望維持打包文件的簡潔,則需要自己一步步的去試:如果缺少某支持包,運行程序時會輸出的未找到類的錯誤信息,從信息中的包名可得知程序缺少哪一個支持包。比如“Exception in thread "main" java.lang.NoClassDefFoundError: org/eclipse/jface/wizard/IWizard”,從錯誤信息中很明顯的就能知道程序缺少jface包

1.3  其他得到JAR包的方式

       要得到JAR包除了以上所說的用Eclipse“導出”嚮導、用WinZip和WinRAR,另外還能用Java自帶的命令行式打包軟件jar.exe(位於c:\jdk\bin目錄),其打包命令爲:

c:\jdk\bin\jar cvfm myswt.jar C:\eclipse3.0.1\eclipse\workspace\myswt\manifest.txt -C C:\eclipse3.0.1\eclipse\workspace\myswt\bin .

       說明:

l           c:\jdk\bin\jar - 由於本書沒有把c:\jdk\bin加入到windows環境變量path中,所以手工指定jar.exe的路徑

l           cvfm - jar.exe的參數,“c”創建新的jar包;“v”將調試信息打印在屏幕上;“f”指定生成的jar文件名;“m”使用清單文件。注意它們都是小寫

l           myswt.jar - 打包後的JAR包名

l           在前面是把清單文件manifest.txt放在C:\eclipse3.0.1\eclipse\workspace\myswt\目錄下。如果將它和批處理文件放在一個目錄就不必指定長長的路徑了。

l           “-C 路徑 . ”指將路徑下(包括子目錄)的所有文件打包,由於class文件是輸出在項目的bin目錄下,所以路徑指定到項目的bin目錄,注意三者之間是用空格隔開,並且最後一個字符是小數點。

這種方式的優點是沒有Eclipse導出嚮導的操作那麼麻煩,適合經常需要導出JAR包的情況。

7.1.4  使用第三方插件對項目打包

開源組織(http://sourceforge.net/)中有一款可將Eclipse支持包和項目編譯文件一起打到一個包中的插件,叫“Fat Jar”,它的下載地址是“http://fjep.sourceforge.net/”,具體下載不再說明,安裝步驟參閱第1章SWT Designer的安裝。

Fat Jar的使用步驟如下:

(1)右鍵單擊myswt項目的項目名,可見菜單中多了一項“Build Fat Jar”,如下圖7.8所示,選擇“Build Fat Jar”項。

圖7.8  右鍵菜單

(2)在下圖7.9所示的對話框中,“Jar-Name”項填入JAR包的輸出路徑。文件清單“Manifest”項不用填,默認會自動創建一個。“Main-Class”項填入程序的入口類。其他都接受默認值,單擊“下一步”。

圖7.9  輸出配置

       (3)如下圖7.10所示,窗口中將myswt項目所用到的支持包都列了出來。我們僅勾選圖中runtime.jar、swt.jar、jface.jar這三項即可,當然全選也並嘗不可,只是最後得到的JAR包會更大一些,因爲Fat Jar會將所有支持包合併在一個JAR包中。

圖7.10  選擇要打包的文件

單擊圖7.10的“完成”按鈕後, JAR包myswt.jar將輸出到D:\myswt_applicationh目錄中。和以前一樣,要運行此JAR包需要一個批處理文件以及本地化文件swt-win32-3063.dll,唯一不同的是不再需要Eclipse支持包,其目錄結構如下圖7.11所示:

圖7.11  目錄結構

       爲什麼不需要Eclipse支持包了呢?那是因爲支持包已經在myswt.jar文件中了,從下圖7.12可以看到swt.jar等都被拆散成目錄,幷包含在myswt.jar包中。

圖7.12  myswt.jar的內部目錄結構

       其中META-INF目錄的MANIFEST.MF文件內容如下,可以發現和以前不同的地方是:Class-Path項沒有了。

Manifest-Version: 1.0

Created-By: Fat Jar Eclipse Plug-In

Main-Class: book.chapter_4.wizard_dialog.WizardDialog1

1.4  讓用戶電腦不必安裝JRE環境

       通常運行Java程序有個前提條件:用戶電腦必須先安裝JRE環境。雖然安裝JRE環境非常簡單,但畢竟多了一步,算是有一點點的瑕疵。這裏給出一個不必讓用戶安裝JRE環境的方法,其實現步驟如下:

       (1)將原JDK中的“jre”目錄複製到“D:\myswt_application\java1.4.2”目錄下(java1.4.2也可換成其他名稱)。

(2)將JDK和JRE從本機卸載掉,這樣表示本機沒有安裝JAVA運行環境。

(3)修改批處理文件run.bat中的命令爲“start java1.4.2\jre\bin\javaw -jar myswt.jar”,僅僅是在javaw前加上了一個相對應路徑。

雙擊run.bat即可在不安裝JRE環境的電腦運行此Java應用程序。

1.5  更進一步的完善

1、拋棄批處理文件(*.bat)

用批處理文件運行程序似乎不夠專業,雖然它足以完成運行任務。但習慣就象一種毒藥一旦染上就很難擺脫它的影響,Windows統治下的人們早已經習慣運行擴展名是EXE的程序,用*.bat他們就會感覺彆扭。

我們可以用一個叫JavaLauncher的免費小程序來代替批處理文件去運行Java程序。JavaLauncher的下載網址是:

http://www.rolemaker.dk/nonRoleMaker/javalauncher/marner_java_launcher.htm

下載下來的文件是一個名JavaLauncher.zip的壓縮包,解壓後的目錄結構如下圖7.13所示:

圖7.13  JavaLauncher.zip目錄結構

在上圖的目錄中

l           source目錄包含了JavaLauncher的源程序,是用C語言寫的

l           changes.txt是新版的修改說明

l           launch.exe是主程序

l           launcher.cfg是配置文件

l           readme.txt是一些說明和示例

我們只需要launch.exe、launcher.cfg兩個文件,將這兩個文件複製到打包文件所在的目錄。launcher.cfg是一個僅三行內容的文本文件,將它修改如下:

.

.\java1.4.2\jre\bin\javaw.exe

-jar myswt.jar

l           第一行設置指向JAR包myswt.jar的目錄,由於launch.exe和myswt.jar同在一個目錄,所以用“.”即當前目錄。

l           第二行設置指向jre\bin\javaw.exe的路徑。在上一小節(7.1.4節)已將jre目錄複製到了java1.4.2子目錄中

配置好launcher.cfg後,雙擊launch.exe即可運行java應用程序。

如果仔佃研究eclipse的啓動方式,發現eclipse和JavaLauncher的原理一樣:eclipse.exe相當於launch.exe,startup.jar相當於myswt.jar。只不過eclipse.exe不象launch.exe要具有通用性,所以它沒有*.cfg這樣的配置文件,而是將啓動信息固化在eclipse.exe中。

2、美化圖標

launch.exe文件的圖標太單調了,讓我們給它換個好看點的。換程序的圖標需要用到一個免費的軟件:Resource Hacker,它有中文版,下載網址是:

http://www.users.on.net/johnson/resourcehacker/

用Resource Hacker來替換launch.exe的圖標的步驟如下:

(1)運行Resource Hacker,得到如下圖7.14所示的窗口。

圖7.14  Resource Hacker的主界面

(2)單擊主菜單“文件→打開”,將launch.exe載入到程序中,結果如下圖7.15所示。

圖7.15  載入Lanunch.exe之後的界面

(3)如上圖,選擇左邊的“圖標→1→1030”,然後右鍵單擊“1030”項,選擇“替換資源…”。如下圖7.16所示,在彈出窗口中單擊“打開新圖標文件”,選擇一個滿意的圖標,然後單擊“替換”按鈕。

附註:圖標文件可以是exe、dll、res、ico,該軟件可以從exe、dll、res抽取出圖標,本例選擇的是java的一個圖標文件JavaCup.ico。

圖7.16  選擇圖標文件

(4)如下圖7.17所示,選擇“文件→另存爲”,取名myswt.exe。

附註:按理說選擇“保存”也是可以的,這時Resource Hacker會將老的launch.exe備份成launch_original.exe。但也許是刷新上有問題,用“保存”方式有時launch.exe無法顯示出新圖標,但有時又可以。

圖7.17  保存修改

(5)最後的目錄如下圖7.18所示,可見myswt.exe(也就是launch.exe改了個名稱)的圖標換成了Java的圖標。雙擊myswt.exe即可運行Java應用程序。

圖7.18  最後的效果

3、最後的打包

發送給用戶之前,通常要用WinZip或WinRAR將所有的文件全部打成一個壓縮包,然後用戶得到這個壓縮包後,將其解壓縮後即可運行程序,Eclipse軟件就是這種方式。

另一種方式是用InstallShield、InstallAnyWhere這樣的安裝程序製作軟件來創建一個單一的setup.exe文件,它具有嚮導式的安裝界面,而且還可以往windows的程序欄插入菜單項,關於這些安裝程序製作軟件的具體使用請參閱相關書籍。 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章