Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Image Removed

...

This section includes instructions on how to configure and run IncrediBuild for Unit Tests in an Assembly-level mode with all supported frameworks except NUnit.

Supported frameworks:

IBConsole supports the following frameworks:

  • MSTest
  • VSTest
  • XUnit
  • CppUTest
  • QTtest
  • CTest

IBConsole will automatically detect the executed framework. However, if you want to force it to run a specific framework, you can use the /test={test framework} CLI command line option.

Running the IBConsole

To configure and run the IBConsole, you should first run the IBConsole.exe file, located in the IncrediBuild installation folder.  This is a console application that initializes IncrediBuild for Unit Tests in various modes of operation, according to its various parameters.

IBConsole Command Usage

IBConsole has two modes of operation:

  • Single command - in this mode, the command is transferred as an argument within IBConsole /Command, as described below.   
  • Multiple commands (script) - to enable parallelization of each command in the script, the script itself should be modified before running the IBConsole command to call xgSubmit.exe and (optionally) xgWait.exe so that processes whose execution you wish to distribute. For more information - see: Using Submission Interfaces.  

The IBConsole commands have the following syntax:

Code Block
IBConsole /COMMAND="<job command line>" /test=”<test framework>” [options]
  • /command - the original command of your Unit tests framework. The command may include specific flags.
  • /test - specifies the test framework. The available values are:
    • MSTest
    • VSTest
    • XUnit
    • CppUTest
    • QTtest
    • CTest
  • options the IBConsole.exe command line options. For a detailed list of available options, see here

IBConsole Command Examples

Single Command Example

The original command:

Code Block
ctest -C Release --parallel 100

The IBConsole command:

Code Block
IBConsole /command=”ctest -C Release --parallel 100” /test=ctest

Multiple Commands (script) Example

The original batch file:

Code Block
run.bat

vstest.console.exe UnitTestProject1.dll

vstest.console.exe UnitTestProject2.dll

vstest.console.exe UnitTestProject3.dll

vstest.console.exe UnitTestProject4.dll

Modified batch file:

Code Block
xgSubmit /command vstest.console.exe UnitTestProject1.dll

xgSubmit /command vstest.console.exe UnitTestProject2.dll

xgSubmit /command vstest.console.exe UnitTestProject3.dll

xgSubmit /command vstest.console.exe UnitTestProject4.dll

The IBConsole command:

Code Block
IBCosnsole /command=run.bat /test=vstest

...

width15

...

alignleft

Visual Studio Solution:

Children Display
styleh4
pageVisual Studio Solution

IncrediBuild Solutions:

Children Display
styleh4
pageIncrediBuild Solutions

User Manual:

...

Image Added