Build actions

The actions for building, cleaning, and installing projects are grouped in the Build section of the main menu.

Tables below describe how the Build actions work for the following types of projects:

CMake,
Makefile,
Meson,
Compilation Database with custom build targets and custom run/debug configurations.

Build actions for CMake projects

Action	Description
Build Project	Builds the `all` target from each CMake profile configured for the current project: This action serves as the most global build action, as it does not require a CMake profile or Run/Debug configuration to be preselected.
Build All in <selected profile>	Builds the `all` target from the current CMake profile. You can configure the profiles in CMake settings and then select the desired one in the Run/Debug configuration switcher.
Build <selected configuration>	Builds the selected Run/Debug configuration for CMake projects.
Recompile <current file>	Compiles the currently opened file or a group of files, if selected in the Project View. When used for multiple files, recompilation stops upon the first compilation failure.
Install	Runs `cmake install` for the currently selected CMake profile (for more information, refer to CMake install).
Rebuild Project	Calls Clean for all the CMake profiles and then Build Project.
Rebuild All in <selected profile>	Calls Clean and then Build All in <selected profile>.
Rebuild <selected configuration>	Calls Clean and then Build <selected configuration>:
Clean	Cleans the project by building the `clean` target from the current CMake profile.

Build actions for Makefile projects

Action	Description
Build Project	Calls `make` for the target specified in the Build target field of the Makefile settings or for the first target in the project’s top Makefile if Build target is empty.
Build <selected configuration>	Calls `make` for the target specified in the selected configuration.
Recompile <current file>	Compiles the currently opened file or a group of files, if selected in the Project View. When used for multiple files, recompilation stops upon the first compilation failure.
Rebuild Project	Calls `make clean` and `make` for the targets specified in Build target and Clean target of the Makefile settings. If Build target is empty, the first target from the project’s top Makefile is used.
Rebuild <selected configuration>	Calls `make clean` and `make` for the target specified in the selected configuration.
Clean	Calls `make clean` for the target specified in the selected configuration.

Build actions for Meson projects

Action	Description
Build Project	Calls `meson compile`.
Build <target>	Calls `meson compile <target>`.
Recompile <current file>	Compiles the currently opened file or a group of files, if selected in the Project View. When used for multiple files, recompilation stops upon the first compilation failure.
Rebuild Project	Calls `meson compile --clean` to clean up the project, then calls `meson compile`.
Rebuild <target>	Calls `meson compile --clean` to clean up the project, then calls `meson compile <target>`.
Clean	Calls `meson compile --clean` to clean up the project.

Build actions for Compilation Database projects

Action	Description
Build Project	For custom build targets: calls the Build tool of the first target.
Build <selected configuration>	For custom Run/Debug configurations: calls the Build tool of the target specified in the selected configuration.
Recompile <current file>	Compiles the currently opened file or a group of files, if selected in the Project View. When used for multiple files, recompilation stops upon the first compilation failure.
Rebuild Project	For custom build targets: calls the Clean tool, then the Build tool of the first target.
Rebuild <selected configuration>	For custom Run/Debug configurations: calls the Clean and then the Build tool of the target specified in the selected configuration.
Clean	For custom Run/Debug configurations: calls the Clean tool of the target specified in the selected configuration.

Last modified: 26 May 2024