golem configure

This command allows you to configure how to build your project.

The choices are saved, therefore it needs to be run only once. Modifying the project file will not require re-executing this command.

golem configure [options]

Build options#

• --dir=<build_dir>

  Directory where to build the project

  Default: ./build

• --variant=(debug|release)

  Variants define a set of default flags/options for your build

  Default: debug

• --runtime=(shared|static)

  Links the runtime dynamically (shared) or statically (static)

  Default: shared

• --link=(shared|static)

  Builds and links libraries dynamically (shared) or staticaly (static)

  Default: shared

• --arch=(x64|x86)

  Builds using the specfied architecture

  Default: <your_os_arch>

Qt options#

• --qtdir=<qt_dir>

  Directory to Qt, for example C:\Qt\6.10.0\msvc2022_64

  Default: None

IDE / Tools options#

• --vscode

  Generates files to enable Microsoft C/C++ Extension’s IntelliSense in VSCode

  Default: False

  See Visual Studio Code to know more

• --clangd

  Generates files to support clangd

  Default: False

  See clangd to know more

• --compile-commands

  Generates compile_commands.json files in ./build/golem/compile_commands/

  Default: False

  See compile_commands.json to know more

Cache System options#

See Cache System to know more

• --cache-directory=<path>

  Change the default cache directory

  Default: ~/.cache/golem

• --define-cache-directories=<path1>=<regex1>|<path2>=<regex2>|...

  <path> is a directory where the matched depencencies are stored

  <regex> has to match the dependency’s URL or be left empty

  | is the sperator between multiple cache definitions

  Default: None

• --cache-resolution-policy=<policy>

  strict (default) Stops at the first valid cache definition found for the given dependency.

  weak Tries to find the dependency in each valid cache definition, or returns the first valid cache definition for the given dependency.

  Default: strict