Java Application Descriptor Editor

Overview

J2ME distributions consist of a JAR file containing the software, and a JAD file containing information for the J2ME container describing the contents of the source file.

EclipseME has a built-in JAD editor that handles the details of formatting the JAD file for you. Using the JAD editor, you can make all the required entries to allow your MIDlet to be properly supported. The information that makes up the JAD file is spread across several tabs, along the bottom of the editor window, for convenience.

Required Tab

The first tab on the JAD editor window is labeled Required

screenshot

The items on this tab are:

ItemContents
Midlet Jar URL The URL from which the JAR file can be loaded.
Midlet Name The name of the MIDlet suite that identifies the MIDlets to the user. Individual MIDlets can also have names. See the Midlets tab below for that information.
Midlet Vendor The organization that provides the MIDlet suite.
Midlet Version The version number of the MIDlet suite. The format is <major>.<minor>.<micro> as described in the Java Product Versioning Specification. the J2ME container can use this for install and upgrade purposes, as well as for communication with the user.
Microedition Configuration The J2ME Configuration required by this MIDlet suite, using the same format and value as the system property microedition.configuration. For CLDC 1.0 compatibility, this field must be CLDC-1.0. In the future, this field will be used to specify the required CLDC version.
Microedition Profile The J2ME profile required by this MIDlet suite, using the same format and value as the system property microedition.profiles. For the MIDP 1.0 release the content of this field must be MIDP-1.0. In the future, this field will be used to specify the required MIDP version.

Note that the EclipseME plug-in automatically provides the MIDLet-Jar-Size item required by the J2ME specification, so you are not required to enter this information.

Midlets tab

The second tab on the JAD editor window is labeled Midlets. On this tab, you must have one entry for each MIDlet in your MIDlet suite. If you selected the Add to Application Descriptor option when you created the MIDlet class, an entry is automatically made for you. If not, you must use the Add button to add an entry for your MIDlet.

screenshot

The columns on this tab are:

ItemContents
Name Name of the MIDlet. If there are multiple MIDlets in your suite, when the user invokes the suite, the J2ME device will typically prompt the user for the specific MIDlet to be executed. This entry provides the name that will be shown to the user.
Icon Path to the PNG file within the JAR file that contains the icon for this MIDlet.
Class The MIDlet class itself. This is the class you created derived from javax.microedition.midlet.MIDlet.

Optional tab

The third tab on the JAD editor window is labeled Optional. On this tab you can make entries that are defined in the J2ME specification, but which are not required.

screenshot

The items on this tab are:

ItemContents
Midlet Data Size The minimum number of bytes of persistent data required by the MIDlet. The device may provide additional storage according to its own policy. The default is zero.
Midlet Description The description of the MIDlet suite.
Midlet Icon The name of a PNG file within the JAR file used to represent the MIDlet suite. It is the icon used by the Java Application Manager to identify the suite. This icon is for the suite as a whole, as distinct from the individual MIDlet icons you can set up on the Midlets Tab.
Midlet Information URL A URL for information further describing the MIDlet suite.

Over the Air tab

The fourth tab on the JAD editor window is labeled Over the Air. On this tab you can make entries that are related to Over-the-Air provisioning.

screenshot

The items on this tab are:

ItemContents
Midlet Delete Confirm A text message provided to the user when prompted to confirm deletion of the MIDlet suite.
Midlet Delete Notify The URL to which a POST request is sent to confirm successful deletion of this MIDlet suite.
Midlet Install Notify The URL to which a POST request is sent to confirm successful installation of this MIDlet suite.