Antenna支持J2me

Antenna基于Ant,是一个开源的J2me开发工具,有点类似于批处理,但是要比批处理功能强大的的多. 
Antenna常用功能 
      WtkJad                 生成Jad文件 
      WtkBuild             编译j2me项目 
      WtkPackage         打包 
      WtkMakePrc         将Jad/Jar转换成可以PalmOS上可以运行的PRC文件格式 
      WtkRun                 启动模拟器 
      WtkPreverify     预校验 
      WtkObfuscate     混淆,需要指定混淆器(proguard/retroguard) 
      WtkPreprocess   预处理     

下面是一个简单的编译文件,编译wtk自带例子audiodemo 

<?xml   version= "1.0 "?> 
<project   name= "audiodemo "   default= "build "   basedir= ". "> 

<!--   指定WTK目录   --> 
<property   name= "wtk.home "   value= "c:\Java\wtk-2.1 "   /> 
                  <!--   指定MIDP   --> 
<property   name= "wtk.midp.version "   value= "2.0 "   /> 
                  <!--   指定CLDC   --> 
<property   name= "wtk.cldc.version "   value= "1.0 "   /> 
                  <!--   指定支持mmapi多媒体包--> 
<property   name= "wtk.mmapi.enabled "   value= "true "   /> 

<!--   指定项目属性   --> 
                  <!--   指定MIDlet名字   --> 
<property   name= "midlet.name "   value= "audiodemo "   /> 
                  <!--   指定项目目录   --> 
<property   name= "midlet.home "   value= "${wtk.home}/apps/${midlet.name} "   /> 

<!--   载入Antenna任务定义   --> 

<taskdef   resource= "antenna.properties "   /> 
                  <!--   定义清理任务   --> 
<target   name= "clean "> 
                                      <!--   删除   classes   目录--> 
<delete   failonerror= "false "   dir= "classes "   /> 
                                    <!--   删除目录下的所有文件   --> 
<delete   failonerror= "false "> 
<fileset   dir= ". "> 
                                                                          <!--   除了 "build.xml "(文件本身)--> 
<exclude   name= "build.xml "   /> 
</fileset> 
</delete> 
</target> 
                  <!--   定义build任务--> 
<target   name= "build "> 

<!--   拷贝Jad文件过来   --> 

<copy   file= "${midlet.home}/bin/${midlet.name}.jad "   todir= ". "   /> 
                                    <!--   建立   classes   目录   --> 
<mkdir   dir= "classes "   /> 

<!--   编译,但是不预校验--> 

<wtkbuild   srcdir= "${midlet.home}/src "   destdir= "classes "   preverify= "false "   /> 

<!--   打包并预校验   --> 

<wtkpackage   jarfile= "${midlet.name}.jar "   jadfile= "${midlet.name}.jad "   preverify= "true "> 
<fileset   dir= "classes "   /> 
<fileset   dir= "${midlet.home}/res "   /> 
</wtkpackage> 
                                    <!--   启动模拟器   --> 
<wtkrun   jadfile= "${midlet.name}.jad "   device= "DefaultColorPhone "   wait= "true "   /> 
</target> 
</project> 

编译过程 
1.在IDE中,以Eclipse为例, 
        a.新建项目 
        b.将上面内容保存为   build.xml   放在项目的根目录下 
        c.eclipse中选中build.xml,右键,Run   As-->   Ant   build 
2.无IDE,需要Apache   Ant支持 
        a.到apache网站下载ant,安装,在环境变量path中增加   ant目录\bin 
            比如安装在c:\ant下,则添加   c:\ant\bin到path中 
        b.新建一个目录 
        c.将上面内容保存为   build.xml   放在目录下 
        d.打开dos窗口,cd到该目录 
        e.键入   ant,即可看到整个执行过程 

上面的例子只是个简单的应用,Antenna的最大好处是可以进行预处理,利用同一份代码,可以为不同的平台生成多个发布版本,关键是只需维护一套代码.如果有兴趣,将陆续发布Antenna的复杂应用.

相关网址 
1.Apache   Ant 
        http://ant.apache.org 
2.Antenna 
        http://sf.net/projects/antenna


//-------------------------------------------------------------------------------


Antenna支持

本文档描述EclipseME对Antenna构建文件的支持。 

Antenna概述 
配置 
生成Antenna构建文件 
自定义Antenna构建 

--------------------------------------------------------------------------------

Antenna概述
Antenna (http://antenna.sourceforge.net) 是Ant 的一个扩展项目。Antenna 提供了一套方便开发基于MIDP的无线JAVA程序的Ant任务。使用 Antenna,你可以进行编译，预校验，打包，混淆，运行你的MIDP程序以及生成JAD文件。另外它还可以把JAR文件转换成PRC格式，这是一种由Sun和IBM实现的可以在PalmOS上运行的MIDP格式。所以我们可以看到在Ant世界中Antenna可以完成很多工作，就好像EclipseME在IDE世界中一样。 

从0.6.0版本开始, EclipseME就可以自动生成和更新Antenna构建文件。 这使得 EclipseME用户可以轻松的将Antenna构建文件发布给非Eclipse用户。或者将Antenna与 EclipseME结合完成一些操作，比如将PRC格式的转换，这个功能EclipseME是不提供的。 另外这也使得EclipseME项目可以包含在一个大项目中进行自动构建。 

配置
在你使用EclipseME的自动生成Antenna构建文件的功能之前, 你必须首先告诉Eclipse Antenna的Jar文件在什么地方以及WTK的安装目录在什么地方。该配置项是 基本首选项的一部分。 

生成Antenna构建文件
为了准确的导出Antenna构建文件，你所需要做的是在Package Explorer窗口对工程点右键，然后选择J2ME选项的 Export Antenna Build Files子项。 

第一次完成该操作后，你的工程里被添加进来三个新文件: 

build.xml 
这是标准Ant构建文件。 如果你的工程原来没有 build.xml 文件，那么会新加一个进来。 
eclipseme-build.xml
这是所生成的Antenna构建文件。 
eclipseme-build.properties
该文件含有 eclipseme-build.xml 文件需要导入的属性。 
Eclipse内置了对Ant的支持，而EclipseME内置了对Antenna的支持，所以为了运行Antenna构建文件你只需要直接在build.xml 点击右键后选择Run / Ant Build 或者从主菜单的Run中选择 External Tools 

自定义Antenna构建
尽管自动生成的 build.xml and eclipseme-build.xml 文件包含了大多数你会用到的antenna典型操作,不过EclipseME的设计者显然是不可能顾及到所有的情况的。所以EclipseME提供了自定义构建文件的能力。 

不要修改 eclipseme-build.xml 和 eclipseme-build.properties 文件。 

当你再次执行导出操作时，这些文件会被重新生成，你对这些文件的所有修改都会被覆盖。此外eclipseme-build.xml 的组织和形式还经常会改变。 

如果你想为自动生成的eclipseme-build.properties 文件增加属性，或者是修改属性，你可以创建一个名为 user-build.properties的文件。文件中的内容会覆盖EclipseME自动生成文件的默认值。 

如果你想为你的构建增加任务，那么就增加到build.xml文件中去吧。如果你看一眼build.xml文件你就会发现， build.xml文件使用ant 任务对 eclipseme-build.xml进行了引用。 

注意： 默认的build.xml 文件假设你使用 混淆器对你的MIDlet进行打包。如果你不使用混淆器的话，你必须对 build.xml文件做适当的修改。首先, 在 build.xml 文件中找到这行： 

<target name="deployedSuite" depends="deployable" /> 

然后改成这样: 

<target name="deployedSuite" depends="jar" />