TestExtension

View Source

Added in 4.2.0

interface TestExtension : CommonExtension

---

Extension for the Android Test Gradle Plugin.

This is the android block when the com.android.test plugin is applied.

Only the Android Gradle Plugin should create instances of interfaces in com.android.build.api.dsl.

Summary

Public functions
Unit	androidResources(action: TestAndroidResources.() -> Unit) Specifies options related to the processing of Android Resources.
Unit	buildFeatures(action: TestBuildFeatures.() -> Unit) A list of build features that can be enabled or disabled on the Android Project.
Unit	buildTypes(action: NamedDomainObjectContainer<TestBuildType>.() -> Unit) Encapsulates all build type configurations for this project.
Unit	NamedDomainObjectContainer<TestBuildType>.debug(action: TestBuildType.() -> Unit) Shortcut extension method to allow easy access to the predefined debug TestBuildType
Unit	defaultConfig(action: TestDefaultConfig.() -> Unit) Specifies defaults for variant properties that the Android plugin applies to all build variants.
Unit	installation(action: TestInstallation.() -> Unit) Specifies options for the Android Debug Bridge (ADB), such as APK installation options.
Unit	privacySandbox(action: PrivacySandbox.() -> Unit)
Unit	productFlavors(action: NamedDomainObjectContainer<TestProductFlavor>.() -> Unit) Encapsulates all product flavors configurations for this project.
Unit	NamedDomainObjectContainer<TestBuildType>.release(action: TestBuildType.() -> Unit) Shortcut extension method to allow easy access to the predefined release TestBuildType

Public properties
TestAndroidResources	androidResources Specifies options related to the processing of Android Resources.
TestBuildFeatures	buildFeatures A list of build features that can be enabled or disabled on the Android Project.
NamedDomainObjectContainer<TestBuildType>	buildTypes Encapsulates all build type configurations for this project.
TestDefaultConfig	defaultConfig Specifies defaults for variant properties that the Android plugin applies to all build variants.
TestInstallation	installation Specifies options for the Android Debug Bridge (ADB), such as APK installation options.
PrivacySandbox	privacySandbox Options related to the consumption of privacy sandbox libraries
NamedDomainObjectContainer<TestProductFlavor>	productFlavors Encapsulates all product flavors configurations for this project.
String?	targetProjectPath The Gradle path of the project that this test project tests.

Inherited functions

From com.android.build.api.dsl.CommonExtension Unit aaptOptions(action: AaptOptions.() -> Unit) This function is deprecated. Replaced by Unit adbOptions(action: AdbOptions.() -> Unit) This function is deprecated. Replaced by installation Unit buildToolsVersion(buildToolsVersion: String) This function is deprecated. Replaced by buildToolsVersion property Unit compileOptions(action: CompileOptions.() -> Unit) Specifies Java compiler options, such as the language level of the Java source code and generated bytecode. Unit compileSdk(action: CompileSdkSpec.() -> Unit) Configures all aspects regarding compile Sdk version, see CompileSdkSpec for more details. Unit compileSdkAddon(vendor: String, name: String, version: Int) Specify an SDK add-on to compile your project against. Unit compileSdkVersion(apiLevel: Int) This function is deprecated. Will be removed in AGP 10.0, replaced by the compileSdk block Unit compileSdkVersion(version: String) This function is deprecated. Will be removed in AGP 10.0, replaced by the compileSdk block Unit composeOptions(action: ComposeOptions.() -> Unit) Unit dataBinding(action: DataBinding.() -> Unit) Specifies options for the Data Binding Library. Unit externalNativeBuild(action: ExternalNativeBuild.() -> Unit) Specifies options for external native build using CMake or ndk-build. File getDefaultProguardFile(name: String) Unit @Incubating jacoco(action: JacocoOptions.() -> Unit) This function is deprecated. Renamed to testCoverage Unit lint(action: Lint.() -> Unit) Specifies options for the lint tool. Unit @Incubating lintOptions(action: LintOptions.() -> Unit) This function is deprecated. Renamed to lint Unit packaging(action: Packaging.() -> Unit) Specifies options and rules that determine which files the Android plugin packages into your APK. Unit packagingOptions(action: Packaging.() -> Unit) This function is deprecated. Renamed to packaging Unit signingConfigs(action: NamedDomainObjectContainer<ApkSigningConfig>.() -> Unit) Encapsulates signing configurations that you can apply to BuildType and ProductFlavor configurations. Unit sourceSets(action: NamedDomainObjectContainer<AndroidSourceSet>.() -> Unit) Encapsulates source set configurations for all variants. Unit splits(action: Splits.() -> Unit) Specifies configurations for building multiple APKs or APK splits. Unit testCoverage(action: TestCoverage.() -> Unit) Configure the gathering of code-coverage from tests. Unit testOptions(action: TestOptions.() -> Unit) Specifies options for how the Android plugin should run local and instrumented tests. Unit useLibrary(name: String) Includes the specified library to the classpath. Unit useLibrary(name: String, required: Boolean) Includes the specified library to the classpath. Unit viewBinding(action: ViewBinding.() -> Unit) Specifies options for the View Binding Library.

Inherited properties

From com.android.build.api.dsl.CommonExtension AaptOptions aaptOptions This property is deprecated. Replaced by AdbOptions adbOptions This property is deprecated. Replaced by installation String buildToolsVersion Specifies the version of the SDK Build Tools to use when building your project. CompileOptions compileOptions Specifies Java compiler options, such as the language level of the Java source code and generated bytecode. Int? compileSdk Specifies the API level to compile your project against. Int? compileSdkExtension Specifies the SDK Extension level to compile your project against. Int? compileSdkMinor Specify a minor API version for the compile SDK. String? compileSdkPreview Specify a preview API to compile your project against. ComposeOptions composeOptions DataBinding dataBinding Specifies options for the Data Binding Library. MutableMap<String, Any> experimentalProperties Additional per module experimental properties. ExternalNativeBuild externalNativeBuild Specifies options for external native build using CMake or ndk-build. MutableList<String> flavorDimensions Specifies the names of product flavor dimensions for this project. JacocoOptions jacoco This property is deprecated. Renamed to testCoverage Lint lint Specifies options for the lint tool. LintOptions lintOptions This property is deprecated. Renamed to lint String? namespace The namespace of the generated R and BuildConfig classes. String? ndkPath Requires the specified path to NDK be used. String ndkVersion Requires the specified NDK version to be used. Packaging packaging Specifies options and rules that determine which files the Android plugin packages into your APK. Packaging packagingOptions This property is deprecated. Renamed to packaging String? resourcePrefix Specifies this project's resource prefix to Android Studio for editor features, such as Lint checks. SdkComponents sdkComponents NamedDomainObjectContainer<ApkSigningConfig> signingConfigs Encapsulates signing configurations that you can apply to [ ] and [ ] configurations. NamedDomainObjectContainer<AndroidSourceSet> sourceSets Encapsulates source set configurations for all variants. Splits splits Specifies configurations for building multiple APKs or APK splits. TestCoverage testCoverage Configure the gathering of code-coverage from tests. TestOptions testOptions Specifies options for how the Android plugin should run local and instrumented tests. ViewBinding viewBinding Specifies options for the View Binding Library.

Public functions

androidResources

Added in 9.0.0-alpha02

fun androidResources(action: TestAndroidResources.() -> Unit): Unit

Specifies options related to the processing of Android Resources.

For more information about the properties you can configure in this block, see TestAndroidResources.

buildFeatures

Added in 9.0.0-alpha02

fun buildFeatures(action: TestBuildFeatures.() -> Unit): Unit

A list of build features that can be enabled or disabled on the Android Project.

buildTypes

Added in 9.0.0-alpha02

fun buildTypes(action: NamedDomainObjectContainer<TestBuildType>.() -> Unit): Unit

Encapsulates all build type configurations for this project.

For more information about the properties you can configure in this block, see TestBuildType

debug

Added in 9.0.0-alpha02

fun NamedDomainObjectContainer<TestBuildType>.debug(action: TestBuildType.() -> Unit): Unit

Shortcut extension method to allow easy access to the predefined debug TestBuildType

For example:

 android {
     buildTypes {
         debug {
             // ...
         }
     }
}

defaultConfig

Added in 9.0.0-alpha02

fun defaultConfig(action: TestDefaultConfig.() -> Unit): Unit

Specifies defaults for variant properties that the Android plugin applies to all build variants.

You can override any defaultConfig property when configuring product flavors

For more information about the properties you can configure in this block, see DefaultConfig.

installation

Added in 9.0.0-alpha02

fun installation(action: TestInstallation.() -> Unit): Unit

Specifies options for the Android Debug Bridge (ADB), such as APK installation options.

For more information about the properties you can configure in this block, see AdbOptions.

privacySandbox

Added in 8.5.0

fun privacySandbox(action: PrivacySandbox.() -> Unit): Unit

productFlavors

Added in 9.0.0-alpha02

fun productFlavors(action: NamedDomainObjectContainer<TestProductFlavor>.() -> Unit): Unit

Encapsulates all product flavors configurations for this project.

For more information about the properties you can configure in this block, see ProductFlavor

release

Added in 9.0.0-alpha02

fun NamedDomainObjectContainer<TestBuildType>.release(action: TestBuildType.() -> Unit): Unit

Shortcut extension method to allow easy access to the predefined release TestBuildType

For example:

 android {
     buildTypes {
         release {
             // ...
         }
     }
}

Public properties

androidResources

val androidResources: TestAndroidResources

Specifies options related to the processing of Android Resources.

For more information about the properties you can configure in this block, see TestAndroidResources.

buildFeatures

val buildFeatures: TestBuildFeatures

A list of build features that can be enabled or disabled on the Android Project.

buildTypes

val buildTypes: NamedDomainObjectContainer<TestBuildType>

Encapsulates all build type configurations for this project.

Unlike using TestProductFlavor to create different versions of your project that you expect to co-exist on a single device, build types determine how Gradle builds and packages each version of your project. Developers typically use them to configure projects for various stages of a development lifecycle. For example, when creating a new project from Android Studio, the Android plugin configures a 'debug' and 'release' build type for you. You can then combine build types with product flavors to create build variants.

See also
BuildType

defaultConfig

val defaultConfig: TestDefaultConfig

Specifies defaults for variant properties that the Android plugin applies to all build variants.

You can override any defaultConfig property when configuring product flavors

For more information about the properties you can configure in this block, see DefaultConfig.

installation

val installation: TestInstallation

Specifies options for the Android Debug Bridge (ADB), such as APK installation options.

For more information about the properties you can configure in this block, see AdbOptions.

privacySandbox

Added in 8.5.0

val privacySandbox: PrivacySandbox

Options related to the consumption of privacy sandbox libraries

productFlavors

val productFlavors: NamedDomainObjectContainer<TestProductFlavor>

Encapsulates all product flavors configurations for this project.

Product flavors represent different versions of your project that you expect to co-exist on a single device, the Google Play store, or repository. For example, you can configure 'demo' and 'full' product flavors for your app, and each of those flavors can specify different features, device requirements, resources, and application ID's--while sharing common source code and resources. So, product flavors allow you to output different versions of your project by simply changing only the components and settings that are different between them.

Configuring product flavors is similar to configuring build types: add them to the productFlavors block of your project's build.gradle file and configure the settings you want. Product flavors support the same properties as the defaultConfig block--this is because defaultConfig defines an object that the plugin uses as the base configuration for all other flavors. Each flavor you configure can then override any of the default values in defaultConfig, such as the applicationId.

When using Android plugin 3.0.0 and higher, each flavor must belong to a com.android.build.gradle.BaseExtension.html#com.android.build.gradle.BaseExtension:flavorDimensions(java.lang.String[]) value. By default, when you specify only one dimension, all flavors you configure belong to that dimension. If you specify more than one flavor dimension, you need to manually assign each flavor to a dimension. To learn more, read Use Flavor Dimensions for variant-aware dependency management.

When you configure product flavors, the Android plugin automatically combines them with your BuildType configurations to create build variants. If the plugin creates certain build variants that you don't want, you can filter variants.

See also
ProductFlavor

targetProjectPath

Added in 4.2.0

var targetProjectPath: String?

The Gradle path of the project that this test project tests.