Antenna与j2me打包详细介绍

　　众所周知，j2me平台受限于各厂商对KVM的实现不同。此外，由于不同终端性能的差别，j2me开发中的 机型适配是相当繁琐的工作。当然，对于该难题，有很多种解决方案。例如，可以使用j2mepolish，请参考本人以前发表的文章《使用J2mePolish的build和preprocess功能》。本文主要讨论如何使用antenna来解决这个问题。

　　Antenna介绍

　　Antenna是基于ant的j2me开发工具。可以使用antenna对j2me程序进行 编译、校验、打包、混淆等，甚至可以通过antenna所定义的task，运行已经打包完成的jar；还可以将打包完成jad和jar部署到OTA服务器上。

　　以上功能，只是对ant的扩展，在我以前的文章《使用Ant对j2me程序打包》也讨论。其实，以上所说的功能，直接使用ant也能实现，只是antenna对这些task进行了扩展，使得对j2me程序的打包过程更加的傻瓜话罢了。貌似，话说到这里有些自相矛盾了，既然这些功能ant都能实现，还介绍antenna干嘛呢？其实，本人最推崇antenna的，不仅是它对j2me打包过程的简化，而且特别赞赏它对预处理的支持。除此之外，antenna的预处理，结合了j2mepolish所提供的device.xml数据库，就是说，我们也可以像在j2mepolish中那样，对源程序进行相关的处理，以达到多机型时配的要求。

　　Antenna中的预处理

　　中的预处理原来与j2mepolish等支持预处理的软件一致，都是在编译之前，对代码中定义的预处理脚本进行处理，并生成符合脚本定义规则的代码。

　　在antenna中，通过“wtkpreprocess”task来进行预处理。关于预处理脚本的定义，请参考antenna自带doc中的wtkpreprocess.html.此外，本文讨论的preprocessor是指新版的preprocessor，即version=2，原来的预处理机制不在本文讨论范围之内。

　　下面举例说明，如何通过在代码中定义脚本获取终端相关信息，类似于《使用J2mePolish的build和preprocess功能》一文中的例子，感兴趣的朋友可以结合起来学习。

　　Task定义如下：

　　xml 代码

　　<wtkpreprocess verbose="true" version="2" srcdir="${dir.src}" destdir="${dir.dist}"

　　device="Nokia/6600" printsymbols="true" />

　　其中，device为制定的机型型号，而printsymbols用于标示，是否在处理过程，将所有的标记打印出来。出于学习和调试目的，最好设置为true

　　源代码片断：

　　java 代码

　　public class MyCanvas

　　//#if JavaPackage">'nokia-ui'@JavaPackage

　　//# extends com.nokia.mid.ui.FullCanvas

　　//#else

　　extends Canvas

　　//#endif

　　{

　　//#ifdef key.LeftSoftKey

　　//#expand public final static int KEY_SOFT_LEFT = %key.LeftSoftKey%；

　　//#else

　　public final static int KEY_SOFT_LEFT = 6；

　　//#endif

　　//#ifdef key.RightSoftKey

　　//#expand public final static int KEY_SOFT_RIGHT = %key.RightSoftKey%；

　　//#else

　　public final static int KEY_SOFT_RIGHT = 7；

　　//#endif

　　int screenWidth = getWidth（）；

　　int screenHeight = getHeight（）；

　　public MyCanvas（）

　　{

　　//      #if ！（'nokia-ui'@JavaPackage）

　　//# setFullScreenMode（true）；

　　//#endif

　　}

　　protected void paint （Graphics g）

　　{

　　//#ifdef ScreenSize

　　//#expand String screensize = "%ScreenSize%"；

　　//#else

　　String screensize = "128x128"；

　　//#endif

　　g.setColor（0）；

　　g.fillRect（0， 0， screenWidth， screenHeight）；

　　g.setColor（255，255，255）；

　　g.drawString（screensize， screenWidth/2， screenHeight/2， 0）；

　　}

　　}

　　如此一来，就可以通过antenna中的预处理机制，解决多机型之间，键值不同，屏幕大小不同，扩展API不同等问题。

　　注意，device.xml中，有些数据并没有安全定义。例如，各终端的导航键值就没有定义。可自行添加到device.xml中，然后覆盖原来的antenna包中的device.xml即可。

　　目录结构定义

　　在打包过程中，对整个工程的目录设置如下，具体体现在build.xml中

　　src ——源码目录

　　res——资源目录

　　build

　　—— 编译后的class文件以及从res复制过来的资源文件

　　——jar和jad文件

　　dist——预处理后的java文件

　　Ant脚本

　　按照以上分析，build.xml文件定义如下：

　　xml 代码

　　<target name="init" description="变量定义">

　　<echo message="Define variable" />

　　<！—— 相关变量定义 ——>

　　<property name="basedir" value="." />

　　<property name="midlet.version" value="1.0" />

　　<property name="jad.filename" value="AntennaApp" />

　　<property name="jar.filename" value="${jad.filename}" />

　　<property name="wtk.proguard.home" value="E：\Develpment\proguard3.9"/>

　　<！—— 目录结构定义 ——>

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

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

　　<property name="dir.output" value="${basedir}/build" />

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

　　<property name="dir.classes" value="${dir.output}/classes" />

　　<property name="dir.deployed" value="${dir.output}/deployed" />

　　<property name="wtk.home" value="E：\Develpment\SDK\WTK25" />

　　<property name="wtk.cldc.version" value="1.0" />

　　<property name="wtk.midp.version" value="2.0" />

　　<property name="wtk.wma.enabled" value="false" />

　　<property name="wtk.debug" value="false" />

　　<property name="wtk.obfuscate" value="true" />

　　<！—— JAD相关属性定义——>

　　<property name="jad.midlet-name" value="AntennaApp" />

　　<property name="jad.midlet-vender" value="org" />

　　<property name="jad.midlet-version" value="1.0.0" />

　　<！——Midlet相关定义——>

　　<property name="jad.midlet-class" value="MyMIDlet" />

　　<property name="jad.midlet-icon" value="" />

　　<！——发布——>

　　<property name="deploy.target" value="http://localhost：8080/deployer" />

　　<property name="deploy.login" value="admin" />

　　<property name="deploy.password" value="admin" />

　　<！——</span——>target>

　　<target name="clean" depends="init" description="初始化环境">

　　<echo message="Clean dir" />

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

　　<！——</span——>target>

　　<target name="preprocess" depends="init，clean" description="预处理">

　　<echo message="preprocess" />

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

　　<wtkpreprocess verbose="true" version="2" srcdir="${dir.src}" destdir="${dir.dist}" device="Nokia/6600" printsymbols="true" />

　　<！——</span——>target>

　　<target name="compile" depends="preprocess" description="编译">

　　<echo>Starting compile<！——</span——>echo>

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

　　<echo>build from all the ${dir.src} to ${dir.classes}<！——</span——>echo>

　　<wtkbuild srcdir="${dir.dist}" destdir="${dir.classes}" target="1.1" source="1.2" preverify="false" debug="${wtk.debug}" listfiles="no" classpath="E：\Develpment\wtk100\lib\nokiaui.zip">

　　<！——</span——>wtkbuild>

　　<！——</span——>target>

　　<target name="build" depends="compile" description="生成">

　　<echo message="Packaging library"/>

　　<copy todir="${dir.classes}/res">

　　<fileset dir="${dir.res}" includes="*.png" />

　　<fileset dir="${dir.res}" includes="*.properties" />

　　<fileset dir="${dir.res}" includes="*.midi" />

　　<！——</span——>copy>

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

　　<wtkjad jadfile="${dir.deployed}/${jad.filename}.jad"

　　jarfile="${dir.deployed}/${jar.filename}.jar"

　　name="${jad.midlet-name}"

　　vendor="${jad.midlet-vender}"

　　version="${jad.midlet-version}">

　　<midlet name="${jad.midlet-name}"

　　class="${jad.midlet-class}"

　　icon="${jad.midlet-icon}"/>

　　<attribute name="MIDlet-Icon"            value="${jad.midlet-icon}" />

　　<attribute name="MIDlet-Permissions"     value="${jad.midlet-permissions}"/>

　　<attribute name="MicroEdition-Configuration"     value="CLDC-1.0"/>

　　<attribute name="MicroEdition-Profile"     value="MIDP-2.0"/>

　　<！——</span——>wtkjad>

　　<wtkpackage jarfile="${dir.deployed}/${jar.filename}.jar"

　　jadfile="${dir.deployed}/${jad.filename}.jad"

　　obfuscate="${wtk.obfuscate}"

　　preverify="true" classpath="E：\Develpment\wtk100\lib\nokiaui.zip">

　　<fileset dir="${dir.classes}"/>

　　<！——</span——>wtkpackage>

　　<！——</span——>target>

　　注意：如果是在Eclipse中使用ant 来运行build.xml，请注意ant_home路径的设置，且确认ant_home\bin目录下存在antenna包。