Troubleshooting guide

D
Appendix: BlackBerry application .jad files
Properties of BlackBerry application .jad files
The BlackBerry® Integrated Development Environment lets you create a dual-purpose .jad file to support the
downloading of MIDlets onto BlackBerry devices and other wireless devices. To do this, create a .jad file that
contains both the
RIM-COD-URL and RIM-COD-Size attributes and the MIDlet-Jar-URL and MIDlet-Jar-Size
attributes. On BlackBerry devices, download the .cod files; on other wireless devices, download the .jar files.
Set .cod file dependencies
The application descriptor (.jad) file contains a RIM-COD-Module-Dependencies attribute that specifies the
modules that the application requires, but are not provided with it. The
RIM-COD-Module-Dependencies
attribute lets a BlackBerry device user avoid downloading an application that will not run.
The RIM-COD-Module-Dependencies attribute takes a comma-separated module name list as a parameter. For
example, an application that requires the RIM XML library might use the following entry in the application
descriptor:
RIM-COD-Module-Dependencies: net_rim_cldc, net_rim_xml
Properties of BlackBerry application .jad files
Required RIM attribute Description
RIM-COD-Creation-Time
creation time of the .cod file
RIM-COD-Module-Dependencies
list of modules that the .cod file requires
RIM-COD-Module-Name
name of the module that the .cod file contains
RIM-COD-SHA1
SHA1 hash of the .cod file
RIM-COD-Size
size (in bytes) of the .cod file
RIM-COD-URL
URL from which the .cod file can be loaded
Optional RIM attribute Description
RIM-Library-Flags
reserved for use by Research In Motion (RIM)
RIM-MIDlet-Flags
reserved for use by RIM
RIM-MIDlet-NameResourceBundle
name of the resource bundle on which the application depends
RIM-MIDlet-Position
suggested position of the application icon on the Home screen
Note: This position might not be the actual position of the application icon on the Home screen.