Execute on PC

This task allows you to execute a command on the PC, be it a build command or run a Windows application.

The figure describes the subtasks that can be run using <executeOnPC>.

executeOnPC task


executeOnPC task

executeOnPC contains the following two sub tasks:

  1. cmdPC: This task is used for executing the command line tasks. Currently only programs that are able to run under MS-DOS are supported. All StdOut and StdError are parsed for "ERROR:" and "WARNING:" strings, and are recorded in the log files. You can set these attributes while running <cmdPC> task:

    • URI - TestDriver supports the usage of full URI for the –s option for the new .driver files. This allows you to use the driver files located anywhere on your system. Currently only the file:// protocol is supported. The URI does not support variables and wildcards.

    • sync - To run the command asyncronously to the current thread, set this attribute to false. The command is terminated when timeout occurs or at the end of the current task (whichever is first). By default sync is true and the current thread will wait till the command is completed or timeout occurs.

    • phase - To run the task in both the build and in the run phase. The values can be set to build, run or both.

  2. build: This task is used to build the Symbian components for TestDriver. The build chain command:

    • runs bldmake and abld commands on the PC to build the Symbian OS components

    • copies the exported binaries to the repository (defined in the config --repos command)

    • packages it into an SIS file

    • transfers the relevent file to the Symbian device (hardware or emulator)

    • installs the file

    • uninstalls and cleans up the system

    • checks for the characters, [^\\ / : \* \? \.]*].

    Provide the name of the .mmp file without the extension to build it.

    Note: Filenames should not contain any of these characters: [\/:*?.]

Example for <executeOnPC>

An example xml file to describe an <executeOnPC> task is provided below:

<executeOnPC>
    <build testBuild="true" URI="${sourceroot}\systemtest\syslibs\filestore\group\">
        <componentName>systemtest_filestore</componentName>
        <componentName>systemtest_utils</componentName>
        <componentName>systemtest_files</componentName>
    </build>
    <build testBuild="false" URI="${sourceroot}\syslibs\group\">
        <componentName>filestore</componentName>
        <componentName>ecore</componentName>
    </build>
    <cmd>notepad.exe</cmd>
</executeOnPC>