[[sec:cpp_application_task_variants]]
=== Variant-dependent Tasks

The {cpp} Application Plugin creates tasks based on the variants of the application component.
Read the <<building_cpp_projects.adoc#sec:introducing_build_variants-cpp,introduction to build variants>> for more information.
The following diagram shows the relationship between variant-dependent tasks.

.{cpp} Application Plugin variant-dependent task graph

public interface GraphSelectionCandidates {

    /**
     * Returns the set of variants to select from during attribute matching, or an empty list of this
     * component does not support attribute matching.
     */
    List<? extends VariantGraphResolveState> getVariantsForAttributeMatching();

    /**
     * Returns the variant to use when attribute-based variant selection is not enabled.
     */
    @Nullable

[[sec:swift_application_task_variants]]
=== Variant-dependent Tasks

The Swift Application Plugin creates tasks based on the variants of the application component.
Read the <<building_swift_projects.adoc#sec:introducing_build_variants-swift,introduction to build variants>> for more information.
The following diagram shows the relationship between variant-dependent tasks.

.Swift Application Plugin variant-dependent task graph

    /**
     * Applies the provided exclusions and resolves the given variant metadata to its artifacts.
     */
    ResolvedVariant resolveVariant(ComponentArtifactResolveMetadata component, VariantResolveMetadata variant, ExcludeSpec exclusions);

        return new CppLib()
    }

    @Override
    List<String> getTasksToBuildFromIde(String variant) {
        return [":compile${variant.capitalize()}Cpp", ":create${variant.capitalize()}"]
    }

    @Override
    String getIdeBuildTaskName(String variant) {
        return "create${variant.capitalize()}"
    }

    @Override
    List<String> getExpectedBaseIncludePaths() {

    }

    def "direct has GMM and has sources jar"() {
        transitive.adhocVariants().variant("jar", [
            "org.gradle.category": "library",
            "org.gradle.dependency.bundling": "external",
            "org.gradle.usage": "java-runtime"
        ]) {
            artifact("transitive-1.0.jar")
        }
        .variant("sources", [
                "org.gradle.category": "documentation",

        mainMetadata.variants.size() == 5
        def api = mainMetadata.variant("api")
        api.dependencies.empty
        api.files.size() == 1
        api.files[0].name == 'cpp-api-headers.zip'
        api.files[0].url == 'test-1.2-cpp-api-headers.zip'
        mainMetadata.variant("debugLink").availableAt.coords == "some.group:test_debug:1.2"

                variant.getFiles(), variant.getCapabilities(), variantToDependencies.get(variant.getName()), variant.isExternalVariant()));
        }
        ImmutableList<AbstractRealisedModuleComponentResolveMetadata.ImmutableRealisedVariantImpl> realisedVariants = builder.build();
        return new RealisedIvyModuleResolveMetadata(resolveMetadata, realisedVariants, readIvyConfigurations(decoder, resolveMetadata));

> Task :dependencyInsight
io.vertx:vertx-lang-groovy:3.9.4
  Variant runtime:
    | Attribute Name                 | Provided     | Requested    |
    |--------------------------------|--------------|--------------|
    | org.gradle.status              | release      |              |
    | org.gradle.category            | library      | library      |
    | org.gradle.libraryelements     | jar          | jar          |

}
// end::add-plugin-variant[]

// tag::consume-plugin-variant[]
configurations.configureEach {
    if (canBeResolved && name.startsWith(gradle7.name))  {
        attributes {
            attribute(GradlePluginApiVersion.GRADLE_PLUGIN_API_VERSION_ATTRIBUTE,
                objects.named(GradlePluginApiVersion, '7.0'))
        }
    }
}
// end::consume-plugin-variant[]

gradlePlugin {