target.CMakeBuilder Class

Optional. Array of additional CMake cache entries to pass to the CMake tool as part of the command line invocation. The software expands the entries in this form:

cmake -D name:type=value ...

Attributes:

Generator that CMake must use, that is, the generator value for the command cmake -G generator.

If the string value has no spaces, for example, nameWithNoSpaces, the software passes this command to the CMake tool:

cmake -G nameWithNoSpaces

cmake -G "name With Spaces"

Attributes:

Whether generator is multi-configuration:

Attributes:

Optional. Platform name for the generator, that is, the platformName value for the command cmake -A platformName.

If the string value has no spaces, for example, nameWithNoSpaces, the software passes this command to the CMake tool:

cmake -A nameWithNoSpaces

cmake -A "name With Spaces"

Attributes:

Build types or build configurations supported by generator and toolchain file.

The property is prepopulated with definitions of build types and build configurations that are available by default. If the Generator property is set to Ninja Multi-Config, the build type MinSizeRel, is not supported by default. Unless you define MinSizeRel in a toolchain file, you must remove it from the object array. This code snippet shows how you can remove MinSizeRel.

tc = target.create('Toolchain', 'Name', 'CMake/Ninja Multi-Config'); 
tc.Builder = target.create('CMakeBuilder');
tc.Builder.Generator = 'Ninja Multi-Config';
tc.Builder.GeneratorIsMultiConfig = true;
tc.Builder.CommandLineCacheEntries(end+1) = ...
   target.create('CMakeCacheEntry', 'Name', 'CMAKE_C_COMPILER', 'Value', 'gcc');
tc.Builder.CommandLineCacheEntries(end+1) = ...
   target.create('CMakeCacheEntry', 'Name', 'CMAKE_CXX_COMPILER', 'Value', 'g++');
tc.Builder.SupportedBuildTypes(strcmp({tc.Builder.SupportedBuildTypes}, 'MinSizeRel')) = [];

Attributes:

Optional. Path to a CMake toolchain file, that is, the toolChain value for the command cmake -D CMAKE_TOOLCHAIN_FILE=toolChain.

If the string value has no spaces, for example, nameWithNoSpaces, the software passes this command to the CMake tool:

cmake -D CMAKE_TOOLCHAIN_FILE=nameWithNoSpaces

cmake -D CMAKE_TOOLCHAIN_FILE="name With Spaces"

Attributes:

Optional. Tool set specification for generator, that is, the toolSet value for the command cmake -T toolSet.

If the string value has no spaces, for example, nameWithNoSpaces, the software passes this command to the CMake tool:

cmake -T nameWithNoSpaces

cmake -T "name With Spaces"

Attributes: