Specifying Run Settings

Qt Creator automatically creates run configurations for your project. To view and modify the settings, select Projects > Run.

The settings to specify depend on the type of the project and on the build target for the project.

Click Add to add run settings for a project and Remove to remove the current settings.

Specifying Run Settings for qmake Projects

The run configurations for qmake projects derive their executable from the parsed .pro files. For more information on how the commands are constructed, see Starting External Processes.

Specifying Run Settings for Desktop Targets

You can specify command line arguments to be passed to the executable and the working directory to use. The working directory defaults to the directory of the build result.

For console applications, check the Run in Terminal check box. If you need to run with special environment variables set up, you also do it in the run configuration settings.

You can also create custom executable run configurations where you can set the executable to be run. For more information, see Specifying a Custom Executable to Run.

Specifying Analyzer Settings

Qt Creator integrates Valgrind code analysis tools for detecting memory leaks and profiling function execution. You can configure the tools according to your needs.

You can specify analyzer settings for the desktop and Qt Simulator targets. You can specify them either globally for all projects or separately for each project.

To specify analyzer settings for the current project:

1. In the Analyzer Settings section, select Custom.
2. Specify analyzer settings for the project.

   

For more information about the settings, see:

• Selecting Options for Memory Analysis
• Selecting Profiling Options

Click Restore Global to revert to the global settings.

To specify global analyzer settings, select Tools > Options > Analyzer.

Specifying Debugger Settings

To select the languages to debug, select the Enable C++ and Enable QML check boxes. The Debug port is the port to communicate with the debugger. You can use any free port in the registered or dynamic port range.

Note: Opening a socket at a well-known port presents a security risk. Anyone on the Internet could connect to the application that you are debugging and execute any JavaScript functions. Therefore, you must make sure that the port is properly protected by a firewall.

If you debug more than one application at a time, you might receive an error message stating that the port is already in use. Specify a free port number in Debug port and try again.

For more information about debugging, see Debugging.

Specifying Run Settings for Symbian Devices

Qt Creator automatically detects Symbian devices that are connected to the development PC with a USB cable. If only one device is detected, the application is deployed to it and run on it. If multiple devices are connected to the PC, make sure that the correct device is selected in the Symbian Device run settings for your project.

You can also pass command line arguments to your application on the device. Press the Device info button to get more information about the selected device, such as the CPU type and the running debugging agent version.

To use the CODA debugging agent over a WLAN connection, enter the WLAN address of the device and the port number to use, separated by a colon (:), in the WLAN field. For example: 192.167.0.100:1534

When you deploy the application for the Symbian Device target, Qt Creator generates a Symbian installation system (SIS) file in the project folder and copies it to the device that is connected to the development PC. If no device is connected, you must remove the Deploy SIS Package step to create the package. Click Remove Item (1) to skip the step.

When you are ready to publish the application to Nokia Store or some other channel, you must make sure that the SIS file meets the requirements for publishing and installing applications on Symbian devices. For more information, see Deploying Applications to Symbian Devices.

Specifying Run Settings for Linux-Based Devices

To run an application on a Linux-based device target (embedded Linux, MeeGo Harmattan, or Maemo), create and select a device configuration in the run settings for the project. You can also pass command line arguments to your application.

To run and debug applications on Linux-based devices, you must create connections from the development PC to the devices. Click Manage device configurations to create connections. For more information, see Configuring Connections to Maemo Devices, Configuring Connections to Harmattan Devices, and Connecting Embedded Linux Devices.

When you run the application, Qt Creator copies the files to the connected device.

For MeeGo Harmattan and Maemo targets, Qt Creator also generates an installation package in the build directory by default. You can deliver the installation package to users for installation on devices that are of the same type and run the same firmware as the connected device. For more information, see Deploying Applications to Linux-Based Devices.

Specifying a Custom Executable to Run

If you use CMake or the generic project type in Qt Creator, or want to run a custom desktop executable, create a Custom Executable run configuration for your project. For example, when working on a library, you can run a test application that links against the library.

Specify the executable to run, command line arguments, working directory, and environment variables to use.

Specifying Run Settings for Qt Quick UI Projects

You can specify run settings for the Desktop target:

• In the Qt version field, select a Qt version that has support for QML.
• In the Arguments field, you can specify command line arguments to be passed to the executable.
• In the Main QML file, select the file that Qt QML Viewer will be started with.