Создание файла манифеста JAR
ЕСЛИ вы хотите добавить файл Manifest к вашему заархивированному набору MID-летов, вам необходимо создать его прежде, чем вы создадите сам JAR-архив. Вы можете создать этот файл в любом текстовом редакторе. Потом создайте JAR-файл с помощью стандартной утилиты JAR J2SE. Утилита JAR включается в утилиты инструментария Wireless Toolkit.
Спецификация MIDP требует, чтобы в файле Manifest присутствовали определенные поля. Требуемые поля показаны в таблице 2.2.
Таблица 2.2. Обязательные атрибуты файла MANIFEST.MF
Имя атрибута | Описание | ||
MIDlet-Name | Название набора MID-летов | ||
MIDlet-Versiorv | Номер версии набора MID-летов в форме <major>.<minor>.<micro>, определяемой схемой спецификации управления версиями продукта JDK | ||
MIDlet-Vendor | Разработчик приложения (компания или частное лицо) | ||
MIDlet-<n> | По одному на MID-лет в данном наборе, содержит разделяемый запятой список из текстового имени MID-лета, значка и имени класса п-ного MID-лета в наборе | ||
MicroEdit ion-Profile | Профиль J2ME, необходимый для исполнения MID-лета | ||
MicroEdition-Configuration | Конфигурация J2ME, необходимая для исполнения MID-лета |
Файл манифеста содержит строки атрибутов, один атрибут на строку. Каждый атрибут состоит из ключа и значения. После ключа ставится двоеточие, которое отделяет его от связанного с ним значения. Файл MANIFEST.MF программы HelloWorld находится в папке HelloWorld/bin/. Он выглядит следующим образом:
MIDlet-l: HelloWorld, HelloWorld.png, HelloWorld
MIDlet-Narae: HelloWorld
MIDlet-Vendor: Vartan Piroumian
MIDlet-Version: 1.0
MicroEdition-Configuration: CLDC-1.0
MicroEdition-Profile: MIDP-1.0
Обратите внимание на имя атрибута MIDlet-1: в файле MANIFEST.MF. Файл манифеста различает различные MID-леты, нумеруя их от MIDlet-l до MIDlet-/!. Число 1 должно идентифицировать первый MID-лет.
У атрибута MIDlet-1 существует три значения. Первое - название набора MID-летов, который содержит данный MID-лет. Это значение может быть именем, воспринимающимся человеком.
Второе значение является именем файла изображения PNG, который AMS использует как значок, представляющий этот MID-лет. Последнее значение является именем файла класса MID-лета, который определяет входную точку исполнения MID-лета.
Наверное, самыми важными атрибутами являются атрибуты MicroEdition-Configuration и MicroEdition-Profile. AMS использует эти значения для определения того, подходит ли MID-лет для данного устройства.
Спецификация MIDP позволяет также создавать необязательные поля в файле манифеста. В таблице 2.3 показаны необязательные поля файла манифеста.
Таблица 2.3. Необязательные атрибуты файла MANIFEST.MF
Имя атрибута | Описание |
MI Diet-Description | Описание набора MID-летов |
MIDlet-Icon | Имя файла PNG, содержащегося в JAR |
MIDlet-Info-URL | URL, который содержит дополнительную информацию об этом наборе MID-летов |
MIDlet-Data-Size | Минимальное количество байт данных постоянного хранения, требуемое набором |