Variant

interface Variant : Component, HasAndroidResources

com.android.build.api.variant.Variant

Known Direct Subclasses ApplicationVariant, DynamicFeatureVariant, LibraryVariant, TestVariant ApplicationVariant Properties for the main Variant of an application. DynamicFeatureVariant LibraryVariant Variant for Library projects TestVariant Variant for test-only modules.

Parent interface for all types of variants.

Summary

Public methods
abstract T?	getExtension(type: Class<T>) Returns an extension object registered via the VariantBuilder.registerExtension API or null if none were registered under the passed type.

Inherited functions
From class HasAndroidResources ResValue.Key makeResValueKey(type: String, name: String) Make a ResValue.Key to interact with resValues's MapProperty
From class Component Unit setAsmFramesComputationMode(mode: FramesComputationMode) Sets the frame computation mode that will be applied to the bytecode of the classes instrumented by ASM visitors registered through transformClassesWith. The default mode is to copy frames. When setting this multiple times, the mode with the highest enum value will be selected. Unit transformClassesWith(classVisitorFactoryImplClass: Class<out AsmClassVisitorFactory<ParamT>>, scope: InstrumentationScope, instrumentationParamsConfig: (ParamT) -> Unit) Registers an asm class visitor to instrument the classes defined by the given scope. An instance of the factory will be instantiated and used to create visitors for each class. Example: androidComponentsExtension.onVariants(selector().all(), { transformClassesWith(AsmClassVisitorFactoryImpl.class, InstrumentationScope.Project) { params -> params.x = "value" } setAsmFramesComputationMode(COMPUTE_FRAMES_FOR_INSTRUMENTED_METHODS) })

Properties
abstract MapProperty<String, BuildConfigField<out Serializable>>	buildConfigFields Variant's BuildConfigField which will be generated in the BuildConfig class.
abstract MapProperty<String, Any>	experimentalProperties Additional per variant experimental properties.
abstract ExternalNativeBuild?	externalNativeBuild Variant's cmake ExternalNativeBuild, initialized by merging the product flavor values or null if no cmake external build is configured for this variant.
abstract MapProperty<String, String>	manifestPlaceholders MapProperty of the variant's manifest placeholders.
abstract Int?	maxSdkVersion Gets the maximum supported SDK Version for this variant.
abstract AndroidVersion	minSdkVersion Gets the minimum supported SDK Version for this variant.
abstract Provider<String>	namespace The namespace of the generated R and BuildConfig classes.
abstract List<Component>	nestedComponents List of the components nested in this variant, the returned list will contain:
abstract Packaging	packaging Variant's packagingOptions, initialized by the corresponding global DSL element.
abstract ListProperty<RegularFile>	proguardFiles List of proguard configuration files for this variant.
abstract AndroidVersion	targetSdkVersion Gets the target SDK Version for this variant.
abstract UnitTest?	unitTest Variant's UnitTest, or null if the unit tests for this variant are disabled.

Inherited properties
From class Component Artifacts artifacts Access to the variant's buildable artifacts for build customization. JavaCompilation javaCompilation Access to the variant's java compilation options.
From class ComponentIdentity String? buildType Build type name, might be replaced with access to locked DSL object once ready. String? flavorName The multi-flavor name of the variant. This does not include the build type. If no flavors are present, this will return null The full name of the variant is queried via name. String name Component's name. List<Pair<String, String>> productFlavors List of flavor names, might be replaced with access to locked DSL objects once ready. The order is properly sorted based on the associated dimension order.
From class HasAndroidResources Property<Boolean> pseudoLocalesEnabled Variant's is pseudo locales enabled, initialized by the corresponding DSL elements. MapProperty<ResValue.Key, ResValue> resValues Variant's ResValue which will be generated.

Public methods

getExtension

abstract fun <T> getExtension(type: Class<T>): T?

Returns an extension object registered via the VariantBuilder.registerExtension API or null if none were registered under the passed type.

Return
the registered object or null.

Properties

buildConfigFields

abstract val buildConfigFields: MapProperty<String, BuildConfigField<out Serializable>>

Variant's BuildConfigField which will be generated in the BuildConfig class.

experimentalProperties

abstract val experimentalProperties: MapProperty<String, Any>

Additional per variant experimental properties.

Initialized from com.android.build.api.dsl.CommonExtension.experimentalProperties

externalNativeBuild

abstract val externalNativeBuild: ExternalNativeBuild?

Variant's cmake ExternalNativeBuild, initialized by merging the product flavor values or null if no cmake external build is configured for this variant.

manifestPlaceholders

abstract val manifestPlaceholders: MapProperty<String, String>

MapProperty of the variant's manifest placeholders.

Placeholders are organized with a key and a value. The value is a String that will be used as is in the merged manifest.

Return
the MapProperty with keys as String

maxSdkVersion

abstract val maxSdkVersion: Int?

Gets the maximum supported SDK Version for this variant.

minSdkVersion

abstract val minSdkVersion: AndroidVersion

Gets the minimum supported SDK Version for this variant.

namespace

abstract val namespace: Provider<String>

The namespace of the generated R and BuildConfig classes. Also, the namespace used to resolve any relative class names that are declared in the AndroidManifest.xml.

nestedComponents

abstract val nestedComponents: List<Component>

List of the components nested in this variant, the returned list will contain:

• UnitTest component if the unit tests for this variant are enabled,
• AndroidTest component if this variant HasAndroidTest and android tests for this variant are enabled,
• TestFixtures component if this variant HasTestFixtures and test fixtures for this variant are enabled.

Use this list to do operations on all nested components of this variant without having to manually check whether the variant has each component.

Example:

androidComponents.onVariants(selector().withName("debug")) {
    // will return unitTests, androidTests, testFixtures for the debug variant (if enabled).
    nestedComponents.forEach { component ->
        component.transformClassesWith(NestedComponentsClassVisitorFactory::class.java,
                                       InstrumentationScope.Project) {}
    }
}

packaging

abstract val packaging: Packaging

Variant's packagingOptions, initialized by the corresponding global DSL element.

proguardFiles

abstract val proguardFiles: ListProperty<RegularFile>

List of proguard configuration files for this variant. The list is initialized from the corresponding DSL element, and cannot be queried at configuration time. At configuration time, you can only add new elements to the list.

This list will be initialized from com.android.build.api.dsl.VariantDimension#proguardFile for non test related variants and from com.android.build.api.dsl.VariantDimension.testProguardFiles for test related variants.

targetSdkVersion

abstract val targetSdkVersion: AndroidVersion

Gets the target SDK Version for this variant.

unitTest

abstract val unitTest: UnitTest?

Variant's UnitTest, or null if the unit tests for this variant are disabled.