Adding Kits

Qt Creator groups settings used for building and running projects as kits to make cross-platform and cross-configuration development easier. Each kit consists of a set of values that define one environment, such as a device, compiler, Qt version, and debugger command to use, and some metadata, such as an icon and a name for the kit. Once you have defined kits, you can select them to build and run projects.

Qt Creator supports development for the desktop and for the following types of devices:

  • Android Device
  • Generic Linux Device
  • Maemo5/Fremantle Device
  • MeeGo 1.2 Harmattan Device
  • QNX Device

To add kits:

  1. Select Tools > Options > Build & Run > Kits > Add.

    To clone the selected kit, select Clone.

  2. In the Name column, double-click the kit name to change it.
  3. In the Device type field, select the type of the device.

    Double-click the icon next to the field to select the image that is displayed in the kit selector for this kit. You can use any image in a supported file format (for example, PNG). The image is scaled to the size 64x64 pixels. For example, using the compiler logo as an icon allows you to easily see, which compiler is used to build the project for the selected kit.

  4. In the Device field, select a device.
  5. In the Sysroot field, specify the directory where the device image is located. If you are not cross-compiling, leave this field empty.
  6. In the Compiler field, select the compiler required to build the project. You can add compilers to the list if they are installed on the development PC, but were not detected automatically. For more information, see Adding Compilers.
  7. In the Debugger field, select Manage to automatically detect a suitable debugger or to edit the currently selected debugger. For more information, see Selecting the Debugger.
  8. In the Qt version field, select the Qt version to use for building the project. You can add Qt versions to the list if they are installed on the development PC, but were not detected automatically. For more information, see Adding Qt Versions.

    Qt Creator checks the directories listed in the PATH environment variable for the qmake executable. If a qmake executable is found, it is referred to as Qt in PATH and selected as the Qt version to use for the Desktop kit that is created by default.

  9. In the Qt mkspec field, specify build instructions for qmake. If you leave this field empty, the default value is used.

Selecting the Debugger

To automatically detect a suitable debugger in the Debugger field, select Manage > Auto-detect. This should work for the CDB engine and for the GDB engine for local debugging on Linux or Mac OS.

To edit the selected debugger, select Manage > Edit. In the Debugger for dialog, specify the type of debugger to use (GDB Engine or CDB Engine) and the path to the debugger binary.

For the CDB Engine (Windows only), specify the path to the Windows Console Debugger executable.

For the GDB Engine, specify the path to the GDB executable. The executable must be built with Python scripting support enabled (except when debugging on Mac OS). The options you have depend on the development and target platform:

  • For debugging on embedded devices using a different ABI, you must provide a special executable.
  • For debugging on Windows using MinGW, select a Windows executable of GDB with Python scripting enabled. You can download it from http://builds.qt-project.org/job/gdb-windows.
Notes provided by the Qt Community

No notes