Specifying supported versions of the BlackBerry Device Software

BlackBerry® device applications that use APIs that are only available on particular versions of the BlackBerry® Device Software should specify the supported BlackBerry device versions using the _blackberryVersion attribute.

BlackBerry device applications for use with a BlackBerry device running on a specific platform version should specify supported platform versions using the _platformVersion attribute. The _platformVersion attribute can be used within the directory tag, the application tag, or the fileset tag.

You can use the following rules to specify a version range for the BlackBerry Device Software or the platform version:

  • Square brackets [] indicate inclusive (closed) range matching.
  • Round brackets () indicate exclusive (open) range matching.
  • Missing lower ranges imply 0.
  • Missing upper ranges imply infinity.

For example, [4.0,) indicates any version between 4.0 and infinity.

Code sample: Preventing modules from loading on versions of the BlackBerry Device Software earlier than version 4.0.

<application id="application_id" _blackberryVersion="[4.0,)">
...
</application> 

Code sample: Providing alternative modules for different versions of the BlackBerry Device Software.

<application id="application_id>">
...
<fileset _blackberryVersion="(,4.0)">  
... modules for BlackBerry device software versions earlier than 4.0
</fileset>
<fileset _blackberryVersion="[4.0,)"> 
... modules for BlackBerry device software versions 4.0 and later
</fileset>
</application> 

Code sample: Preventing modules from loading on versions of the platform earlier than version 2.4.0.66.

<application id="application_id" _platformVersion="[2.4.0.66,)">
...
</application> 

Code sample: Providing alternative modules for different versions of the platform.

<application id="application_id>">
...
<fileset _platformVersion="(,2.4.0.66)">  
... modules for BlackBerry OS plaform versions earlier than 2.4.0.66
</fileset>
<fileset _platformVersion="[2.4.0.66,)"> 
... modules for BlackBerry OS plaform versions 2.4.0.66 and later
</fileset>
</application> 

Index


Was this information helpful? Send us your comments.