Netbeans预处理器

1. 简介

Java ME设备的多样化无疑是移动应用开发的噩梦，屏幕大小、按键键值、性能高低和API支持的不同等众多的差异为Java ME应用的多终端移植开发带来了重重困难。

预处理器（Preprocessor），顾名思义，是在编译之前对源代码进行预先处理。它为JavaME应用的多终端移植提供了一个良好的解决方案，你可以让多个终端版本共用同一套源代码，基于不同终端的属性对代码预处理后输出不同版本，这为移植和代码维护都带来了巨大的便利。

目前比较常见的预处理器有以下几个方案：

1. J2me Polish：http://www.j2mepolish.org
2. Antenna：http://antenna.sourceforge.net
3. Netbeans的Mobility Pack: http://www.netbeans.org/products/mobility/

这三个方案的使用方式基本相同，本文选择Netbeans为例来说明预处理器在多终端移植开发中的使用，相比其他两个方案Mobility Pack的解决方案跟IDE结合的更紧密，易用性更高。

本文仅介绍和预处理器使用的相关内容，关于Netbeans的安装、使用和技巧，请参考Netbeans的帮助文档及其官方网站提供的相关文档。

本文内容基于Netbeans 5.5和Mobility Pack 5.5。

 

 2. 使用配置（Configuration）

首先，在使用Netbeans的预处理器之前，需要先了解一下配置（Configuration）。这里的配置区别于JavaME架构中的配置，是Mobility Pack引入的一个概念，通过配置，我们可以为每一个目标设备定义一个执行环境。

在一个MIDP工程中，我们可以添加任意多个配置，每个配置中可以定义的内容包括：

1. 平台（Platform），包含仿真器平台、API包等；
2. 仿真器设备，指定特定的仿真器；
3. 性能（Ability），目标设备的能力列表，包含API支持情况、屏幕大小、文件类型支持、自定义参数等设备相关属性；
4. 应用程序描述，JAD和JAR清单文件中的描述内容；
5. Build参数，包含源文件过滤、编译参数、类库、资源文件、混淆参数、JAD/JAR文件、签名和Javadoc生成等Build相关参数；
6. 部署参数，包含仿真器命令行和部署方式等；

配置的新建、编辑和删除可以在工程的属性页完成，更多详细的内容可以参考Netbeans的帮助文档。

配置中定义的性能列表是预处理器工作的一个重要依据。

 

 3.使用预处理器

预处理器在编译器工作之前发挥作用，根据配置中的定义，提前修改源文件中的代码。预处理器修改代码的依据是预处理指令，这些指令以特定的注释方式插入在源文件中，每一个指令都紧跟在”//#”之后。预处理器修改代码的方式是注释，如果预处理器指令成立，则指令包含的部分被保留，反之，则会被注释掉。

举例说明，在游戏开发中使用全屏显示，在支持NOKIAUI的设备上，我们可以使用FullCanvas，在MIDP2.0设备上，我们可以使用Canvas或者GameCanvas中的setFullMode(boolean)方法。

假设我们已经定义了两个配置：NOKIA_7210和NOKIA_N70，两个配置的性能列表片段如下：

性能	NOKIA_7210    NOKIA_N70
NOKIAUI	 1.1	       1.1
MIDP	 1.0	       2.0
……

代码片段如下：

//#if MIDP == “2.0”
	import com.nokia.ui.FullCanvas;
//#elif NOKIAUI
//#    	  import javax.microedition.lcdui.GameCanvas;
//#endif

注：上面的//#import javax.microedition.lcdui.GameCanvas;部分的注释为Netbeans自动完成的内容，在编写代码过程中不用添加，IDE会根据当前的选择的配置自动注释需要删除的部分。

当配置NOKIA_N70被选中后，import javax.microedition.lcdui.GameCanvas;会被注保留，反之如果是NOKIA_7210被选中，则import com.nokia.ui.FullCanvas;会被保留。了解了预处理器的工作原理之后，我们还需要进一步了解的内容就是预处理指令集的语法、功能和用法。关于这一点，在参考资料1和Netbeans的帮助文档中都有非常详细的介绍，请大家参考相关内容，本文不在赘述。

 4.预处理器之外

通过预处理器我们可以让一份源代码文件适用于多个设备，但是往往在多终端移植开发中，源代码并不是唯一需要关注的内容。由于屏幕大小、MIDlet图标规格、可用堆栈大小和音乐文件格式等诸多差别的存在，我们还需要在不同设备的版本中使用特定的资源文件，对于游戏应用来说这一点尤为重要。

针对这个问题，我们可以灵活使用配置定义中的“类库与资源文件”。通过“工程属性->Build->类库与资源”可以进入类库与资源的定义页面，每个配置都可以设置不同的类库与资源。

我们可以把不同版本的资源放置在各自独立的文件夹中，通过添加资源文件夹为不同配置定义资源文件。这样不同的配置就可以使用其特定的资源文件了。

此外，由于设备的API支持差别，不同的设备可能需要添加不同的类库，也可以通过同样的方式解决。例如，在CLDC1.0的设备上，需要添加定点数API来完成对浮点数的模拟。

注：在类库与资源的定义中，只可以添加整个文件夹，所以文件夹中可能包含类似.svn和Thumb.db等不需要的文件。我们需要将这些文件排除在资源文件列表之外，在IDE中并没有直接提供文件类型过滤的方法，好在Netbeans是基于Ant来完成Build工作的，我们可以通过修改Build.xml来完成文件类型过滤。

我们可以打开${工程目录}/nbproject/build-impl.xml文件，将

<target name="pre-init">

修改为：

<target name="pre-init">
    <defaultexcludes add="**/*.db"/>
    <defaultexcludes add="**/*.其他文件类型"/>
</target>

Ant已经默认排除了部分文件类型，例如.svn文件类型，详细内容请参考Ant的相关文档。

 

 5.存在的问题

预处理器的引入可以为多终端移植工作带来明显的好处，终于可以达成一份代码适用于多个平台的宿愿了，可以大大降低多版本维护的成本，提高开发效率等。

然而，有一利必有一弊，这一份代码却是要经过一次又一次修改的，显然，代码的每一次修改都会带来新的风险，已经通过测试的版本可能又会