Enabling and Disabling Trace

This section describes how to enable and disable tracing for a test suite on the Symbian OS device or emulator.

In the TestDriver XML, <startTrace> and <stopTrace> are used together for one or more tasks. Trace information is then generated when the test suite is executed.

Procedure

  1. Open and edit the TestDriver xml (.driver) from a text editor.

  2. Identify the tasks for which trace is to be enabled.

  3. Insert the <startTrace> element and <stopTrace> element for those tasks. For example, to enable the trace for <executeOnSymbian> and <testExecuteScript> tasks, insert <startTrace> and <stopTrace> as follows:

    <task name="demo" timeout="100000">
          <startTrace enablePrimaryFilters=”20,21”/>
          <executeOnSymbian>
            <testExecuteScript PCPath="TefProjectSuite.script" SymbianPath="c:\scripts\TefProjectSuite.script"/>
          </executeOnSymbian>
          <stopTrace/>
        </task>

    Note: The enablePrimaryFilters attribute is set for <startTrace>. It specifies the trace level. For more information about UTrace filters, refer to Symbian Developer Library > Symbian OS Tools And Utilities > Unified Trace Solution > Overview of Unified Trace Solution.

  4. Save the changes to the XML file and run the test suite.

Results

In the HTML test report generated, the Trace hyperlink is provided. You can click the link and select a trace viewer to view the trace file.