【IT168技术文档】众所周知,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 '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包。
软件版本
apache-ant-1.7.0
antenna-bin-0.9.15-beta.jar
jdk1.5
eclipse3.2