Start Trace and Stop Trace
This section describes the tags to start and stop Unified Trace (UTrace)
for tasks running on the Symbian device hardware or emulator.
In the TestDriver XML file, the <startTrace>
element
and the <stopTrace>
element are children of the <task>
element. Each <task> includes at most one pair of <startTrace> and
<stopTrace>. They are used together to enable UTrace for one or more
tasks.
A trace file is generated when the test suite executes. A hyperlink for
the trace file is provided in the test execution HTML report. You can click the
link and select a trace viewer to view the trace file.
The <startTrace>
element has the following attributes:
Name
|
Description
|
configFilePath
|
Optional. The path of the user configuration file for UTrace. If
not present, the UTrace default configuration file is used.
|
enablePrimaryFilter
|
Optional. A comma-separated list of integers to indicate which
primary filters must be enabled.
|
disablePrimaryFilter
|
Optional. A comma-separated list of integers to indicate which
primary filters must be disabled.
|
enableSecondaryFilter
|
Optional. A comma-separated list of integers to indicate which
secondary filters must be enabled.
|
disableSecondaryFilter
|
Optional. A comma-separated list of integers to indicate which
secondary filters must be disabled.
|
Note: For information about UTrace, the user configuration
file and filters, refer to Symbian Developer Library > Symbian OS Tools And
Utilities > Unified Trace Solution > Overview of Unified Trace Solution.
Example
An example XML code snippet with <startTrace>
and
<stopTrace>
is as follows:
<task name="demo" timeout="100000">
<startTrace enablePrimaryFilters=”20,21”/>
<executeOnSymbian>
<testExecuteScript PCPath="TefProjectSuite.script" SymbianPath="c:\scripts\TefProjectSuite.script"/>
</executeOnSymbian>
<stopTrace/>
</task>