(Optional) The privileges (also known as capabilities, user actions, or actions) the application requests from the OS
The <permission> element specifies the privileges (also known as capabilities, user actions, or actions) the application requests from the OS.
A PCDATA value representing the permissions granted to your application. The following identifiers specify the user permissions that can be granted to an application:
|Permission for functionality||Permission element value||Permission description|
|Automatic Input Control||_sys_inject_events||Allows the app to simulate touchscreen gestures and keys being pressed on a keyboard.|
|BlackBerry Messenger||bbm_connect||Allows the app to connect to BlackBerry Messenger (BBM). This permission also allows the app to view contact lists and user profiles, invite BBM contacts to download the app, initiate BBM chats and share content from within the app, and stream data between apps in real time.|
|Calendar||access_pimdomain_calendars||Allows the app to access the calendar on the device. This permission includes viewing, adding, and deleting calendar appointments.|
|Camera||use_camera||Allows the app to access any of the data coming from cameras on the device. This permission allows an app to take pictures, record video, and use the flash on the device.|
|Contacts||access_pimdomain_contacts||Allows the app to access to the contacts stored on the device. This permission includes viewing, creating, and deleting contacts on the device and SIM card.|
|Control Notification Settings||access_notifiy_settings_control||Allows the app to modify global notification settings. Apps only have permission to read their own notification settings.|
|Device Identifying Information||read_device_identifying_information||Allows the app to access unique device identifiers such as the PIN and serial number. This permission also allows you to access SIM card information on the device.|
|Email and PIN Messages||access_pimdomain_messages||Allows the app to access the email and PIN messages stored on the device. This access includes viewing, creating, sending, and deleting messages.|
Indicates that the app supports gamepad functionality. This permission also indicates that your app has official gamepad support in the BlackBerry World storefront.
|GPS Location (Deprecated)||read_geolocation||Deprecated. Instead, use the Location (access_location_services) permission. This permission previously allowed access to the current GPS location of the device.|
|Internet||access_internet||Allows the app to use an internet connection from a Wi-Fi, wired, or other connection. This permissions is required to access a destination that is not local on the user's device.|
|Location||access_location_services||Allows the app to access the device's current location and access locations saved on the device. This permission includes access to geolocation, geofencing, cell tower information, Wi-Fi data, and Cascades Places.|
|Microphone||record_audio||Allows the app to access the audio stream from the microphone on the device.|
|Narrow Swipe Up||narrow_landscape_exit||Allows the app, within a landscape orientation (typically games), to use the corner regions for menus and virtual game pads. This permission reduces the region of the home swipe up gesture to occur only in the middle edge of the bottom of the bezel instead of a full-length swipe. Use this permission to prevent the app from inadvertently going into the background when the corner regions are swiped.|
|Notebooks||access_pimdomain_notebooks||Allows the app to access the content stored in the notebooks on the device. This permission includes adding and deleting entries and content from notebooks.|
|Phone||access_phone||Allows the app to determine when a user is on a phone call. This access also allows an app to access the phone number assigned to the device and send DTMF (Dual Tone Multi-Frequency) tones.|
|Phone Control||control_phone||Allows the app to combine two calls together, end a call, and use the dial pad during a call.|
|Post Notifications||post_notification||Allows the app to post notifications. This permission does not require the user grant your app access and is granted by the OS when requested.|
|Push||_sys_use_consumer_push||Allows the app to use BlackBerry Push Service with BlackBerry
Internet Service. This permission allows an app to receive and
request push messages. To use the Push Service with the BlackBerry
Internet Service, you must register with BlackBerry. When you
register, you receive a confirmation email message that contains
information that the application needs to receive and request push
messages. For more information about registering, see Push Service.
It is important to be aware that if you're using the Push Service with the BlackBerry Enterprise Server or the BlackBerry Device Service, you don't need to register with BlackBerry, and you must not add the Push permission for your app.
|Run as Active Frame||run_when_backgrounded||Allows the app to perform background processing. Without this
permission, the app will be stopped when the user switches focus to
another app. Use this permission sparingly and only when your app
must perform processing in the background.
This permission is useful for apps that play music or manage downloads. Apps that use this permission are rigorously reviewed for acceptance to the BlackBerry World storefront for their use of battery power on a device.
|Run in Background||_sys_run_headless||Allows the app to perform certain tasks in the background without opening the app. Due to the potential for misuse of the functionality associated with this permission, apps that use this permission are rigorously reviewed for acceptance to BlackBerry World storefront.|
|Screen Capture||use_camera_desktop||Allows the app to take screen shots or videos of the user's screen. This permission also allows the app to share the user's screen.|
|Shared Files||access_shared||Allows the app to read and write the files that are shared between all apps on the device. This permission allows the app to access pictures, music, documents and other files that are stored on the user's device, at a remote storage provider, on a media card, or in the cloud.|
|Text Messages||access_sms_mms||Allows the app to access the text messages stored on the device. This access includes viewing, creating, sending, and deleting text messages.|
|User Contact Information||read_personally_identifiable_information||Allows the app to access user information on the device, such as the first name, last name, and BlackBerry ID username of the user currently associated with this device.|
|system||(Optional) Specifies the action is a system action and not a
user action. The default value is false.
Examples of system actions you can use are
run_native (run the app using OS runtime)
run_air_native (run the app using Adobe AIR
These actions are added implicitly to the BAR file manifest by the packager when it detects an application type that requires them.
<qnx> ... ... <permission system="true">run_native</permission> <permission system="false">access_shared</permission> <permission system="false">record_audio</permission> ... </qnx>