setup-toolchains

Synopsis


  qbs setup-toolchains [--settings-dir <directory>] --detect
  qbs setup-toolchains [--settings-dir <directory>] [--type <toolchain type>]
                       <compiler path> <profile name>

Description

The first form tries to auto-detect all known toolchains, looking them up via the PATH variable.

The second form creates a profile with the name <profile name> for the toolchain located at <compiler path>. It will attempt to determine the toolchain type automatically based on the file name or the compiler executable. If that fails, you need to provide the compiler type as a value of the --type option.

For more information, see Configuring.

Options

--settings-dir <directory>

Reads all settings (such as profile information) from the specified <directory>. If the directory does not exist, it will be created.

The default value is system-specific. For example:

  • Linux: $HOME/.config/QtProject/qbs
  • Windows: %APPDATA%\QtProject\qbs
  • macOS: $HOME/Library/Preferences/qbs

--detect

Attempts to auto-detect all known toolchains, looking them up in the PATH environment variable.

--type <toolchain type>

Specifies the type of the toolchain. Needed if Qbs cannot determine the compiler from the name of the executable file located in the specified directory.

Possible values include:

  • clang
  • gcc
  • mingw
  • msvc

--help|-h|-?

Displays help for the command.

Examples

Looks up toolchains via the PATH variable and creates profiles for them:


  qbs setup-toolchains --detect

Creates a profile called mingw for the toolchain located in C:\mingw530_32\bin on Windows:


  qbs setup-toolchains C:\mingw530_32\bin\g++.exe mingw

Creates a profile called g++-mingw-w64 for the toolchain located in /usr/bin/x86_64-w64-mingw32-g++ g++-mingw-w64 on Ubuntu:


  qbs setup-toolchains /usr/bin/x86_64-w64-mingw32-g++ g++-mingw-w64