Qt Simulator Manual 1.2.0

[Previous: Simulating Touch] [Next: Adding New Device Models]

Contents

Scripting

The Qt Simulator JavaScript interface enables you to automate recurring sets of changes or to simulate a continuously changing environment.

"Scripting"

Locating Scripts

Create a script (.js or .qs) that sets the device to its desired state when you open an application in Qt Simulator. Place the script in the scripts/autostart/ folder to run it automatically when Qt Simulator starts.

You can then use the Qt Simulator views to change the default settings according to your test cases. To run the same tests repeatedly or to test complicated sequences of events, create scripts and place them in the scripts folder.

Place you favorite scripts in the scripts/favorites/ folder.

Example scripts are located in scripts/examples/.

To open the folder that contains the scripts in a file browser, select Show Folder Content. To locate and run scripts in other folders, select Run Other Script.

Running Scripts

To run a script:

  • Click the JS quick access button to bring up a list of scripts in the scripts/favorites/ folder.
  • Double-click a script in the Scripting tab that shows the scripts in the scripts/ folder, or select Run Selected Script.
  • Place a script in the scripts/autostart folder to run it when Qt Simulator starts.
  • Select Run Other Script to run scripts from any folder on the development PC or on a network resource. The script is automatically run when you select it.
  • Add the -runscript <script file> parameter to a call of the Qt Simulator application on the command line to trigger the execution of a script in the currently running Qt Simulator instance externally.

The Active scripts field shows a list of currently active scripts. To pause or resume a script, select it and click Pause. To abort a script, select it and click Abort.

Editing Scripts

To edit a script in a text editor, select it and then select Edit Script.

Note: You have to set a default editor for .qs files in your system.

Function Reference

The following objects and functions are added to the common JavaScript global scope:

[Previous: Simulating Touch] [Next: Adding New Device Models]

© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.

All other trademarks are property of their respective owners. Privacy Policy


Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.

Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.

X

Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.

[0]; s.parentNode.insertBefore(ga, s); })();