Running Applications on Multiple Targets

By default, running an application also builds it and deploys it to a location from where it can be run on the desktop, in Qt Simulator, or on a mobile device that is connected to the development PC.

To run executable files without deploying them first, deselect the Tools > Options... > Project > Always deploy project before running it option. This allows you to test SIS files that you receive from Ovi Publishing or Symbian Signed after you have them signed, for example.

For more information on the options you have, see Specifying Run Settings.

Running on Desktop

1. Select Desktop as the target.

   

2. Click the Run button.

Running on Qt Simulator

You can use the Qt Simulator to test Qt applications that are intended for mobile devices in an environment similar to that of the device. You can change the information that the device has about its configuration and environment.

1. Select Qt Simulator as the target.
2. Click the Run button.

For more information about using the Qt Simulator, see the Qt Simulator Manual.

Running on Maemo or MeeGo Harmattan

1. Build and run the application for Qt Simulator.
2. Build and run the application for the Maemo or MeeGo Harmattan emulator.
3. Alternatively, you can build and run the application for a device:
   1. Configure the device and specify a connection to it. For more information, see Connecting Maemo and MeeGo Harmattan Devices.
   2. Connect the device to the development PC.
   3. Click the Run button.

Qt Creator uses the compiler specified in the MADDE tool chain to build the application.

Qt Creator generates an installation package, installs it on the device, and executes the selected application. The application views are displayed on the device. Command-line output is visible in the Qt Creator Application Output view.

Choose Projects > Maemo Run to view the settings for deploying the application on the connected device and creating the installation package. For more information, see Specifying Run Settings for Maemo and MeeGo Harmattan Devices.

Debugging also works transparently.

Running on Symbian

1. Build and run the application for Qt Simulator.
2. If no problems are found, build and run the application for a device.
3. To test functionality that uses Symbian APIs, you can build and run the application for Symbian Emulator.

Running on a Device

1. Install the required software on the device. For more information, see Connecting Symbian Devices.
2. Connect the device to the development PC through a USB cable. The target selector displays a green check mark when a device is connected.

   

   The tool tip of the target selector shows more details about the actual device that will be used when you run your application.

3. Start the debugging agent (CODA or App TRK) application on your device.

   Note: If you use CODA over an USB connection, it starts up automatically when you connect the device to the development PC.

4. Click the Run button.

You can connect several devices to your development PC simultaneously. In the details of the run configuration for the Symbian Device target, select the device to run your application on.

When your application is ready for delivery to users, specify run settings for creating the final SIS installation packages. For more information, see Creating SIS Files.

If you cannot run the application on a device, check that:

• The Nokia USB drivers that come with PC Suite or Ovi Suite have been installed on the development PC.
• The device is connected through USB cable in PC Suite mode.
• The debugging agent (App TRK or CODA) is running on the device with the status connected.

  Note: If you use the CODA debugging agent over WLAN, you must enter the WLAN address and port number in Qt Creator, separated by a colon (:). For example: 192.167.0.100:1534

• The device is detected and selected in the Run Settings.

If this does not help to solve your problem, search the qt-creator@trolltech.com mailing list archives or provide feedback to us via the methods described on the Qt Creator Development Wiki.

Running on Symbian Emulator

Select the Symbian Emulator target as the active one, and build and run your project.

If you cannot run the application in the emulator, check that:

• You selected the Symbian Emulator target for your application.
• If you cannot select Symbian Emulator as target, check that Carbide.c++ is installed correctly and that the path to the Carbide.c++ installation directory is specified for the WINSCW tool chain in the Compiler path field in Tools > Options... > Tool Chains.
• If the emulator process cannot be started, try closing Qt Creator and starting the application directly from your file manager. Having done this, Qt Creator should be able to run your projects in the emulator.