Capabilities

Capabilities allow the S60 platform and the underlying Symbian OS to control access by applications to the functionalities provided by the platform APIs. Access to capabilities is determined by the device configuration and how the application has been signed. Capabilities can be divided into four categories:

• user capabilities: LocalServices, NetworkServices, ReadUserData, WriteUserData, UserEnvironment and, from S60 3rd Edition, Feature Pack 2 onwards, Location

• system capabilities: PowerMgmt, ProtServ, ReadDeviceData, SurroundingsDD, SwEvent, TrustedUI, WriteDeviceData and, prior to S60 3rd Edition, Feature Pack 2, Location

• restricted capabilities: CommDD, DiskAdmin, MultimediaDD and NetworkControl

• device manufacturer capabilities: AllFiles, DRM and TCB

Capabilities required by the application are defined in the mmp project definition file during the build process, and cannot be changed during run time. For information on the parameters you can use, see capability in the Symbian OS Library. Carbide.c++ has a Capability Scanner tool which can be accessed through the Project > Run Capability Scanner on Project MMP menu. The tool scans and checks the project for required capabilities.

During the installation the Software Installer application in the device checks whether the application has been certified or signed. It then checks the capabilities requested by the application. If the application has been certified, it checks that the root certificate is allowed to grant the required capabilities. If no problems are encountered, the installation can continue. For information on certifications required by the capabilities, see Application signing.

The user can grant the user capabilities to a self-signed application. For example, the following dialog is shown to the user to grant the LocalServices capability:

Figure: Granting LocalServices capability during the installation