Introduction to TestDriver

The TestDriver tool 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 automatically runs tests, retrieves test logs and produce a report indicating test success or failure.

Before you can use TestDriver, you need to define a set of XML files that describe your tests.

You also need to install and configure TestDriver before building or running any tests. This section describes how to configure TestDriver, build tests and test suites into a repository on your machine, run tests on a target device, and view test logs and test results.

The TestDriver tool is provided as part of the Symbian OS Development Kit and can be found in the <EPOCRoot>\epoc32\tools\TestDriver directory.

The process of using TestDriver involves:

• Installing and configuring TestDriver - this includes setting up the EPOC drive, an XML root directory, a repository and a result location.

• Defining a test suite hierarchy - this includes structuring your tests into a tree hiearchy on your PC.

• Communicating with a device - this includes configuring communication ports and setting up the relevant files on a device so that you can run tests on the actual device, from your PC.

• Viewing the test suite hierarchy - this includes printing the test and suite XML to screen, to check that they have been correctly specified.

• Building test suites - this includes building tests and/or suites and collating the resulting binaries and data files into a repository.

• Building test packages - this includes combining the XML stucture you have specified and the corresponding built repository into a test package, which can then be distributed and run independently.

• Storing test suites - this includes storing the built tests and suites in a repository reflecting the test suite hierarchy.

• Running tests and test suites - this includes executing the tests and/or test suites to be run on either an emulator or device.

• Running test packages - this includes executing test packages, on either an emulator or device.

• Viewing test results - this includes viewing all the results from running the tests in a specified result lcoation.

• Command line reference

• Test XML definitions