编程之道

无论是批评的,赞扬的,指着的都请EMAIL给我,你的建议将是我前进的动力! 联系我

[转]用Ant来打包

21.3  Ant 来打包

Eclipse 内置了 Ant Ant 是一种类似于批处理程序的软件包,它主要繁琐的工作是编写和调试自动处理脚本(一个 XML 文件),但只要有了这个脚本,我们就可以一键完成所有的设定工作。

本节还是以 myswt 这个应用程序项目的打包为例,用 Ant 来完成“编译->打成 JAR 包->复制项目引用库->复制本地化文件 swt-win32-3063.dll ->输出 API 文档”这五步。

1 、在 myswt 项目根目录下,创建最主要的 build.xml 文件

<? xml version="1.0" ?>

< project  name ="myswt project"  default ="api_doc" >

    
<!--  定义目录变量  -->

    
< property  name ="src.dir"  value ="src"   />

    
< property  name ="bin.dir"  value ="bin"   />

    
< property  name ="eclipse_plugins.dir"  value ="c:/eclipse/plugins"   />

    
< property  name ="dist.dir"  value ="d:/dist"   />

    
< property  name ="doc.dir"  value ="${dist.dir}/api"   />

    
< property  name ="swt.dll"  value ="swt-win32-3063.dll"   />

    
<!--  定义编译文件时所引用的库  -->

    
< path  id ="master-classpath" >

        
< fileset  dir ="${eclipse_plugins.dir}"  id ="project_lib" >

            
< include  name ="org.eclipse.ui.workbench_3.0.1/workbench.jar" />

            
< include  name ="org.eclipse.swt.win32_3.0.1/ws/win32/swt.jar" />

            
< include  name ="org.eclipse.jface_3.0.0/jface.jar" />

            
< include  name ="org.eclipse.osgi_3.0.1/osgi.jar" />

            
< include  name ="org.eclipse.osgi_3.0.1/core.jar" />

            
< include  name ="org.eclipse.osgi_3.0.1/resolver.jar" />

            
< include  name ="org.eclipse.osgi_3.0.1/defaultAdaptor.jar" />

            
< include  name ="org.eclipse.osgi_3.0.1/eclipseAdaptor.jar" />

            
< include  name ="org.eclipse.osgi_3.0.1/console.jar" />

            
< include  name ="org.eclipse.core.runtime_3.0.1/runtime.jar" />

            
< include  name ="org.eclipse.jface.text_3.0.1/jfacetext.jar" />

            
< include  name ="org.eclipse.ui.workbench.compatibility_3.0.0/compatibility.jar" />

        
</ fileset >

    
</ path >



    
<!--  首任务(空) -->

    
< target  name ="init" />

    
<!--  编译  -->

    
< target  name ="compile"  depends ="init" >

        
< delete  dir ="${bin.dir}" />

        
< mkdir  dir ="${bin.dir}" />

        
<!-- 编译源程序 -->

        
< javac  srcdir ="${src.dir}"  destdir ="${bin.dir}"  target ="1.4" >

            
< classpath  refid ="master-classpath" />

        
</ javac >

        
<!-- 复制图标目录 -->

        
< mkdir  dir ="${bin.dir}/icons" />

        
< copy  todir ="${bin.dir}/icons" >

            
< fileset  dir ="icons" />

        
</ copy >

    
</ target >

    
<!--  打包  -->

    
< target  name ="pack"  depends ="compile" >

        
<!--  bin目录压缩成JAR包  -->

        
< delete  dir ="${dist.dir}" />

        
< mkdir  dir ="${dist.dir}"   />

        
< jar  basedir ="${bin.dir}"  destfile ="${dist.dir}/myswt.jar"  manifest ="ant_manifes.txt" >

            
< exclude  name ="**/*Test.*"   />

            
< exclude  name ="**/Test*.*"   />

        
</ jar >

        
<!--  复制用到的库  -->

        
< mkdir  dir ="${dist.dir}/lib"   />

        
< copy  todir ="${dist.dir}/lib" >

            
< fileset  refid ="project_lib" />

        
</ copy >

        
<!--  复制本地化文件  -->

        
< copy  todir ="${dist.dir}"  file ="${swt.dll}" />

    
</ target >

    
<!--  输出api文档  -->

    
< target  name ="api_doc"  depends ="pack" >

        
< delete  dir ="${doc.dir}" />

        
< mkdir  dir ="${doc.dir}"   />

        
< javadoc  destdir ="${doc.dir}"  author ="true"  version ="true"  use ="true"  windowtitle ="MySWT API" >

            
< packageset  dir ="${src.dir}"  defaultexcludes ="yes" />

            
< doctitle > <![CDATA[ <h1>MySWT Project</h1> ]]> </ doctitle >

            
< bottom > <![CDATA[ <i>Document by ChenGang 2005.</i> ]]> </ bottom >

        
</ javadoc >

    
</ target >

</ project >



代码说明:

1 property 项是定义变量,比如 <property name="swt.dll" value="swt-win32-3063.dll" /> ,就是定义一个变量: swt.dll=swt-win32-3063.dll 。以后用这个变量则是这样: ${swt.dll}

一般尽量将今后可能会变动的目录、文件等定义成变量,以方便维护。不象 Java 变量有类型的区分, Ant 变量是不区别目录、文件等的,所以为了见名知意,在取变量名时,目录都加“ dir ”后缀,这个后缀是可以任取名的。

下面给出本例用到的变量的含义:

l           src.dir Java 源文件路径。 value="src" src 是一个相对路径,它相对的是 build.xml 的所在目录位置(即项目根目录)。

l           bin.dir Java 编译文件的输出路径

l           eclipse_plugins.dir eclipse plugins 目录

l           dist.dir 打包文件的存放目录

l           doc.dir API 文档的存放目录,这里用到了 dist.dir 变量,直接写 value="d:/dist/api" 也未尝不可。

l           swt.dll SWT 本地化文件。

2 <path id="master-classpath"> ,定义编译文件时所引用的库,相当于 classpath <fileset> 项表示一个文件集,再深入一层的 <include> 项,则表示此文件集下的文件,它们的路径定位相对于 <fileset> dir 属性。 <fileset> 还有一个 id 属性,在后面复制引用库时会用到。

也许有读者会问:“你是怎么知道要引用这些文件的?”回答:看项目根目录下的“ .classpath ”文件,就可以知道本项目要引用那些库了。实际上笔者是把 .classpath 复制一份后,然后用 Editplus 编辑而得。

3 )接下来开始定义一些任务。首任务一般都让它为空(没有具体任务内容): <target name="init"/>

4 Ant 中的任务有着相互的依赖( depends )关系,这些依赖关系是通过 depends 属性来定义的。当要执行一个任务时, Ant 先去执行这个任务的 depends 任务,……, Ant 就这样一直往回找下去。比如:在本例的第二行 default="api_doc" ,它定义了缺省任务是 api_doc (输出 api 文档)->此任务的 depends = pack (打包)-> pack depends = compile (编译)-> compile depends=init (首任务), init 没有 depends 。于是, Ant 就从 init 开始依次往回执行任务: init -> compile -> pack -> api_doc

如果你不想“输出 api 文档”,则将第二行的缺省任务定义成 default="pack" 即可,这时整个任务链就抛开了 api_doc

5 <delete dir="${bin.dir}"/> 删除目录。 <mkdir dir="${bin.dir}"/> 新建目录

6 )编译源程序,如下

<javac srcdir="${src.dir}" destdir="${bin.dir}" target="1.4">

    <classpath refid="master-classpath"/>

</javac>

l           srcdir 源文件目录,其子目录中的源文件也会被 javac.exe 编译。

l           destdir 编译文件输出目录。

l           target JDK1.4 为编译目标。

l           classpath 编译的 classpath 设置, refid 是指引用前面设定的 master-classpath

7 )将 icons (即 myswt/icons )目录的文件,复制到 myswt/bin/icons 目录中,如下:

<copy todir="${bin.dir}/icons">

    <fileset dir="icons"/>

</copy>

8 )将文件打成 JAR

<jar basedir="${bin.dir}" destfile="${dist.dir}/myswt.jar" manifest="ant_manifes.txt">

    <exclude name="**/*Test.*" />

    <exclude name="**/Test*.*" />

</jar>

l           basedir 源目录。

l           destfile 目标目录和打成 JAR 包名。

l           manifest 打包清单文件(后面给出其内容)。

l           exclude 使用了通配符将某一些文件排除不打包(主要是一些测试文件)。

9 )如下,将 project_lib 的文件复制到 d:/dist/lib 目录中。 project_lib 是前面“定义编译文件时所引用的库”中的文件集的 id 。结果参数下图 21.25

<copy todir="${dist.dir}/lib">

    <fileset refid="project_lib"/>

</copy>

10 )将本地化文件复制到 d:/dist 目录中,如下:

<copy todir="${dist.dir}" file="${swt.dll}"/> 

11 )输出 API 文档(结果参数下图 21.26

<javadoc destdir="${doc.dir}" author="true" version="true" use="true" windowtitle="MySWT API">

    <packageset dir="${src.dir}" defaultexcludes="yes"/>

    <doctitle><![CDATA[<h1>MySWT Project</h1>]]></doctitle>

    <bottom><![CDATA[<i>Document by ChenGang 2005.</i>]]></bottom>

</javadoc>

l           destdir 目标路径 d:/dist/api

l           packageset 源文件目录

l           doctitle 标题

l           bottom 标尾。

2 、创建打包清单

为了避免和原来的 manifes.txt 同名,在项目根目录建立一个名为 ant_manifes.txt 的文件。这个文件内容中最长的是 Class-Path 项,没有必要一个个字符的敲入,它可以由项目根目录下的“ .classpath ”编辑而得。


-----------------------------------------------------------------
一片很不错的文章
http://dev.csdn.net/article/72718.shtm

posted on 2005-09-26 14:14 疯流成性 阅读(332) 评论(0)  编辑  收藏 所属分类: 转贴区


只有注册用户登录后才能发表评论。


网站导航: