BaseFlavor

@Incubating interface BaseFlavor : VariantDimension

com.android.build.api.dsl.BaseFlavor

Known Direct Subclasses

ApplicationBaseFlavor, DefaultConfig, DynamicFeatureBaseFlavor, LibraryBaseFlavor, ProductFlavor, TestBaseFlavor

ApplicationBaseFlavor
DefaultConfig	Specifies defaults for variant properties that the Android plugin applies to all build variants.
DynamicFeatureBaseFlavor
LibraryBaseFlavor
ProductFlavor	Encapsulates all product flavors properties for this project.
TestBaseFlavor

Known Indirect Subclasses

ApplicationDefaultConfig, ApplicationDefaultConfig, ApplicationProductFlavor, ApplicationProductFlavor, DynamicFeatureDefaultConfig, DynamicFeatureDefaultConfig, DynamicFeatureProductFlavor, DynamicFeatureProductFlavor, LibraryDefaultConfig, LibraryDefaultConfig, LibraryProductFlavor, LibraryProductFlavor, and 4 others.

ApplicationDefaultConfig
ApplicationDefaultConfig
ApplicationProductFlavor
ApplicationProductFlavor
DynamicFeatureDefaultConfig
DynamicFeatureDefaultConfig
DynamicFeatureProductFlavor
DynamicFeatureProductFlavor
LibraryDefaultConfig
LibraryDefaultConfig
LibraryProductFlavor
LibraryProductFlavor
TestDefaultConfig
TestDefaultConfig
TestProductFlavor
TestProductFlavor

Shared properties between DSL objects ProductFlavor and DefaultConfig

Summary

Public methods
abstract String	`getName()` The name of the flavor.
abstract Unit	`vectorDrawables(action: VectorDrawables.() -> Unit)` Configures VectorDrawables.

Inherited functions

From class VariantDimension

`Unit`	`addManifestPlaceholders(manifestPlaceholders: Map<String, Any>)` Adds manifest placeholders. See Inject Build Variables into the Manifest.
`Unit`	`buildConfigField(type: String, name: String, value: String)` Adds a new field to the generated BuildConfig class. The field is generated as: `<type> <name> = <value>;` This means each of these must have valid Java content. If the type is a String, then the value should include quotes.
`Unit`	`externalNativeBuild(action: ExternalNativeBuildOptions.() -> Unit)` Encapsulates per-variant CMake and ndk-build configurations for your external native build. To learn more, see Add C and C++ Code to Your Project.
`Unit`	`javaCompileOptions(action: JavaCompileOptions.() -> Unit)` Options for configuring Java compilation.
`Unit`	`ndk(action: Ndk.() -> Unit)` Encapsulates per-variant configurations for the NDK, such as ABI filters.
`Any`	`proguardFile(proguardFile: Any)` Adds a new ProGuard configuration file. `proguardFile getDefaultProguardFile('proguard-android.txt')` There are two ProGuard rules files that ship with the Android plugin and are used by default: proguard-android.txt proguard-android-optimize.txt `proguard-android-optimize.txt` is identical to `proguard-android.txt`, except with optimizations enabled. You can use getDefaultProguardFileString to return the full path of the files. This method has a return value for legacy reasons.
`Any`	`proguardFiles(vararg files: Any)` Adds new ProGuard configuration files. There are two ProGuard rules files that ship with the Android plugin and are used by default: proguard-android.txt proguard-android-optimize.txt `proguard-android-optimize.txt` is identical to `proguard-android.txt`, except with optimizations enabled. You can use getDefaultProguardFileString to return the full path of the files. This method has a return value for legacy reasons.
`Unit`	`resValue(type: String, name: String, value: String)` Adds a new generated resource. This is equivalent to specifying a resource in res/values. See Resource Types.
`Unit`	`shaders(action: Shaders.() -> Unit)` Configure the shader compiler options.
`Any`	`testProguardFile(proguardFile: Any)` Adds a proguard rule file to be used when processing test code. Test code needs to be processed to apply the same obfuscation as was done to main code. This method has a return value for legacy reasons.
`Any`	`testProguardFiles(vararg proguardFiles: Any)` Adds proguard rule files to be used when processing test code. Test code needs to be processed to apply the same obfuscation as was done to main code. This method has a return value for legacy reasons.

Properties
abstract Int?	`minSdk` The minimum SDK version.
abstract String?	`minSdkPreview` The minimum SDK version.
abstract Boolean?	`renderscriptNdkModeEnabled` Whether the renderscript code should be compiled to generate C/C++ bindings.
abstract Boolean?	`renderscriptSupportModeBlasEnabled` Whether the renderscript BLAS support lib should be used to make it compatible with older versions of Android.
abstract Boolean?	`renderscriptSupportModeEnabled` Whether the renderscript code should be compiled in support mode to make it compatible with older versions of Android.
abstract Int?	`renderscriptTargetApi` The renderscript target api, or null if not specified.
abstract MutableSet<String>	`resourceConfigurations` Specifies a list of alternative resources to keep.
abstract String?	`testApplicationId` Test application ID.
abstract Boolean?	`testFunctionalTest` See instrumentation.
abstract Boolean?	`testHandleProfiling` See instrumentation.
abstract String?	`testInstrumentationRunner` Test instrumentation runner class name.
abstract MutableMap<String, String>	`testInstrumentationRunnerArguments` Test instrumentation runner custom arguments.
abstract VectorDrawables	`vectorDrawables` Options to configure the build-time support for `vector` drawables.
abstract Boolean?	`wearAppUnbundled` Whether to enable unbundling mode for embedded wear app.

Inherited properties

From class VariantDimension

`ExternalNativeBuildOptions`	`externalNativeBuild` Encapsulates per-variant CMake and ndk-build configurations for your external native build. To learn more, see Add C and C++ Code to Your Project.
`JavaCompileOptions`	`javaCompileOptions` Options for configuring Java compilation.
`MutableMap<String, Any>`	`manifestPlaceholders` The manifest placeholders. See Inject Build Variables into the Manifest.
`File?`	`multiDexKeepFile` Text file that specifies additional classes that will be compiled into the main dex file. Classes specified in the file are appended to the main dex classes computed using `aapt`. If set, the file should contain one class per line, in the following format: `com/example/MyClass.class`
`File?`	`multiDexKeepProguard` Text file with additional ProGuard rules to be used to determine which classes are compiled into the main dex file. If set, rules from this file are used in combination with the default rules used by the build system.
`Ndk`	`ndk` Encapsulates per-variant configurations for the NDK, such as ABI filters.
`MutableList<File>`	`proguardFiles` Specifies the ProGuard configuration files that the plugin should use. There are two ProGuard rules files that ship with the Android plugin and are used by default: proguard-android.txt proguard-android-optimize.txt `proguard-android-optimize.txt` is identical to `proguard-android.txt`, except with optimizations enabled. You can use getDefaultProguardFileString to return the full path of the files.
`Shaders`	`shaders` Options for configuring the shader compiler.
`MutableList<File>`	`testProguardFiles` The collection of proguard rule files to be used when processing test code. Test code needs to be processed to apply the same obfuscation as was done to main code.

Public methods

getName

abstract fun getName(): String

The name of the flavor.

vectorDrawables

abstract fun vectorDrawables(action: VectorDrawables.() -> Unit): Unit

Configures VectorDrawables.

Properties

minSdk

abstract var minSdk: Int?

The minimum SDK version. Setting this it will override previous calls of minSdk and minSdkPreview setters. Only one of minSdk and minSdkPreview should be set.

See uses-sdk element documentation.

minSdkPreview

abstract var minSdkPreview: String?

The minimum SDK version. Setting this it will override previous calls of minSdk and minSdkPreview setters. Only one of minSdk and minSdkPreview should be set.

See uses-sdk element documentation.

renderscriptNdkModeEnabled

abstract var renderscriptNdkModeEnabled: Boolean?

Whether the renderscript code should be compiled to generate C/C++ bindings. True for C/C++ generation, false for Java, null if not specified.

renderscriptSupportModeBlasEnabled

abstract var renderscriptSupportModeBlasEnabled: Boolean?

Whether the renderscript BLAS support lib should be used to make it compatible with older versions of Android.

True if BLAS support lib is enabled, false if not, and null if not specified.

renderscriptSupportModeEnabled

abstract var renderscriptSupportModeEnabled: Boolean?

Whether the renderscript code should be compiled in support mode to make it compatible with older versions of Android.

True if support mode is enabled, false if not, and null if not specified.

renderscriptTargetApi

abstract var renderscriptTargetApi: Int?

The renderscript target api, or null if not specified. This is only the value set on this product flavor.

resourceConfigurations

abstract val resourceConfigurations: MutableSet<String>

Specifies a list of alternative resources to keep.

For example, if you are using a library that includes language resources (such as AppCompat or Google Play Services), then your APK includes all translated language strings for the messages in those libraries whether the rest of your app is translated to the same languages or not. If you'd like to keep only the languages that your app officially supports, you can specify those languages using the resConfigs property, as shown in the sample below. Any resources for languages not specified are removed.

android {
    defaultConfig {
        ...
        // Keeps language resources for only the locales specified below.
        resConfigs "en", "fr"
    }
}

You can also use this property to filter resources for screen densities. For example, specifying hdpi removes all other screen density resources (such as mdpi, xhdpi, etc) from the final APK.

Note: auto is no longer supported because it created a number of issues with multi-module projects. Instead, you should specify a list of locales that your app supports, as shown in the sample above. Android plugin 3.1.0 and higher ignore the auto argument, and Gradle packages all string resources your app and its dependencies provide.

To learn more, see Remove unused alternative resources.

testApplicationId

abstract var testApplicationId: String?

Test application ID.

See Set the Application ID

testFunctionalTest

abstract var testFunctionalTest: Boolean?

See instrumentation.

testHandleProfiling

abstract var testHandleProfiling: Boolean?

See instrumentation.

testInstrumentationRunner

abstract var testInstrumentationRunner: String?

Test instrumentation runner class name.

This is a fully qualified class name of the runner, e.g. android.test.InstrumentationTestRunner

See instrumentation.

testInstrumentationRunnerArguments

abstract val testInstrumentationRunnerArguments: MutableMap<String, String>

Test instrumentation runner custom arguments.

e.g. [key: "value"] will give adb shell am instrument -w -e key value com.example...

See instrumentation.

Test runner arguments can also be specified from the command line:

./gradlew connectedAndroidTest -Pandroid.testInstrumentationRunnerArguments.size=medium
./gradlew connectedAndroidTest -Pandroid.testInstrumentationRunnerArguments.foo=bar

vectorDrawables

abstract val vectorDrawables: VectorDrawables

Options to configure the build-time support for vector drawables.

wearAppUnbundled

abstract var wearAppUnbundled: Boolean?

Whether to enable unbundling mode for embedded wear app.

If true, this enables the app to transition from an embedded wear app to one distributed by the play store directly.