把JAR文件添加到MIDlet套件

yydcj

于 2013-01-10 12:40:43 发布

阅读量698

点赞数

分类专栏： j2me 文章标签： MIDlet

j2me 专栏收录该内容

3 篇文章 0 订阅

订阅专栏

本文档说明了如何把一个外部JAR文件添加到MIDlet套件项目中。

JAR文件类型

从一个J2ME项目的观点来看，有两大类可以被添加到MIDlet套件项目的JAR文件。理解这两类JAR文件的区别是很重要的，因为它们必须被区别对待才能得到你想获得的结果。这两类是：

硬件相关JAR文件
这类JAR文件向MIDlet提供与一些硬件功能交互的支持，它们是安装MIDlet的目标手机或其它移动设备硬件的一部分。这类文件的一个例子是Bluetooth™（蓝牙）接口类。

这类JAR文件是由设备制造商提供的，通常作为无线工具包的一部分或其扩展包(add-on)的形式提供。这类JAR文件单独存在的意义在于，使J2ME开发者可以使用它们对MIDlet进行正确的编译，且在部署后正确引用它们。你不需要把这些硬件相关JAR中的class安装到移动设备中去——因为它们已经在那里了。
应用相关JAR文件
这类JAR文件包含由你或者其他J2ME开发者编写的、将直接作为MIDlet的一部分而被打包部署到移动设备的类文件。例如，一个你用来处理与服务器之间交换数据的XML解析库。

这类JAR文件一般是从设备制造商之外的地方获取的。当然，如果你把你的代码打包成了JAR，那它也属于这类。

对它们进行区别的原因在于，EclipseME要对它们中的class文件进行不同的处理。对于硬件相关JAR文件，EclipseME要保证这些文件中的类在构建过程中是类路径(classpath)的一部分，这样你的MIDlet才能正确编译，但这些类绝不能被打包到你的MIDlet部署包中去。因为这样做相当于试图覆盖移动设备中的硬件实现类的功能。这或许根本无法工作，因为首先，这种类文件很多都包含本地代码(native code)，而不能在MIDlet运行环境的“沙盒(sandbox)”中工作。其次，一个包含本地代码的MIDlet在部署流程中应该是无法通过预校验的。最后，即使上面的情况都没有发生，只要是自律的MIDlet容器都不会允许MIDlet覆盖系统类——它会认为MIDlet是无效的而拒绝执行。

另一方面，对于应用相关JAR文件，EclipseME则需要抽取其中的所有类和资源文件等，把它们和MIDlet套件项目中的相应项目一起，打包到最后的部署包中。J2ME设备中并不存在J2SE和J2EE系统中的类路径(classpath)概念。一个J2ME套件只是由两个文件组成——一个JAR文件和一个JAD文件。因此所有你的MIDlet要用到的类和资源都必须被打包成一个单独的JAR文件。

EclipseME根据你把文件加入系统的方式以及（隐含的）jar文件的相关“导出(export)”设定来区分其分类归属。因此下面的工作对你很重要：

决定JAR文件的归属分类，然后
用正确的方式把它加入系统。

添加硬件相关JAR文件

有两种添加硬件相关JAR的方法。可以在设备管理首选项面板中添加，也可以直接添加到项目，但不进行导出。

是用设备定义来添加硬件相关JAR文件

硬件相关JAR文件可以从设备管理首选项中作为一个新库来添加。大部分情况下，EclipseME能够从你的无线工具包中获取所有库定义的相关信息。如果没有的话，那么你需要首先向设备定义中添加一个新库（具体做法请参见这里）。最后，修改你的MIDlet套件项目的属性来使用新添加的或更新过的设备定义（参见这里）。

以上步骤结束之后，JAR文件就包含到你的项目的构建路径中了，这样编译器可以找到相关类的定义，但EclipseME不会试图把这些类添加到你的部署JAR文件中去——因为EclipseME知道：这个JAR文件现在是无线工具包的一部分，仅用于类引用的目的。

如果你试图在模拟器运行MIDlet的时候，特别是在OTA模式中，你得到了非法类(illegal classes)的错误提示，这可能是一个信号：你把硬件相关JAR错误的按照应用相关JAR的方式加入了系统。

直接添加到项目

在EclipseME 0.9.4版本之前，上面的方法是添加硬件相关JAR到EclipseME的唯一方案。从0.9.4版本开始，硬件相关JAR文件还可以直接在项目属性的“Java构建路径”中的“库”面板中直接添加。比如，在下面的项目中，mmapi.jar已经被添加到了项目中。

但是，如果你按此方法添加JAR文件，需要你高度注意的是：在“排序和导出(Order and Export”面板中，千万不要选中该JAR文件旁边的复选框，就像下面这样：

如果选中了复选框，那么EclipseME会试图对mmapi.jar中的内容进行预校验并把其内容包含在输出的部署JAR文件中，这显然是错误的。

哪个方法更好？

在EclipseME 0.9.4之前，你只有一种方法添加硬件相关JAR，所以事情很简单。从0.9.4版本开始，你有了两个选择，那么哪个更好些呢？

EclipseME的开发者认为，在绝大部分情况下，最好使用第一种方案——使用设备定义来添加硬件相关JAR文件。这个方法使得这个改变在不同项目中获得重用，而且更好的把硬件相关JAR文件和你的项目所使用的硬件设备相联系。但如果因为某些原因你无法使用这个方法，那么第二种方法——添加不进行导出的JAR文件到项目——你也可以选用。

添加应用相关JAR文件

应用相关JAR文件必须像非J2ME项目中的JAR文件那样，被加入到项目的构建路径中。选择项目菜单中的属性(Properties)菜单项，点击左边面板的Java构建路径(Java Build Path)项，然后在对话框的右边面板中加入JAR文件（或类文件目录）。

就像这样，在上面的例子中，除了已经加入的硬件相关JAR文件mmapi.jar之外，我们正在为项目加入一个应用相关JAR文件extensions.jar。

从EclipseME 0.9.4版本开始，你必须在Java构建路径中的“排序和导出”面板中，选中所有的应用相关JAR文件旁边的复选框，像下面这样：

完成之后，JAR文件或类文件目录中的class文件就成为你的项目构建路径的一部分，而且会被打包到项目的输出部署JAR文件中。就像上面的例子中，EclipseME会收集extensions.jar中的所有类和其它资源，进行预校验，然后把它们作为你的MIDlet的一部分进行打包部署。但是，EclipseME不会如此处理mmapi.jar，因为在“排序和导出”中，它旁边的复选框是空的。mmapi.jar中的资源在编译时是可用的，但不会被打包部署。

如果你试图在模拟器运行MIDlet的时候，特别是在OTA模式中，你得到了ClassNotFoundException（未找到类）异常，这是个信号，表示相关的类未被正确打包到你的部署JAR文件中。通常这意味着你没有正确的把应用相关JAR文件添加到项目的Java构建路径中，或者是忘记选中“导出”复选框了。