CMake Qt Vendor Presets

Specify Qt Creator preferences in the vendor section in CMakePresets.json and CMakeUserPresets.json.

CMake configuration presets

The following table summarizes the available presets.

Preset	Description	Read More
`AutorunCMake`	Runs CMake to refresh project information when you edit a `CMakeLists.txt` configuration file in a project. Also, refreshes project information when you build the project.	View CMake project contents
`AskBeforePresetsReload`	Asks before acting when you select Build > Reload CMake Presets.	CMake Presets
`AskReConfigureInitialParams`	Asks before acting when you select Re-configure with Initial Variables.	Re-configuring with Initial Variables
`PackageManagerAutoSetup`	Sets up the Conan or vcpkg package manager for use with CMake.	Using CMake with Package Managers
`ShowAdvancedOptionsByDefault`	Shows all CMake variables by default in Initial Configuration and Current Configuration.	Viewing Advanced Variables
`ShowSourceSubfolders`	Hides subfolder names and arranges the files according to their source group in the Projects view.	Hide subfolder names in Projects view
`UseJunctionsForSourceAndBuildDirectories`	On Windows, uses junction points for CMake configure, build, and install operations.	Using Junction Points on Windows

An example of CMake configuration presets:

"vendor": {
  "qt.io/QtCreator/1.0": {
    "AskBeforePresetsReload": false,
    "AskReConfigureInitialParams": false,
    "AutorunCMake": false,
    "PackageManagerAutoSetup": false,
    "ShowAdvancedOptionsByDefault": true,
    "ShowSourceSubFolders": false,
    "UseJunctionsForSourceAndBuildDirectories": true
  }
}

Debugger presets

The following table summarizes the available presets.

For more information about debugger preferences, see Add debuggers.

Preset	Description
`Abis`	Comma-separated list of system architecture definitions.
`Binary`	Path to the debugger executable. Can be an absolute path, the value `auto`, or an ABI. Finds the appropriate debugger for MSVC toolchains where Qt Creator does not know the binary path.
`DisplayName`	Name of the debugger.
`EngineType`	Debugger engine type: 1 for GDB 4 for CDB 8 for PDB 256 for LLDB 512 for GDB DAP 1024 for LLDB DAP 4096 for uVision Debugger
`Version`	Version number of the debugger.

An example of Qt Creator debugger presets:

"vendor": {
  "qt.io/QtCreator/1.0": {
    "debugger": {
      "DisplayName": "GNU gdb 11.2.0 for MinGW 11.2.0 64-bit",
      "Abis": ["x86-windows-msys-pe-64bit"],
      "Binary": "C:/Qt/Tools/mingw1120_64/bin/gdb.exe",
      "EngineType": 1,
      "Version": "11.2.0"
    }
  }
}

See also CMake Build Configuration, CMake, CMake Presets, and SDK Tool.

Reference

Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.