Nokia的S60和S40系列jad和jar manifest的属性列表见下,也可参见原文

The following JAD and JAR manifest attributes are specified for Symbian devices.

 
Table: Nokia-proprietary manifest attributes for Symbian

Attribute name

Since Symbian Edition

Description

Value

MIDlet-Data-Size

S60 3rd Edition FP1

Used at installation time to determine whether the destination drive has capacity for accommodating both the application files and the RMS space needed to run the application.

The amount of RMS space defined by MIDlet-Data-Size is not guaranteed to be available for the application. The required space is not pre-allocated for the application.

Installation is allowed only to drives with enough free space. The amount of needed space is calculated from the attributes MIDlet-Jar-Size and MIDlet-Data-Size.

S60 3rd Edition FP1 and earlier: The maximum value is 1MB and is checked during installation. RMS implementation also allocates space from file system according to this attribute.

S60 3rd Edition FP2 - S60 5th Edition: The maximum value is 1MB and is checked during installation. No reserve file is made.

Symbian^3 and later (JRT2.1 onwards): No maximum value. No reservation file is made..

Nokia-Forward-Lock

Symbian^3 (Java Runtime 2.1)

Specifies whether the MIDlet suite in the MIDlet Message is installed as forward-locked. Forward-locked means that the MIDlet suite JAR file from the MIDlet Message is DRM-encrypted during installation.

If this attribute is set to true, the MIDlet suite is installed as forward-locked. The default value is false.

This is an optional attribute.

For more information, see MIDlet Message.

Possible values:

  • true

  • false (default)

Example:

Nokia-Forward-Lock: true

 Nokia-MIDlet-App-Orientation

S60 5th Edition

Allows MIDlet to force either portrait or landscape UI orientation. The orientation is only fixed on devices that support the specific layout.

portrait or landscape

 Nokia-MIDlet-Background-Event

S60 3rd Edition FP 2

Specifies MIDlet behavior to background event.

If value is pause, pauseApp() is called when on to background event takes place. If on to foreground event takes place, startApp() is called.

By default the attribute value is run and therefore pauseApp() and startApp() are not called when on to background event takes place.

Note: When designing the MIDlet, take into account that startApp() can be called many times.

pause or run

Example:

Nokia-MIDlet-Background-Event: pause

Nokia-MIDlet-Block-Uninstall

S60 3rd Edition FP 2

Prevents uninstallation of the MIDlet Suite if value of this attribute is true.

Only Manufacturer or Operator signed applications are able to use this attribute.

Note: This attribute must be specified in the JAR manifest file.

true or false

Example:

Nokia-MIDlet-Block-Uninstall: true

Nokia-MIDlet-Canvas-Scaling-Orientation-Switch

S60 3rd Edition FP 2

Nokia-MIDlet-Canvas-Scaling-Orientation-Switch is always used together with Nokia-MIDlet-Original-Display-Size (see above). As Nokia-MIDlet-Original-Display-Size is used to indicate a fixed resolution that full screen Canvas content of the MIDlet is designed for, then additionally specifying Nokia-MIDlet-Canvas-Scaling-Orientation-Switch to true indicates that the MIDlet can also support the given resolution in both portrait and landscape resolutions.

For an illustration, see figure LCDUI Canvas scaling on orientation switch.

Note: Behavior of combination Nokia-MIDlet-Canvas-Scaling-Orientation-Switch: true and set Nokia-MIDlet-Target-Display-Size is undefined. You should avoid using these two attributes together.

true or false

Example:

Nokia-MIDlet-Canvas-Scaling-Orientation-Switch: true

Nokia-MIDlet-Category

S60 2nd Edition

Defines localized installation folder for MIDlet.

Possible values:

  • Application (S60 1st Edition MIDlets use this)

  • Game

 Nokia-MIDlet-Delete-Confirm-<locale>

Symbian^3 (Java Runtime 2.1)

Specifies the localized confirmation prompt shown by the Application Management Software (AMS) when the user selects to remove the MIDlet or MIDlet suite.

For a list of supported locales, see section Supported locales.

For the non-localized version of this attribute, see MIDlet-Delete-Confirm.

Examples:

Nokia-MIDlet-Delete-Confirm-en: Are you sure you want to delete this MIDlet?

Nokia-MIDlet-Delete-Confirm-fi-FI: Haluatko varmasti poistaa tämän MIDletin?

Nokia-MIDlet-Flip-Close

S60 3rd Edition FP 2

Specifies MIDlet behavior on flip-close event.

If value is pause, pauseApp() is called when the flip is closed. If the flip is then opened, startApp() is called.

By default the attribute value is run and therefore pauseApp() and startApp() are not called when flip is closed.

Note: If a MIDlet is already in background, it does not get any notification about flip close event.

Note: In some cases, MIDlets may remain in background when the flip is opened. In these cases, the user needs to bring MIDlet to foreground, by using the ShowNotify() call in Canvas or using an Options menu Command with a call to resumeRequest() in a Form based MIDlet.

Attribute Nokia-Background-Event (see below) with value pause can be used as well.

pause or run

Example:

Nokia-MIDlet-Flip-Close: pause

Nokia-MIDlet-Launch-Params

Symbian^3 (Java Runtime 2.1)

Specifies the set of parameters that the application supports when launched using launchapp: or javaapp: URI platform request

For more information, see Launching a MIDlet from another MIDlet .

Comma separated list of property names.

Example:

Nokia-MIDlet-Launch-Params: sounds,difficulty,wizard_mode

Nokia-MIDlet-Name-<locale>

Symbian^3 (Java Runtime 2.1)

The localized name of the MIDlet suite for the specified locale.

For more information, see MIDlet name localization

Examples:

Nokia-MIDlet-Name-es-MX: HolaMundo

Nokia-MIDlet-Name-en: HelloWorld

Nokia-MIDlet-<n>-<locale>

Symbian^3 (Java Runtime 2.1)

The localized name of the MIDlet.

For more information, see MIDlet name localization

Examples:

Nokia-MIDlet-1-en-GB: LocalisedMIDlet

Nokia-MIDlet-1-en-US: LocalizedMIDlet

 Nokia-MIDlet-No-Exit

S60 3rd Edition FP 2

Prevents the MIDlet from closing via pressing the End key. Instead of closing the MIDlet it is put to the background. The MIDlet can be still closed from the list of open applications.

true or false

Example:

Nokia-MIDlet-No-Exit: true

 Nokia-MIDlet-On-Screen-Keypad

S60 5th Edition

Specifies the on-screen keypad for a Canvas application.

This attribute is valid only in touch-enabled devices that have limited physical key availability.

no, gameactions, or navigationkeys.

Example:

Nokia-MIDlet-On-Screen-Keypad: gameactions

 Nokia-MIDlet-On-Screen-Softkeys-Position

S60 5th Edition (Java Runtime 1.4)

Defines where softkeys are placed on the screen when using the on-screen keypad on devices that have no physical softkeys.

right or bottom

Nokia-MIDlet-Original-Display-Size

S60 3rd Edition

Specifies the resolution for which the MIDlet was designed. This is used to adapt the MIDlet for full-screen mode on a mobile device. Scaling applies to a full screen LCDUI Canvas only.

<width,height>

Example:

Nokia-MIDlet-Original-Display-Size: 176,208

 Nokia-MIDlet-S60-Selection-Key-Compatibility

S60 3rd Edition FP 2

This attribute changes the default Selection key behavior in Canvas and CustomItem elements.

By default, normal mode Canvas and CustomItem do not get low level key events for Selection key even if there is no CommandListener defined. For backward compatibility to Symbian Editions prior to S60 3rd Edition FP 2, it is possible to enable low-level key event triggering from Selection key in CustomItem, normal mode Canvas and in full screen Canvas with Commands and CommandListener defined.

If this attribute is set as true, no Commands are mapped to Selection key, instead the relevant low-level key event is triggered (-5). Note that in a full screen mode Canvas without any Commands and CommandListener defined, this feature does not have any effect as low level key events are triggered from all softkeys in any case.

true or false

Example:

Nokia-MIDlet-S60-Selection-Key-Compatibility: true

 Nokia-MIDlet-Splash-Screen-Image

Symbian^3 (Java Runtime 2.1)

Defines the custom start-up screen ("splash screen") used by the MIDlet. This attribute can also be used to define multiple custom start-up screens for the device to choose from or to disable ("suppress") the start-up screen for the MIDlet.

Examples:

Nokia-MIDlet-Splash-Screen-Image: splash_300x300.png

Nokia-MIDlet-Splash-Screen-Image: portrait_300x600.jpg, landscape_600x300.jpg, splash_300x300.png

Nokia-MIDlet-Splash-Screen-Image: suppress

 Nokia-MIDlet-Tap-Detection-Options

S60 5th Edition (Java Runtime 1.4)

Sets the size of tap detection area and tap time-out on Touch UI devices. If the pointer stays pressed within the detection area and does not surpass the time-out value, the event is considered a single tap. If the pointer leaves the detection area or the time-out passes, drag events start being generated.

The detection area is a rectangle, measured in twips. The entered value is half the length of one side of the rectangle.

Size of the detection rectangle in twips and time-out value in milliseconds, separated by a comma

Example:

Nokia-MIDlet-Tap-Detection-Options:100,250

 Nokia-MIDlet-Target-Display-Size

S60 3rd Edition

Specifies the target size for the MIDlet. This is usually the same as the screen size of the target device. This attribute is usually used in conjunction with the Nokia-MIDlet-Original-Display-Size (see below). Scaling applies to full screen LCDUI Canvases only.

<width,height>

Example:

Nokia-MIDlet-Target-Display-Size: 240,320

Nokia-MIDlet-UID-<n>

S60 3rd Edition FP 2

Predefined UID (Unique IDentifier) for a MIDlet. The value of <n> must match to MIDlet-<n> attribute.

UID can be from following ranges:

  • Unprotected range 0xA0000000 - 0xAFFFFFFF

  • Protected range 0x20000000 - 0x2FFFFFFF

  • Test range 0xE0000000 - 0xEFFFFFFF

Note: In the case the UID is from protected range, the MIDlet Suite must be signed and the UID must be specified in both the JAD and the JAR manifest file. For more details, see section Pre-defined UID attributes

For more information on UID values in MIDlet development, see Symbian signed process web page.

Examples:

Nokia-MIDlet-UID-1: 0xE0000000

Nokia-MIDlet-UID-2: 0xE0000001

Nokia-Scalable-Icon

(and Nokia-Scalable-Icon-MIDlet-<n>)

S60 3rd Edition FP 2

Specifies scalable MIDlet icon support.

When developing MIDlet suites, the MIDlet specific attributes MIDlet-n and Nokia-Scalable-Icon-MIDlet-<n> must be used.

For more information, see Scalable icon support.

<link to svg icon>

Example:

Nokia-Scalable-Icon: /icons/gamesuite.svg

 Nokia-UI-Enhancement

S60 3rd Edition FP 2

Specifies the following:

  • Theme (skin) behavior on a normal mode Canvas (not full screen) component. The background image is shown if the attribute value is CanvasHasBackground. If the attribute is not defined, by default the background is white (corresponds to Display.getColor(COLOR_BACKGROUND)). If the MIDlet does not render all the pixels of a given clip region in the paint method, the theme background is shown.

  • Receiving media key events while the MIDlet is running.

  • Setting TextBox as a pop-up TextBox.

  • Replacing the default pop-up TextBox with a full-screen TextBox.

  • Disabling automatic audio muting for the Meeting and Silent profiles. This feature is only supported from Java Runtime 2.1 onwards.

Note: The attribute value is a comma-separated list, so several values can be specified.

Examples:

Nokia-UI-Enhancement: CanvasHasBackground

Nokia-UI-Enhancement: MusicKeysSupported

Nokia-UI-Enhancement: PopUpTextBox

Nokia-UI-Enhancement: FullScreenTextBox

Nokia-UI-Enhancement: IgnoreProfilesBasedSoundMuting

The following JAD and JAR manifest attributes are specified for Series 40 devices.

 
Table: Nokia-proprietary manifest attributes for Series 40

Attribute name

Since Series 40 Edition

Description

Value

Nokia-MIDlet-Background-Exit-Confirm-<locale>

Series 40 6th Edition

Prompt to use in a confirmation before stopping a background MIDlet prior when freeing heap space.

Note: Background MIDlets are enabled only for operator and manufacturer domains.

Example:

Nokia-MIDlet-Background-Exit-Confirm-en : Don't stop me please

Nokia-MIDlet-bg-launchpad

Series 40 5th Edition FP 1

Indicates MIDlet-n in the suite that is a launchpad MIDlet (JAR explorer).

Note: Background MIDlets are enabled only for operator and manufacturer domains.

Example:

Nokia-MIDlet-bg-launchpad: 2

Nokia-MIDlet-bg-memory-size

Series 40 3rd Edition FP 2

Indicates that the MIDlet can run in the background and defines the amount of heap it is allowed in the background in kb.

Note: Background MIDlets are enabled only for operator and manufacturer domains.

Integer

Example:

Nokia-MIDlet-bg-memory-size: 256

Nokia-MIDlet-bg-server

Series 40 5th Edition FP 1

Indicates MIDlet-n in the suite that is a BG server.

Note: Background MIDlets are enabled only for operator and manufacturer domains.

Example:

Nokia-MIDlet-bg-server: 1

Nokia-MIDlet-bg-user-disable

Series 40 5th Edition FP 1

Indicates if the MIDlet can be stopped by the user to free background heap for another MIDlet to start. Note: true or absence of this attribute means the MIDlet can be stopped.

Note: Background MIDlets are enabled only for operator and manufacturer domains.

true or false

Example:

Nokia-MIDlet-bg-user-disable: true

Nokia-MIDlet-bg-version

Series 40 6th Edition

Indicates the background API version required to run the MIDlet.

Note: Background MIDlets are enabled only for operator and manufacturer domains.

Example:

Nokia-MIDlet-bg-version: 1.0

Nokia-MIDlet-Category

Series 40 6th Edition

Used to determine the folder to which MIDlets are stored following an OTA Download.

Note: This is a JAD only attribute and applicable only to BG MIDlets. The value is case sensitive.

Possible values:

  • Nokia-MIDlet-Category: Application

  • Nokia-MIDlet-Category: Commerce

  • Nokia-MIDlet-Category: Game

  • Nokia-MIDlet-Category: Messaging

  • Nokia-MIDlet-Category: Screensaver

Nokia-MIDlet-Category

Series 40 6th Edition

IdleScreen - Identifies a MIDlet that is capable of displaying content on the idle screen.

PassiveIdleScreen - Identifies a MIDlet that is capable of running as an idle skin application (taking over the whole main zone).

Search - Identifies a MIDlet that provides search capabilities used by a native idle search application.

Example:

Nokia-MIDlet-Category: IdleScreen

Nokia-MIDlet-Close-Gprs-Context

Series 40 5th Edition FP 1

If set totrue, after all HTTP connections are closed, there is a time-out of 10 seconds before shutting down GPRS context . By default there is no time out, which means the GPRS context will be kept till the MIDlet exits.

Example:

Nokia-MIDlet-Close-Gprs-Context: true

Nokia-MIDlet-Connectionsettings

Series 40 6th Edition Lite

Provides an identifier string for provisioned connection settings. It specifies provisioned proxy or access point settings to be used when the MIDlet is accessing the network (over HTTP or TCP/UDP).

The given identifier provides one-to-one mapping to the connection settings. The identifier has to conform with OMA DM and WAP Provisioning standards.

The identifier strings are specific to the manufacturer or operator.

If settings are not specified, default settings are used.

Nokia-MIDlet-Connectionsettings: specialProxy

Nokia-MIDlet-Name-<locale>

Series 40 3rd Edition

Localized MIDlet suite name

For more information, see MIDlet name localization

Example:

Nokia-MIDlet-Name-en: Bounce

Nokia-MIDlet-Name-n-<locale>

Series 40 3rd Edition

Localized MIDlet name for MIDlets in the suite

For more information, see MIDlet name localization

Example:

Nokia-MIDlet-1-en: Bounce

Nokia-MIDlet-national-digit-display

Series 40 5th Edition

Used to enable national rather than Latin digit display.

Example:

Nokia-MIDlet-national-digit-display: true

Nokia-MIDlet-no-exit

Series 40 3rd Edition FP 2

Indicates a MIDlet that cannot exit once started.

true or false

Example:

Nokia-MIDlet-no-exit: true

Nokia-MIDlet-Save-Location

Series 40 5th Edition FP 1

Used to determine download folder (currently only supports the root (predefjava) folder).

Example:

Nokia-MIDlet-Save-Location: Root

Nokia-Service

Series 40 5th Edition FP 1

Used to indicate an upload service. Upload services are downloaded with different UI to other MIDlets.

true or false

Example:

Nokia-Service: true

Nokia-UI-Enhancement

Series 40 3rd Edition

Specifies the following:

  • Theme (skin) behavior on a normal mode Canvas (not full screen) component. The background image is shown if the attribute value is CanvasHasBackground. If the attribute is not defined, by default the background is white (corresponds to Display.getColor(COLOR_BACKGROUND)). If the MIDlet does not render all the pixels of a given clip region in the paint method, the theme background is shown.

  • Receiving media key events while the MIDlet is running.

Note: The attribute value is a comma-separated list, so several values can be specified.

Examples:

Nokia-UI-Enhancement: CanvasHasBackground

Nokia-UI-Enhancement: MusicKeysSupported

Nokia-Update

Series 40 3rd Edition

Version update URL, used when doing Update Check. If no URL then Update Check is disabled.

Example:

Nokia-Update: http://myserver.com/Bounce.jad

progressive_download

Series 40 3rd Edition FP 2

Set to enabled to enable JSR-135 progressive playback.

Example:

progressive_download: enabled

Background MIDlets

Background MIDlets are enabled for operator and manufacturer domains only. The number of MIDlets that can run concurrently is determined by product configuration that takes into account the amount of RAM that can be made available for the Java heap. The ability of the device to run MIDlets in the background is a key enabler for services such as Email and IM that need to remain in contact with a remote server even when not on display. MIDlets that run in the background are pre-allocated heap space from the available background heap. The amount allocated is determined by the Nokia-MIDlet-BG-memory-size attribute in their JAD file.