Accelerating C++ Builds with IncrediBuild and MSVC

IncrediBuild is a distributed build acceleration tool that significantly speeds up C++ compilation using parallel processing. It integrates seamlessly with Microsoft Visual C++ (MSVC), enabling faster builds without the need for CMake, Meson, or MSBuild.

This guide explains how to:

• Set up IncrediBuild for MSVC

• Compile single and large projects

• Optimize C++20, C++23, and C++26 builds

• Automate builds using Batch Scripts and PowerShell

Setting Up IncrediBuild for MSVC**

Installation

1. Download IncrediBuild from the official website.

2. Install it on all machines in the build network.

3. Ensure you have:

   • MSVC (cl.exe) installed

   • IncrediBuild Build Console available in the Developer Command Prompt

Verifying Installation

Run the following command in PowerShell or Command Prompt:

x
xgconsole /?  

If IncrediBuild is installed correctly, this will display the available options.

Compiling a Single C++ File with IncrediBuild**

Instead of running:

x
cl /std:c++23 main.cpp /Fe:my_program.exe

Run with IncrediBuild:

x
BuildConsole /command="cl /std:c++23 main.cpp /Fe:my_program.exe"

This accelerates compilation using IncrediBuild’s distributed caching.

Compiling Multi-File Projects**

Standard MSVC Compilation (Without IncrediBuild)

x
cl /c src\main.cpp /Fo:build\main.obj  
cl /c src\helper.cpp /Fo:build\helper.obj  
cl /c src\module\math.cpp /Fo:build\math.obj  
cl build\main.obj build\helper.obj build\math.obj /Fe:my_program.exe

Using IncrediBuild for Faster Compilation

x
Console /command="cl /c src\main.cpp /Fo:build\main.obj"
BuildConsole /command="cl /c src\helper.cpp /Fo:build\helper.obj"
BuildConsole /command="cl /c src\module\math.cpp /Fo:build\math.obj"
BuildConsole /command="cl build\main.obj build\helper.obj build\math.obj /Fe:my_program.exe"

This allows parallel compilation, improving build speed.

Using IncrediBuild for Large Projects**

Project Structure

x
my_project/
├── src/
│   ├── main.cpp
│   ├── helper.cpp
│   ├── module/
│   │   ├── math.cpp
│   │   ├── physics.cpp
├── include/
│   ├── helper.hpp
│   ├── module/
│   │   ├── math.hpp
│   │   ├── physics.hpp
├── build/

Compiling Large Projects Efficiently

Instead of manually compiling each file:

x
BuildConsole /command="cl /Iinclude /c src\*.cpp /Fo:build\"

This compiles all C++ files in the src/ directory in parallel.

Linking Object Files with IncrediBuild

x
BuildConsole /command="cl build\*.obj /Fe:my_project.exe"

This speeds up linking by optimizing dependencies.

Using IncrediBuild for Parallel Linking**

Large projects require efficient linking. Use:

x
BuildConsole /command="link /OUT:my_project.exe build\*.obj"

IncrediBuild speeds up linking by parallelizing static and dynamic library resolution.

Enabling Optimizations and Debugging

Optimizing for Speed

x
BuildConsole /command="cl /O2 /GL src\*.cpp /Fo:build\"

Enabled optimizations:

• /O2 → Optimize for speed

• /GL → Whole-program optimization

Debugging Builds with IncrediBuild

x
BuildConsole /command="cl /Zi /Od src\*.cpp /Fo:build\"

Debugging enabled:

• /Zi → Generates debugging symbols

• /Od → Disables optimizations for accurate debugging

Automating IncrediBuild with a Batch Script**

Create build.bat

x
@echo off
mkdir build
BuildConsole /command="cl /c /Iinclude src\main.cpp /Fo:build\main.obj"
BuildConsole /command="cl /c /Iinclude src\helper.cpp /Fo:build\helper.obj"
BuildConsole /command="cl /c /Iinclude src\module\math.cpp /Fo:build\math.obj"
BuildConsole /command="cl build\*.obj /Fe:my_project.exe"
echo Build complete!

Run the Build

x
build.bat

This automates the full project build.

PowerShell Automation Script**

For more flexibility, use PowerShell instead of Batch scripts:

Create build.ps1

x
New-Item -ItemType Directory -Path "build" -ErrorAction SilentlyContinue
& BuildConsole /command="cl /c /Iinclude src\main.cpp /Fo:build\main.obj"
& BuildConsole /command="cl /c /Iinclude src\helper.cpp /Fo:build\helper.obj"
& BuildConsole /command="cl /c /Iinclude src\module\math.cpp /Fo:build\math.obj"
& BuildConsole /command="cl build\*.obj /Fe:my_project.exe"
Write-Output "Build complete!"

Run in PowerShell

x
.\build.ps1

This approach allows more control over the build process.

When to Use IncrediBuild vs. Build Systems (CMake, Meson)

IncrediBuild is best for large MSVC projects needing parallel builds, while CMake and Meson are better for cross-platform projects.

Conclusion

IncrediBuild with MSVC provides faster compilation without requiring CMake or Meson.

• Best suited for large projects requiring parallel builds

• Automates compilation with Batch/PowerShell scripts

• Improves performance through distributed builds