从前面的分析 中,我们可以知道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处理在这两个文件中被重复定义的属性也采取了不同的方法:
属性定义知道了,那么怎么来获取它们的属性值呢?其实很简单,上面所提到的属性值,几乎所有都可以通过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