Java Reference
In-Depth Information
•
MIDlet-Version
: Specifies the version of your MIDlet suite, which is used to deter-
mine the currently installed version when upgrading a MIDlet suite. The AMS may
present the version to the user. The version must be in the form
major-version.
minor-version.micro-version
, where
major-version, minor-version
, and
micro-
version
are all integers. (The
micro-version
value is optional.)
•
MIDlet-Vendor
: Specifies your institution's name, which is the publisher of the
MIDlet suite.
•
MIDlet-
n
: Specifies the name, icon, and entry class (delimited by commas) for the
n
th MIDlet in the suite. There must be at least one of these (
MIDlet-1
) to specify a
single MIDlet in the suite.
•
MicroEdition-Configuration
: Specifies the version of the Java ME configuration (for
example, CLDC 1.0) required by the suite.
•
MicroEdition-Profile
: Specifies the version of the Java ME profile (for example,
MIDP 2.0) required by the suite.
In addition to the manifest, which describes the JAR file to the AMS, the AMS can use
the JAD file to determine the suitability of the MIDlet suite for the target device prior to
downloading and installing the suite itself.
■
Caution
Most platforms require you to provide a JAD file as well as a JAR file. If you do so, make sure
that the entries in your JAD file match the manifest
exactly
, or else the AMS may not install your application.
Obtaining Properties and Resources
The MIDlet properties from the manifest and JAD file are available to your application at
runtime. The MIDlet method
getAppProperty
takes the name of a property to return, and
returns the value of the property if it is set, or
null
if it's not. Note that attribute names are
case sensitive, so
MyProperty
is
not
the same as
myProperty
or
Myproperty
. When searching
for a property,
getAppProperty
follows these rules:
• If the MIDlet suite's JAR file is cryptographically signed,
getAppProperty
searches
the manifest first and then searches the JAD file. If it finds values in both files, it
knows they must match.
• If the MIDlet suite's JAR file is not signed,
getAppProperty
searches the JAD file first.
It searches the manifest for the property only if it doesn't find an entry for the
property in the JAD file.