1.5.1 清单文件

清单（Manifest）文件是文本格式的文件。当MIDlet套件安装到硬件设备上时，清单文件的扩展名会被更新为·mf。它定义了MIDlet套件的属性，其中有6个属性是必须包含的。除此之外，用户还可以自定义一些属性。

Manifest（清单）文件包含的6个必要属性如下。

● MIDlet-Name MIDlet套件的名称。

● MIDlet-Version MIDlet套件的版本，格式为：a·b·c。

● MIDlet-Vendor MIDlet套件的开发人员。

● MIDlet-<n> MIDlet套件中每个MIDlet的描述，该描述可以分成三部分内容：名称、图标名和类名。其中，n要用一个从1开始的数值替换。

● MicroEdition-Configuration MIDlet套件所需要的配置的类型和版本。

● MicroEdition-Profile MIDlet 套件所需要的简表的类型和版本（如果出现多个版本，要用空格分离）。

以下是清单文件定义的可选属性。

● MIDlet-Icon MIDlet套件的图标，必须是扩展名为 ·png的文件。

● MIDlet-Description MIDlet套件的描述。

● MIDlet-Info-URL MIDlet套件更多信息的URL。

● MIDlet-Data-Size MIDlet 套件需要的最小持久存储空间的大小，以字节为单位。如果不存在此属性，则说明不需要持久存储。

● MIDlet-Permissions MIDlet套件的权限许可列表。

● MIDlet-Permissions-Opt MIDlet套件的可选权限许可列表。

● MIDlet-Push-<n> MIDlet套件Push注册项。

● MIDlet-Delete-Notify MIDlet套件删除提示内容。

一个典型的清单文件如下：

            MIDlet-Name: HelloWorld MIDlet
            MIDlet-Version: 2·0
            MIDlet-Vendor: myStudio
            MIDlet-1: HelloWorldMIDlet, /images/HelloWorld·png, HelloWorld·HelloWorldMIDlet
            MicroEdition-Profile: MIDP-2·0
            MicroEdition-Configuration: CLDC-1·1

清单中，每行对应一种属性，定义格式为：“属性名:属性值”。

下面具体分析一下该文件中定义的属性的含义。

由上面的典型清单文件得知，MIDlet套件的名称是HelloWorld MIDlet，版本号为2·0（版本号主要用于程序的更新），制作该MIDlet套件的人员名称是myStudio。

该MIDlet套件包含一个MIDlet类，名称是HelloWorldMIDlet，MIDlet-<n>属性后可以带三个值：MIDlet的名称、该MIDlet的图标和MIDlet类的名称，本例的类名为：在HelloWorld目录下的名为HelloWorldMIDlet的类。最后，该MIDlet套件使用的简表是MIDP-2·0，使用的配置是CLDC-1·1。