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.

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

<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> 

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

<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>