location	top

Overview

...

Supported Versions and Build Systems

...

jom
ninja
waf
make
cmake/qmake
qbs - to be supported soon

...

Configuration

Note: In order to gain the benefits of IncrediBuild acceleration, you need to set up the necessary IncrediBuild Helper Agents on the necessary machines. For more information on Agents and IncrediBuild's components please check out the IncrediBuild architecture and terminology overview. For help with setup and installation check out our Setup and Installation Guide.
Configuring and IncrediBuild Windows build step (BuildConsole) and an IncrediBuild Linux build step (IBConsole) is a bit different, so we will address them separately.

In all text fields which are not drop-down menus or predefined text fields, you can enter Qt variables and IncrediBuild will automatically translate the variables to their appropriate values.

IncrediBuild for Windows

When clicking the Details button for the IncrediBuild for Windows Build Step these options will appear:
Image Removed

IncrediBuild for Linux

...

Setting up Qt Creator to run with IncrediBuild

...

How to Use

Once the IncrediBuild plugin is installed, you will be able to add the "IncrediBuild for Windows" or "IncrediBuild for Linux" build steps to your Qt Creator from the Build Settings menu, which is accessed by clicking the Projects icon in Qt Creator.
Upon adding an IncrediBuild build step, IncrediBuild will automatically detect the Build Step used in your build settings by iterating over the build steps you already defined.
The initial build step settings will then be part of your IncrediBuild build step, so your usual build tool will still be used, but with the added benefit of IncrediBuild's build acceleration. After adding an IncrediBuild Build Step you will be asked if you would like to apply it to all configurations of your project. If you agree, the IncrediBuild step will automatically be added to all relevant build configurations. After IncrediBuild has iterated through your configurations and added itself to your initial Build Steps, it is advised to go through your project configurations, make sure that each step is configured properly, and to disable previous steps that are now irrelevant.

...

Appendix:

IncrediBuild configuration fields table

Windows Version

...

Description

...

The Profile XML file is used to define how Automatic Interception Interface should handle the various processes involved in a distributed job. It is not necessary for 'Visual Studio' or 'Make and Build tools' builds, but can be used to provide configuration options if those builds use additional processes that are not included in those packages. it is required to configure distributable processes in 'Dev Tools' builds.

...

Overrides the Agent Settings dialog "Avoid task execution on local machine when possible" option. This frees up more resources on the initiator machine and could be beneficial for distribution in scenarios where the initiating machine is bottlenecking the build with High CPU usage.

...

Specifies the maximum amount of remote cores to utilize in the build. Overrides global max. CPUs/Cores in build setting.

...

Specifies the newest operating system installed on a Helper machine to be allowed to participate as helper in the build.

...

Specifies the oldest operating system installed on a Helper machine to be allowed to participate as Helper in the build.

...

Specifies a custom header line which will be displayed in the beginning of the build output text. This title will also be used for the Build History and Build Monitor displays.

...

Writes a copy of the build progress (.ib_mon) file to the specified location. - If only a folder name is given, IncrediBuild generates a GUID for the file name. - A message containing the location of the saved .ib_mon file is added to the end of the build output.

...

Does not write anything to the standard output.

...

Writes build output to a file.

...

Shows, for each file built, the command-line used by IncrediBuild to build the file.

...

Shows the Agent used to build each file.

...

Shows the Start and Finish time for each file built.

...

Suppresses the 'IncrediBuild' header in the build output.

...

Overrides the internal Incredibuild logging level for this build. Does not affect output or any user accessible logging. Used mainly to troubleshoot issues with the help of IncrediBuild support.

...

Sets or overrides environment variables for the context of the build.

...

When specified, the execution will stop as soon as an error is encountered. This is the default behavior in 'Visual Studio' builds, but not the default for 'Make and Build tools' or 'Dev Tools' builds.

...

Add additional buildconsole arguments manually. The value of this field will be concatenated to the final buildconsole command line.

...

Opens an IncrediBuild Build Monitor that graphically displays the build's progress once the build starts.

...

Setting this option to true, forces IncrediBuild to not override the -j command line switch.
The default IncrediBuild behavior is to set a high value to the -j command line switch which controls the number of processes that the build tools executed by Qt Creator will execute in parallel (the default IncrediBuild behavior will set this value to 200).

...

Description

...

Field name

...

Specify nice value

...

Specify nice value. Nice Value should be numeric and between -20 and 19.

...

Internal IncrediBuild logging level

...

Overrides the internal Incredibuild logging level for this build. Does not affect output or any user accessible logging. Used mainly to troubleshoot issues with the help of IncrediBuild support.

...

Keep Original Job Number

...

Setting this option to true, forces IncrediBuild to not override the -j command line switch.
The default IncrediBuild behavior is to set a high value to the -j command line switch which controls the number of processes that the build tools executed by Qt Creator will execute in parallel (the default IncrediBuild behavior will set this value to 200).

...

Alternate tasks preference

...

Force remote

...

Force allow_remote tasks to remote Helpers.