<rim:permissions> <rim:permit>permission string</rim:permit> </rim:permissions>
The <rim:permit> element specifies permission access to various features in a BlackBerry WebWorks app (for example, accessing the GPS location or the camera).
One or more
You can specify the following attributes:
attribute indicates that the specified permission is a system permission. Set system="true" to indicate a system permission.
Currently, the only permission that must be specified as a system permission is _sys_use_consumer_push.
You can specify access to the following features:
Allows this app to take pictures, record video, and use the camera's flash.
Allows this app to access device identifiers such as serial number and PIN.
Allows this app to access the device’s current or saved locations. This permission replaces read_geolocation, and includes access to location information from GPS, Wi-Fi, and cell ID.
Allows this app to record sound using the microphone.
Allows this app to access pictures, music, documents, and other files stored on the device, at a remote storage provider, on a media card, or in the cloud.
Allows this app to use push functionality.
|Run in background||
Your app can run in the background if you include the run_when_backgrounded permission or the blackberry.push feature ID in your configuration file.
Important: Use this feature sparingly and only when your app must perform processing in the background.
|BBM Social Platform||
Allows this app to connect to BBM so that the user can chat or update their BBM profile without leaving the BBM connected app.
|Email and PIN messages||
Allows this app to access email and PIN messages, including viewing, creating, sending, and deleting messages.
Allows this app to access contacts, including viewing, creating, and deleting contacts.
Allows this app to access the calendar, including viewing, adding, and deleting appointments.
Allows this app to post a notification to the notification area of the screen.
Allows this app to access text messages, including adding and deleting messages.
Example: Specifying permissions
The following example demonstrates how to set the permissions for reading and writing files, recording audio, accessing camera data, and push.
<rim:permissions> <rim:permit>access_shared</rim:permit> <rim:permit>record_audio</rim:permit> <rim:permit>use_camera</rim:permit> <rim:permit system="true">_sys_use_consumer_push</rim:permit> </rim:permissions>
Last modified: 2014-03-10