Introduction to Symbian OS test tools

The Symbian OS test tools include the following:

• Compatibility Test Suite (CTS) - This allows licensees to check their Symbian OS implementation for compliance with the CustKit licence.

  The CTS is made up of the BC Comparator (checking binary compatibility between an original and derived Symbian OS release), and the Kit Comparator (checking that all requisite components are available to 3rd party developers when building SDKs from Symbian OS Development Kits). It also includes the Program Checker (checking the Symbian OS APIs used by a Symbian program, or a set of programs).

  The CTS alsoFunctionality Checkers (ensuring particular components are operating as required on released phones)

• API Regression Test Suite for Compatibility Verification - This provides tests that partners and licensees can run to test that Symbian OS APIs in a particular device behave as expected for the Symbian OS platform.

• Test Driver - This is a command line tool that allows you to define, build and run Symbian OS test suites on a device or emulator from a PC. It also allows you to retrieve test logs and report test results. As part of using Test Driver, you also need to define a set of XML files that describe your tests, see Test XML Definitions.

• Capability Management tools - These are command line tools that allows you to compare capabilities of binaries that have been developed against Symbian OS, with a pre-defined list of capabilities within a standard Symbian OS ROM image. This is to make sure that your applications have been assigned the correct access rights. The tools available are CapSearch, CapCheck and CapImportCheck.

• MigrationCheck tool - This is a command line tool that allows you to check which Symbian OS APIs need to be migrated from one version to another, when upgrading your program to work on a later release of Symbian OS.

• Set capability test tool - SetCap (Version 9.0 and later) - This is a tool that allows you to make a copy of an executable, and to assign different capabilities to it. This allows you to test the executable with different capability combinations, and avoids the overhead of maintaining multiple copies of the executable's .mmp file (each specifying a different capability combination), and the need to re-build each copy after a code change.

These tools, except the Set capability tool, are installed as part of the Symbian OS Development Kit or Symbian OS Customization Kit and can be found in the <EPOCRoot>\epoc32\tools\<tool_name> directory.

The Set capability tool is a Symbian OS executable.