深入分析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

 

 

 

转载：http://www.deepzhu.cn/2009/11/08/archives/57