// this is because we don't want the cpp compile tasks to accidentally use 
            // the decorated tool provider we set up for testing the parallelism
            tasks.withType(CppCompile) { mustRunAfter tasks.withType(WindowsResourceCompile) }
        """

        when:
        succeeds("assemble", "parallelTask")

        then:
        assertTaskIsParallel("compileMainLibSharedLibraryMainLibRc")

    cppCompileVariant -> includeRoot
    implementation -> includeRoot
    variantImplementation -> includeRoot

    cppCompileVariant[style=dashed, label=<cppCompile<i>Variant</i><br/>(configuration)>]
    implementation[style=dashed, label="implementation\n(configuration)"]
    variantImplementation[style=dashed, label=<main<i>Variant</i>Implementation<br/>(configuration)>]
  }

  }

  subgraph left {
    node[style=filled, fillcolor="#cfe2f3"]
    cppCompileVariant -> nativeLinkVariant -> nativeRuntimeVariant [style=invis, weight=1000]

    cppCompileVariant[label=<cppCompile<i>Variant</i> (R)>]
    nativeLinkVariant[label=<nativeLink<i>Variant</i> (R)>]
    nativeRuntimeVariant[label=<nativeRuntime<i>Variant</i> (R)>]
  }

  subgraph right {
    node[style=filled, fillcolor="#ea9999"]

We recommend that you follow these conventions wherever possible, but you don’t have to.

There are several options for customization, as you’ll see next.

NOTE: All link:{groovyDslPath}/org.gradle.language.cpp.tasks.CppCompile.html[CppCompile] tasks are incremental and cacheable.

[[sec:cpp_supported_tool_chain]]
=== Supported tool chain

Gradle offers the ability to execute the same build using different tool chains.

model {
    components {
        main(NativeExecutableSpec) {
            binaries.all {
                if (toolChain in VisualCpp) {
                    cppCompiler.args '/Zi'
                    linker.args '/DEBUG'
                } else {
                    cppCompiler.args '-g'
                }
            }
        }
    }
}
"""

        and:
        file("src/main/cpp/helloworld.cpp") << """

            int main () {
              std::cout << MESSAGE;
              return 0;
            }
        """

        buildFile << """
            project(':app') {
                tasks.withType(CppCompile) {
                    macros.put('MACRO','${macro}')
                }
            }
        """

        then:
        succeeds installApp

        and:

    `org.gradle.language.scala.tasks.PlatformScalaCompile` (removed),
    link:{groovyDslPath}/org.gradle.api.tasks.scala.ScalaDoc.html[ScalaDoc]
* Native toolchain:
    link:{javadocPath}/org/gradle/language/cpp/tasks/CppCompile.html[CppCompile],
    link:{javadocPath}/org/gradle/language/c/tasks/CCompile.html[CCompile],
    link:{javadocPath}/org/gradle/language/swift/tasks/SwiftCompile.html[SwiftCompile]
* Testing:

        <para>Tasks used to build native binaries.</para>
        <table>
            <title>Native component task types</title>
            <tr>
                <td>org.gradle.language.cpp.tasks.CppCompile</td>
            </tr>
            <tr>
                <td>org.gradle.language.swift.tasks.SwiftCompile</td>
            </tr>
            <tr>

import org.gradle.nativeplatform.toolchain.internal.compilespec.CppCompileSpec;

import java.util.Optional;

class CppCompiler extends VisualCppNativeCompiler<CppCompileSpec> {

import org.gradle.nativeplatform.toolchain.internal.CommandLineToolInvocationWorker;
import org.gradle.nativeplatform.toolchain.internal.compilespec.CppCompileSpec;

class CppCompiler extends GccCompatibleNativeCompiler<CppCompileSpec>  {