This task transfers a file from the PC to the Symbian device (hardware or emulator).

In the build phase of TestDriver, all files specified in the <transferToSymbian> operation will be collected in a repository and a SIS package will be created irrespective of PlatSec being on or off.

In the run phase of TestDriver, if the PlatSec is on, the SIS file will be transfered and installed at the beginning of the task, and uninstalled and deleted at the end of the task. If PlatSec is off, the files in the repository will be transfered at the beginning of the task and deleted at the end of the task.

The sub-task <transfer> transfers a file from the PC to the Symbian device. When used with <transferToSymbian>, wildcards and variables are allowed.

This sub-task has the following attributes:

1. PCPath: Path to the file on the PC. It accepts the following variables: "${epocroot}", "${sourceroot}", "${xmlroot}", "${platform}" and lastly "${build}". Wildcards and variables are allowed when defining the PC path.

   These variables point to locations and settings specified in the testdriver config command. If these variables are used for creating an absolute path then the wildcard "*" can be used to copy files in a directory. For example, ${epocroot}\a\b\${platform}\${build}\d\e\*" will copy all files from the e directory to the Symbian device.

2. SymbianPath: Path to a file on the Symbian device. This must be an absolute and a valid path.

3. move: When set to true files will be moved to the specified path, and when set to false files will be copied in the specified path.

An example xml file to describe a <transferToSymbian> task is provided below:

<transferToSymbian>
    <transfer move="false" PCPath="${epocroot}\epoc32\release\${platform}\${build}\z\plattest\pt_agenda.ini" SymbianPath="c:\plattest\pt_agenda.ini"/>
    <transfer move="true" PCPath="${epocroot}\epoc32\release\${platform}\${build}\z\plattest\PlatTest.vcs" SymbianPath="c:\plattest\plattest.vcs"/>
    <transfer move="true" PCPath="${epocroot}\epoc32\release\${platform}\${build}\z\textfiles\*" SymbianPath="c:\plattest\"/>
</transferToSymbian>

Introduction to XML Schema

TestDriverV1 XML format