SWT/JFace项目打包与发行

第7章  项目打包与发行

       当项目完成后接下来的就是打包发行了，应用程序（Application）项目和Eclipse插件项目（plugin）的打包是不同的，本章将分别介绍两者的打包方法，并给出实际的打包例子。

7.1  应用程序项目的打包与发行

7.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是版本号）复制到程序运行目录，否则程序将无法运行。

7.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包

7.1.3  其他得到JAR包的方式

       要得到JAR包除了以上所说的用Eclipse“导出”向导、用WinZip和