深入分析JAD和MANIFEST.MF文件

我们知道JAD（Java Application Descriptor）文件是一个外部（相对JAR文件）描述文件，而Manifest.mf是一个内部列表文件。他们对于AMS的运行都起着至关重要的作用。

虽然它们的命名或者说文件类型都比较让人费解，不过，实际上它们也不过是单纯的文本文件，形式上非常相似，都是：“属性名称：属性值”。

这些属性主要包括：

属性名称	属性说明	Manifest.mf	JAD
MIDlet-Name	MIDlet Suite的名称	必需	必需
MIDlet-Version	MIDlet Suite的版本号	必需	必需
MIDlet-Vendor	MIDlet Suite的作者	必需	必需
MIDlet-n	属于该MIDlet Suite的每一个MIDlet都应独立定义一个	必需	必需
MicroEdition-Profile	MIDlet Suite所需简表版本	必需	必需
MicroEdition-Configuration	MIDlet Suite所需配置版本	必需	必需
MIDlet-Jar-URL	对应JAR文件的下载地址	-	必需
MIDlet-Jar-Size	JAR文件大小，单位：字节	-	必需
MIDlet-Description	MIDlet Suite的描述	可选	可选
MIDlet-Icon	MIDlet Suite的图标路径	可选	可选
MIDlet-Info-URL	MIDlet Suite的信息路径	可选	可选
MIDlet-Data-Size	MIDlet Suite用于持久性存储所需的最小字节数	可选	可选
MIDlet-Permission（MIDP2.0）	MIDlet Suite需要访问的受限API的许可	可选	可选
MIDlet-Permissions-Opt（MIDP2.0）	定义那些访问受限API非关键的许可	可选	可选
MIDlet-Push（MIDP2.0）	Push注册	可选	可选
MIDlet-Install-Notify（MIDP2.0）	定义接收MIDlet Suite安装状态的URL	可选	可选
MIDlet-Delete-Notify（MIDP2.0）	定义接收MIDlet Suite删除报告的URL	可选	可选
MIDlet-Delete-Confirm（MIDP2.0）	MIDlet Suite确认删除的提示信息	可选	可选

再分别看一个典型的Manifest.mf文件和JAD文件究竟是怎么定义：

“Manifest.mf”

MIDlet-1: CustomItem, customitemdemo.png, customitem.CustomItemDemo

MIDlet-10: Ticker, tickerdemo.png, ticker.TickerDemo

MIDlet-2: StringItem, stringitemdemo.png, stringitem.StringItemDemo

MIDlet-3: Gauge, gaugedemo.png, gauge.GaugeDemo

MIDlet-4: Alert, alertdemo.png, alert.AlertDemo

MIDlet-5: ChoiceGroup, choicegroup.png, choicegroup.ChoiceGroupDemo

MIDlet-6: List, listdemo.png, list.ListDemo

MIDlet-7: TextBox, textboxdemo.png, textbox.TextBoxDemo

MIDlet-8: TextField, textfielddemo.png, textfield.TextFieldDemo

MIDlet-9: DateField, datefielddemo.png, datefield.DateFieldDemo

MIDlet-Description: Basic UI elements functionality demo.

MIDlet-Name: UIDemo

MIDlet-Vendor: Sun Microsystems, Inc.

MIDlet-Version: 1.0

MicroEdition-Configuration: CLDC-1.0

MicroEdition-Profile: MIDP-2.0

“UIDemo.jad”

MIDlet-1: CustomItem, customitemdemo.png, customitem.CustomItemDemo

MIDlet-10: Ticker, tickerdemo.png, ticker.TickerDemo

MIDlet-2: StringItem, stringitemdemo.png, stringitem.StringItemDemo

MIDlet-3: Gauge, gaugedemo.png, gauge.GaugeDemo

MIDlet-4: Alert, alertdemo.png, alert.AlertDemo

MIDlet-5: ChoiceGroup, choicegroup.png, choicegroup.ChoiceGroupDemo

MIDlet-6: List, listdemo.png, list.ListDemo

MIDlet-7: TextBox, textboxdemo.png, textbox.TextBoxDemo

MIDlet-8: TextField, textfielddemo.png, textfield.TextFieldDemo

MIDlet-9: DateField, datefielddemo.png, datefield.DateFieldDemo

MIDlet-Description: Basic UI elements functionality demo.

MIDlet-Jar-Size: 22798

MIDlet-Jar-URL: UIDemo.jar

MIDlet-Name: UIDemo

MIDlet-Vendor: Sun Microsystems, Inc.

MIDlet-Version: 1.0

MicroEdition-Configuration: CLDC-1.0

MicroEdition-Profile: MIDP-2.0

置于每个属性对应的属性值应该怎么定义（如MIDlet-n，MIDlet-Version的属性值的格式），这里不做介绍，具体可以参考MIDP的相关说明。

根据MIDP的规定，代表MIDlet Suite的JAR文件内部要有一个列表文件，且文件名为Manifest.mf。

JAD文件虽然是可选的，但是也很有用武之地，特别是，在OTA模式下，在MIDlet Suite安装到移动设备之前，AMS首先会读取JAD文件的内容，分析MIDlet Suite是否与设备实现兼容，最典型的就是分析配置和简表的版本是否匹配。如果不兼容，那么AMS就会拒绝安装。这样也符合用户的需求。

同时，使用JAD文件的另一个优势是，可以自定义属性，比如说定义一个web服务的请求URL，当URL改变时，我们就不需要改变JAR的内部文件，来适应变更。

MIDlet-1: Query, Query.png, client.QMIDlet

……

queryURL: http://localhost:8080/QServlet/query.do

仔细观察上表，对于Manifest.mf文件和JAD文件来说三个属性是必须的：MIDlet-Name，MIDlet-Version和MIDlet-Vendor。三者属性值必须保持一致，否则AMS将不会下载和安装这个MIDlet Suite。而对于MIDlet-n，MicroEdition-Profile和MicroEdition-Configuration属性，实际上并不需要在JAD文件和Manifest.mf文件中重复定义。

另外，当用户安装MIDlet Suite的时候，AMS会鉴别正在安装的MIDlet Suite是被信任的（Trusted）还是非信任的（Untrusted）。根据MIDlet Suite类型的不同，AMS处理在这两个文件中被重复定义的属性也采取了不同的方法：

• 当为Trusted时：如果定义的属性在Manifest.mf和JAD文件中都出现，那么它们必须保持一致。
• 当为Untrusted时：如果定义的属性在Manifest.mf和JAD文件中都出现，那么MIDlet在运行时期所取得属性值则以JAD文件中的定义的为准。

属性定义知道了，那么怎么来获取它们的属性值呢？其实很简单，上面所提到的属性值，几乎所有都可以通过javax.microedition.mdilet.MIDlet.getAppProperty()这个方法来获取，唯独MicroEdition-Configuration和MicroEdition-Profile需要是通过java.lang.System.getProperty()来获取的。

最后还有一点值得指出的是：中文问题。把在Manifest.mf和JAD文件中出现的中文字符转换为Unicode的正则表达式可以有效防止乱码。

转换的方法是利用JDK所提供的native2ascii.exe工具。

CMD命令：

native2ascii 源文件.txt 目标文件.txt

转换前：MIDlet-1: 中文字典, DicMIDlet

转换后：MIDlet-1: /u4e2d/u6587/u5b57/u5178, DicMIDlet

这并不局限于JavaME，虽然稍微麻烦了一点，但这是一个比较通用和实用的方法。

原文：http://www.deepzhu.cn/2009/11/08/archives/57