|
MIDlet-Data-Size
|
S60 3rd Edition FP1
|
All
|
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 for Symbian)
|
All
|
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:
Example:
Nokia-Forward-Lock: true
|
|
Nokia-MIDlet-App-Orientation
|
S60 5th Edition
|
All
|
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-auto-start
|
Symbian^3 (Java Runtime 2.2 for Symbian)
|
Manufacturer / operator
|
Specifies how the MIDlet is auto-started on device boot.
Note: The attribute must be given both in JAD and JAR manifest, and the value of the attribute must be the same for both.
|
Possible values:
Example:
Nokia-MIDlet-auto-start: yes
|
|
Nokia-MIDlet-Background-Event
|
S60 3rd Edition FP 2
|
All
|
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
|
Manufacturer / operator
|
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
|
All
|
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
|
All
|
Defines localized installation folder for MIDlet.
|
Possible values:
|
|
Nokia-MIDlet-Delete-Confirm-<locale>
|
Symbian^3 (Java Runtime 2.1 for Symbian)
|
All
|
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
|
All
|
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.
|
pause or run
Example:
Nokia-MIDlet-Flip-Close: pause
|
|
Nokia-MIDlet-Launch-Params
|
Symbian^3 (Java Runtime 2.1 for Symbian)
|
All
|
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 for Symbian)
|
All
|
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 for Symbian)
|
All
|
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
|
All
|
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
|
All
|
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 for S60)
|
All
|
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
|
All
|
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
|
All
|
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 for Symbian)
|
All
|
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 for S60)
|
All
|
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
|
All
|
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
|
All
|
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
|
All
|
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-Developer-Utils
|
Symbian^3 (Java Runtime 2.2 for Symbian)
|
All
|
Enables developer tools for:
-
Monitoring graphics memory consumption (GPUMem)
-
Highlighting 2D elements when mixing 2D and 3D graphics (2DBorders)
-
Measuring frame rate per seconds (FrameRate)
For more information about these tools, see section Monitoring graphics performance.
Note: The attribute value is a comma-separated list, so you can specify multiple values for the same MIDlet.
|
Comma-separated list of property names.
Example:
Nokia-UI-Developer-Utils: FrameRate, GPUMem, 2DBorders
|
|
Nokia-UI-Enhancement
|
S60 3rd Edition FP 2
|
All
|
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 for Symbian onwards.
-
Setting the MIDlet to support video overlays. This feature is only supported from Java Runtime 2.2 for Symbian onwards.
-
Enabling multipoint touch events. This feature is only supported from Java Runtime 2.2 for Symbian 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
Nokia-UI-Enhancement: VideoOverlaySupported
Nokia-UI-Enhancement: EnableMultiPointTouchEvents
|