Qt Creator Manual

Running on Multiple Platforms

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.

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

Running on Desktop

  1. Select Desktop as the build and run kit.

    "Kit selector"

  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 build and run kit.
  2. Click the Run button.

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

Running on Embedded Linux Devices

  1. Build and run the application for Qt Simulator.
  2. Build and run the application for a device:
    1. Specify a connection to the device. For more information, see Connecting Embedded Linux Devices.
    2. Click the Run button.

Qt Creator uses the compiler specified in the project build settings (tool chain) to build the application.

Qt Creator copies the application files to the connected device and runs the application. The application views are displayed on the device. Command-line output is visible in the Qt Creator Application Output view.

Choose Projects > Embedded Linux > Run to view the settings for deploying the application on the connected device. For more information, see Specifying Run Settings for Linux-Based Devices.

Debugging works transparently if GDB server is installed on the device and it is compatible with the GDB on the host.

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 Devices and Connecting 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 Linux-Based Devices.

Debugging also works transparently.

Running on QNX Devices

  1. Connect the device to the development PC or to the Wi-Fi network.
  2. Configure the device and specify a connection to it. For more information, see Connecting QNX Devices.
  3. If you are running on a BlackBerry device, create an Application Descriptor File if it does not already exist. For more information, see Deploying Applications to QNX Devices.
  4. Click the Run button.

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

If you are running on a BlackBerry device, Qt Creator generates a BAR 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.

Note: Debugging is currently only fully supported on Linux and Mac OS. It is not possible to insert breakpoints during runtime on Windows.

Troubleshooting Errors

For the command-line output to show up in the Application Output view when running on a BlackBerry device, Qt Creator needs to be able to establish an SSH connection to the device. This is only possible if QNX Momentics is not running, and the SSH key configured for the device is a 4096-bit key.

If these conditions are not met, you will get an error message saying debug output cannot be shown.