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 '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>

 

1. 注意：如果是在 Eclipse 中使用 ant 来运行 build.xml ，请注意 ant_home 路径的设置，且确认 ant_home\bin 目录下存在 antenna 包。
2.  
3. 软件版本
4. apache-ant-1.7.0
5. antenna-bin-0.9.15-beta.jar
6. jdk1.5
7. eclipse3.2
8.  
9. 参考文章
10. J2ME Antenna 入门 作者： redduke1202
11. 地址： http://community.csdn.net/Expert/TopicView3.asp?id=5298691  
12.  
13. 《 Using_Ant_and_Antenna_MIDP 》 Nokia 文档
14.  
15. 《 j2me build.xml 例子》 作者： Peter
16. 地址： http://hi.baidu.com/wapeter/blog/item/3beb9f2268f571f2d6cae2d2.html

<!---->