为什么要先介绍install.xml这个文件呢,因为这个文件太重要了,地位犹如Ant中的build.xml,maven中的pom.xml。install.xml直接定义了安装包的界面、显示窗口、使用的类、语言等等。弄懂了install.xml,就可以很轻松的定制自己的安装程序。
- <?xml version="1.0" encoding="utf-8" standalone="yes" ?>
- <!--
- A sample installation file.
- Use it as a base for your own installers :-)
- To compile it :
- - go in the bin directory where you installed IzPack
- - call "compile ../sample/install.xml -b ../sample"
- -->
- <installation version="1.0">
- <!--
- 程序基本信息
- -->
- <info>
- <appname>台站系统</appname>
- <appversion>1.0</appversion>
- <authors>
- <author name="**" email=""/>
- <author name="**" email=""/>
- </authors>
- <url>http://csdn.net</url>
- <javaversion>1.6</javaversion>
- </info>
- <!--
- 安装程序窗口大小、字体大小、间距等设置
- -->
- <guiprefs width="640" height="480" resizable="no">
- <laf name="looks">
- <os family="windows" />
- <param name="variant" value="windows" />
- </laf>
- <laf name="substance">
- <os family="windows" />
- <param name="variant" value="business-blue" />
- </laf>
- <modifier key="useButtonIcons" value="yes"/>
- <modifier key="labelFontSize" value="1.5"></modifier>
- <modifier key="layoutAnchor" value="CENTER"/>
- <modifier key="useLabelIcons" value="yes"/>
- <modifier key="useHeadingPanel" value="yes"/>
- <modifier key="headingBackgroundColor" value="0x00ffffff"/>
- <modifier key="headingPanelCounter" value="progressbar"/>
- <modifier key="headingPanelCounterPos" value="inNavigationPanel"/>
- <modifier key="allYGap" value="4"/>
- <modifier key="paragraphYGap" value="10"/>
- <modifier key="filler1YGap" value="5"/>
- <modifier key="filler3XGap" value="10"/>
- </guiprefs>
- <!--
- The locale section.
- Asks here to include the English and French langpacks.
- 语言选项
- -->
- <locale>
- <langpack iso3="chn"/>
- </locale>
- <!--
- The resources section.
- The ids must be these ones if you want to use the LicencePanel and/or the InfoPanel.
- 引入的资源
- -->
- <resources>
- <res id="userInputSpec.xml" src="userInputSpec.xml"/>
- <res id="ProcessPanel.Spec.xml" src="ProcessPanel.Spec.xml"/>
- <res id="shortcutSpec.xml" src="shortcutSpec.xml"/>
- </resources>
- <!--
- The panels section.
- We indicate here which panels we want to use. The order will be respected.
- 需要哪些panel,panel就是窗口,列出的顺序也是显示的顺序
- -->
- <panels>
- <panel classname="HelloPanel"/>
- <panel classname="TargetPanel"/>
- <panel classname="PacksPanel"/>
- <panel classname="UserInputPanel" id="jdbc.parameters">
- <validator classname="ConnectionValidation"/>
- </panel>
- <panel classname="InstallPanel"/>
- <panel classname="UserInputPanel" id="station.parameters"/>
- <panel classname="ProcessPanel"/>
- <panel classname="ShortcutPanel"/>
- <panel classname="FinishPanel"/>
- </panels>
- <!-- 设置常量 -->
- <variables>
- <variable name="InstallerFrame.logfilePath" value="$INSTALL_PATH/log/install.log" />
- <variable name="DesktopShortcutCheckBoxEnabled" value="true" />
- </variables>
- <!-- 引入自定义类和第三方jar -->
- <jar src="station_test.jar" stage="install"/>
- <jar src="jtds-1.2.4.jar" stage="install"/>
- <jar src="ibatis2-common-2.1.7.597.jar" stage="install"/>
- <!-- 引入本地类库,创建快捷方式时需要用到 -->
- <native type="izpack" name="ShellLink.dll"/>
- <native type="izpack" name="ShellLink_x64.dll"/>
- <!--
- The packs section.
- We specify here our packs.
- 需要打包的文件或文件夹,以及打包的地址
- -->
- <packs>
- <pack name="tomcat" required="yes">
- <description>tomcat server</description>
- <file src="../tomcat7" targetdir="$INSTALL_PATH"/>
- <!-- The file will be parsed -->
- </pack>
- <pack name="station" required="yes">
- <description>station</description>
- <file src="../station" targetdir="$INSTALL_PATH"/>
- <!-- Reccursive adding -->
- </pack>
- </packs>
- </installation>
上面是一个install.xml文件一个例子,其中添加了一些注释,下面详细讲一下各个标签的使用和作用:
- info标签:这个标签里包含了很多子标签,主要描述被安装的程序的基本信息,比如作者、使用的java版本等等,这些信息会展示在HelloPanel这个面板上
- guiprefs标签:这个标签里定义了安装程序窗口的大小、字体大小、各个面板上标签之间的X和Y方向间距、进度条的展示、按钮图片、窗口颜色等等
- locale标签:这个标签主要用于国际化,可以定义很多语言,供用户选择
- resources标签:这个标签主要用来引入自己的自定义资源,比如用户协议文档、用户输入面板、自定义处理面板等等
- panels标签:这个标签很重要,也是接下来讲述的重点,也是我们最关心的,这个标签里面定义了很多panel,每个panel就是我们熟悉的安装程序中的一步,点击上一步或者下一步可以跳到另一面板,因此这里定义的panel有顺序性,第一个panel标签就是安装程序第一个面板。IzPack提供了很多panel,有很多可以直接使用,像HelloPanel,有些需要自定义,比如UserInputPanel,我们的主要任务就是根据自己的需求,引入不同的panel,编写自己的panel。其实大家用的最多还是用户输入面板(UserInputPanel)和处理面板(ProcessPanel),后面会详细介绍这两个的使用
- packs标签:这里定义了安装程序需要把哪些文件安装到用户电脑中,每个pack标签都定义了一个安装任务,可以通过属性required来定义是否必须选择,或者由用户选择。上面例子中<file src="../station" targetdir="$INSTALL_PATH"/>这句话是关键,定义了需要把上级目录的station文件夹安装到用户指定的安装目录,其中$INSTALL_PATH就是指用户选择的安装目录。当编译这个安装包时,会把这些指定的文件或文件夹打包放在安装包中,当用户点击安装时,直接从安装包解压复制到安装目录,复制的操作是在InstallPanel这个面板出现时进行,因此缺少这个panel,将不会把文件安装到指定目录,并且要注意InstallPanel在所有panels中的位置,因为有时我们需要动态修改安装后的文件,要使用$INSTALL_PATH来访问安装后的文件,如果还没有到InstallPanel,那么安装目录里什么文件都没有,我们将无法访问。