Java application description file (JAD) Editor

Overview

The agent package consists of a jar file containing software and a JAD file used to describe the source file content to the agent container.

Eclipseme comes with a Jad editor to help you deal with details such as the JAD file format. With this editor, you can enter all required items so that the device can correctly support your MIDlet. For convenience, the items that make up the JAD file are distributed in several different panels of the editor, and the labels of these panels are arranged at the bottom of the editor window.

Required properties (required) Panel

The first tag in the Jad editor corresponds to the required panel.

The items on this panel are:

Project	Content
MIDlet jar URL	The URL of the JAR file.
MIDlet name	The name of this MIDlet suite, that is, the name of the software you see. Each MIDlet in the suite can also have its own name. See the midlets panel below.
MIDlet vendor	Developer/provider of this MIDlet suite.
MIDlet version	The version number of this MIDlet suite. According to the Java product version number Naming Convention (Java product versioning specification), the format is <major version number>. <minor version number>. <micro version number>. You can use this information to install and upgrade the software and provide information prompts for users.
Microedition Configuration	This MIDlet kit is used to run the required j2_configuration (cldc) version. The optional content in the drop-down list is determined by the cldc version supported by the wireless toolkit selected by the project.
Microedition Profile	This MIDlet kit is used to run the required j2profile (MIDP) version. Like the microedition configuration, the content that can be selected in the drop-down list is determined by the MIDP version supported by the wireless toolkit selected in the project.

Note that the eclipseme plug-in will automatically process the required MIDlet-jar-size in the j2s specification, so you do not need to enter this information.

Midlets panel

The second tag in the editor Window Corresponds to the midlets panel. On this panel, you must ensure that each MIDlet in the MIDlet suite has a corresponding item. If you select the add to application descriptor check box when creating the MIDlet class, the corresponding items will be automatically added. Otherwise, you must use the Add button to add corresponding items for your MIDlet.

Before eclipseme version 0.5.0, click Add to bring up a dialog box for you to enter relevant information. Since version 0.5.0 and later versions, this Panel is more like a spreadsheet software. Click Add to create a new line, and the project in the row can be edited directly.

The columns on this panel are:

Project	Content
Name	The name of the MIDlet. If your kit contains multiple MIDlet, when a user opens the suite, the j2s device usually prompts the user to select a MIDlet to run. This project provides the name displayed to the user.
Icon	Path of the PNG file used as the icon of this MIDlet in the jar file.
Class Name	MIDlet class name. This is a subclass that you derived from javax. microedition. MIDlet. MIDlet.

Edit the name and Icon path. Just click the cell and enter a new value. If you want to change the class name, click the cell, and a button will appear.

Press this button to bring up a dialog box that allows you to select the correct MIDlet class.

Optional properties (optional) Panel

The third tag in the editor Window Corresponds to the optional property panel. On this panel, you can edit the attributes defined but not required in the j2s specification.

The items on this panel are:

Project	Content
MIDlet Permissions	Permissions required for normal running of your MIDlet. Generally, only the digitally signed MIDlet needs to provide permission attributes.
Optional MIDlet Permissions	The permissions that your MIDlet wants to obtain can be run even if you do not have this permission.
MIDlet data size	The minimum number of bytes required by the MIDlet to save persistent data. According to your own security level settings, the device may provide more space for the MIDlet. The default value is 0.
MIDlet description	Description of the MIDlet suite.
MIDlet icon	Path of the PNG file used as the icon of the MIDlet kit in the jar file. This is the icon used by the Java application manager to identify the MIDlet suite. This icon is intended for the entire MIDlet Suite, which is different from the icon for a single MIDlet set in the midlets panel.
MIDlet information URL	A URL that can obtain further information about the MIDlet suite.

Over the air panel

The fourth tag in the editor Window Corresponds to the over the air panel. On this panel, you can edit the attributes related to the wireless download specification.

The items on this panel are:

Project	Content
MIDlet Delete confirm	A confirmation prompt is displayed when you want to delete the MIDlet suite.
MIDlet Delete Policy	The delete notification URL is used to send a POST request to it to confirm that the MIDlet suite is successfully deleted.
MIDlet install Policy	Install the notification URL, which is used to send a POST request to it to confirm that the MIDlet suite is successfully installed.

User-Defined attributes panel

The fifth tag in the editor Window Corresponds to the user-defined attributes panel. On this panel, you can define attributes related to your specific MIDlet.

The columns on this panel are:

Project	Content
Key)	Key string used to obtain the corresponding value.
Value)	The value corresponding to the key.