Antenna与j2me打包

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中的预处理

         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

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

    --deployed——jar和jad文件

dist——预处理后的java文件

 

Ant脚本

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

 

 

注意：如果是在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

参考文章

J2ME Antenna 入门 作者：redduke1202

地址：http://community.csdn.net/Expert/TopicView3.asp?id=5298691

 

《Using_Ant_and_Antenna_MIDP》 Nokia文档

 

《j2me build.xml例子》 作者：Peter

地址：http://hi.baidu.com/wapeter/blog/item/3beb9f2268f571f2d6cae2d2.html

• build.rar (1.4 KB)
• 描述: buidl.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" />


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


     <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" />

 target>

 <target name="clean" depends="init" description="初始化环境">
     <echo message="Clean dir" />
     <delete dir="${dir.output}" />
 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" />
 target>

 <target name="compile" depends="preprocess" description="编译">
     <echo>Starting compileecho>
     <mkdir dir="${dir.classes}" />

     <echo>build from all the ${dir.src} to ${dir.classes}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">
     wtkbuild>

 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" />
        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"/>
        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}"/>

        wtkpackage>
 target>