使用J2mePolish的build功能

转自: http://pandonix.javaeye.com/blog/114267 

本文主要探讨如何使用j2mepolish进行build，至于j2mepolish的其他强大功能，本文不涉及。本人接触j2mepolish时间不长，若有漏洞或出错，请路过的朋友指正，同时欢迎大家拍砖。

对于J2mepolish的主要功能，不用再多讲，其大名在j2me已经如雷贯耳。若还有朋友了解或希望加深“感情”，请访问www.j2mepolish.org。

安装过程其实很简单，在此主要探讨关于eclipse的插件“mepose”。在javaeye上，有文章探讨j2mepolish的安装过程，其中，mepose是在另外独立安装的插件，而在2.0-RC4版本中，自带了mepose插件，只要在安装过程中填入eclipse.home和选择Eclipse Integration(Mepose)，就可以安装mepose插件。

如果在Eclipse的file->new->project出现j2mepolish工程，则说明mepose插件已经成功安装，至此，就可以新建j2mepolish工程。新建的j2mepolish工程中，包含了自动创建的build.xml文件，以及src、resource等默认目录。运行只需右键选中build.xml，点击run as->ant build。

当然，不使用mepose插件也可以，因为Eclipse默认支持ant。所以，只需要按照sample中的目录结构存放资源和源码，并是用语法正确的build.xml文件就可正常使用j2mepolish，毕竟，j2mepolish的build功能，只是ant的扩展。

Eclipse的plugins目录中，自带有ant，eclipse3.2中的ant版本为1.6.5。如果希望使用自己的ant，可以在Eclipse中的Windows->preference->ant中设置Ant Home，将路径指向自己的ant目录，这样可以保持与Eclipse外的ant版本一致。

sample中的build.xml，个人觉得写得太过于繁琐，中间夹杂太多注释。这对于不初学者，特别是不熟悉ant脚本的朋友，会比较“郁闷”。由于本文重点探讨ant的build功能，所以，只讨论build.xml中的“j2mepolish”target，其他部分，请参考相关文档。

主要用于描述midlet相关信息，帮助设置JAD和MANIFEST。但部分中，可以通过子元素设置jad其他属性。有关相关属性的定义，请参考favoyang翻译《创建》或《Pro J2ME Polish Open Source Wireless Java Tools Suite》

虽然是可选，但却与device数据库紧密相关。如果需要使用device相关数据，特别是对多版本的j2me程序打包，这部分的设置尤为重要。

实际的build操作部分，在此设置midlet类名，以及第三方库包的导入等。在属性中，usePolishGui用于标示是否适用polish的GUI功能，注意该属性缺省是true。所以，如果没有用到polish的该功能，最好将其设置为false，否则打包时，将会加入polish自带一些类库，因此，会增加jar包的大小。

部分也是j2mepolish创建的重要部分，但并非本文讨论重要，具体内容请参考favoyang翻译《创建》或《Pro J2ME Polish Open Source Wireless Java Tools Suite》。

J2mepolish存储了超过 230种 J2ME 设备和相应的J2ME 参数，如 Canvas的大小, APIs, 支持格式等。其中，所有的数据都定义在device.xml文件中（安装过程，需选中External Device Database）。当然，可以随时更新device.xml数据库。

事实上，device数据库对于j2me开发非常重要。在本人的开发经历中，很多次都无奈难于获得某类机型的具体信息，如：堆栈大小，是否支持特定的扩展包等。即使有的公司拥有这样一套数据集合，也多半是以excel的形式保存，却无法与程序结合起来使用。这点，也为j2me程序的机型适配工作带来了繁重的工作量。J2mepolish在这方面对j2me开发做出重大贡献，以至于想antenna这样的开源项目已经支持j2mepolish提供的device数据库。

在开发过程中，结合j2mepolish的预处理机制，我们可以很便捷的使用该数据库。

废话了大半天，先来看看具体device是如何定义的，以nokia/6600为例：

用于标示该设备，由厂商和设备名组成。

用于标示该设备属于哪个Group，设备本身的记号(symbol)继承于group的。例如，6600属于Series60组，所以6600就拥有nokia-ui记号。J2mepolish在预处理//#if nokia-ui时，就处理为true。而Group本身也存在着继承关系，例如，Series60又继承于Nokia-UI组。

用于标示该设备具有的功能，如，摄像头、触摸屏等。

用于设备各项重要属性，如堆栈大小，屏幕大小等。在本例中，没有左右软键值定义，是因为其已经被定义在Series60组中。

本节重点讨论如何使用指定设备的相关数据。首先，在build.xml中指定设备，在此我们以Nokia/6600和Motorola/E680为例，定义如下：

xml 代码

<deviceRequirements> 
       <requirement name="Identifier" value="Nokia/6600,Motorola/E680" /> 
</deviceRequirements>  

下面按照以下几点目标来设计代码：

1、6600版本使用FullCanvas，E680版本使用SetFullScreenMode

2、6600版本使用Nokia的翻转方法，E680版本使用Midp2.0的

3、获取设备自身的堆栈大小，屏幕大小等信息

public class MyCanvas
        // #if polish.api.nokia-ui
        // # extends com.nokia.mid.ui.FullCanvas
        // #else
        extends Canvas
        // #endif
{

    public MyCanvas() {
        // #ifndef polish.api.nokia-ui
        // # setFullScreenMode(true);
        // #endif

        // #ifdef polish.ScreenSize:defined
        // #= String screensize = "${ polish.ScreenSize }";
        // #else
        String screensize = "128*128";
        // #endif

        // #ifdef polish.HeapSize:defined
        // #= int heapSize = ${ bytes(polish.HeapSize) };
        // #else
        int heapSize = 1000;
        // #endif
    }

    protected void paint(Graphics g) {
    }

    public void drawClip(Graphics g, int x, int y, Image image, int clipX,
                         int clipY, int clipWidth, int clipHeight, int mode) {
        // #if polish.api.nokia-ui
        // # ...
        // # nokia的切片绘制方法，具体代码省略
        // # ...
        // #else
        //...
        //midp2.0的切片绘制方法，具体代码省略
        //...
        // #endif
    }

}

运行build.xml之后，可以在build/real目录下，找到预处理以后的6600版和E680版代码。J2mepolish的预处理结果就体现在此，预处理后代码请感兴趣的朋友动手实践，在此就不贴出来了。

本人对于J2mepolish的了解还需深入，但在使用之后，对j2mepolish有以下几点思考，欢迎大家交流。

1. <!--[if !supportLists]-->j2mepolish在build功能上面，其实就是ant扩展。当然，其本身也是支持其他ant扩展，如，打包完成后，自动将jar文件上传到服务器上。但是功能强大的同时，却带来的是自由度的下降。例如，在存在以下需求时，用j2mepolish来实现打包，可能就比较繁琐了：在一份源码的基础上，对不同的资源目录进行打包。如，A版本使用的资源目录为res1，B版本使用的资源目录为res2；不同版本，jad属性不同。本人认为，j2mepolish中，选择不同的设备是在处指定，这样一来，不同版本之间区别就很难在一个build.xml文件中或者一次build过程中定义清楚。当然，并非说j2mepolish不能实现以上需求，这就是仁者见仁，智者见智了。
2. <!--[if !supportLists]--><!--[endif]-->j2mepolish编译使用的库，如: midp2.0.jar、cldc1.0.jar等，都是来自于polish_home/import目录下，这样不方便相关库的升级和使用。

Antenna：应用于j2me的ant扩展，最新版本支持预处理，也支持j2mepolish的device数据库。地址：http://antenna.sourceforge.net/

J2me Device DB：类似于Antenna的一个项目，拥有自己的设备数据库，也支持预处理。地址：http://j2me-device-db.sourceforge.net/pmwiki/index.php?n=Main.HomePage

软件版本

j2mepolish-2.0-RC4

jdk1.5

eclipse3.2

漫游j2mepolish    访问地址：http://www.j2mepolish.org/docs/tour-cn.html

《Pro J2ME Polish Open Source Wireless Java Tools Suite》 作者：Robert Virkus

《创建》 翻译：favoyang

J2mepolish doc      安装自带

J2mePolish集成到eclipse32 访问地址：http://www.javaeye.com/topic/38138