# KotlinMultiplatformAndroidTestOnDevice

# KotlinMultiplatformAndroidTestOnDevice

<br />

```
@Incubating
public interface KotlinMultiplatformAndroidTestOnDevice
```

<br />

Known direct subclasses  
[KotlinMultiplatformAndroidTestOnDeviceCompilation](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDeviceCompilation)  

|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| [KotlinMultiplatformAndroidTestOnDeviceCompilation](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDeviceCompilation) |   |

*** ** * ** ***

## Summary

|                                                                                                                                                                                                                                                                                                           ### Public methods                                                                                                                                                                                                                                                                                                            |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [emulatorControl](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#emulatorControl(kotlin.Function1))`(` ` @`[ExtensionFunctionType](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-extension-function-type/index.html)` @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` Function1<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[EmulatorControl](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/EmulatorControl)`, `[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html)`> action` `)`                                                                                                                                          |
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [emulatorSnapshots](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#emulatorSnapshots(kotlin.Function1))`(` ` @`[ExtensionFunctionType](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-extension-function-type/index.html)` @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` Function1<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[EmulatorSnapshots](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/EmulatorSnapshots)`, `[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html)`> action` `)`                                                                                                                                  |
| `abstract boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [getAnimationsDisabled](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#getAnimationsDisabled())`()` Disables animations during instrumented tests you run from the command line.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `abstract `[String](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [getApplicationId](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#getApplicationId())`()` The test application id.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `abstract @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[EmulatorControl](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/EmulatorControl)                                                                                                                                                                                                                                                                                                                                                                                   | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [getEmulatorControl](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#getEmulatorControl())`()` Configures Android Emulator Grpc Access                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `abstract @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[EmulatorSnapshots](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/EmulatorSnapshots)                                                                                                                                                                                                                                                                                                                                                                               | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [getEmulatorSnapshots](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#getEmulatorSnapshots())`()` Configures Android Test Retention.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `abstract boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [getEnableCoverage](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#getEnableCoverage())`()` Specifies code coverage is enabled for module tests of type AndroidTest.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `abstract @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[String](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html)                                                                                                                                                                                                                                                                                                                                                                                                                     | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [getExecution](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#getExecution())`()` Specifies whether to use on-device test orchestration.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `abstract `[Boolean](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Boolean.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [getFunctionalTest](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#getFunctionalTest())`()` See[instrumentation](http://developer.android.com/guide/topics/manifest/instrumentation-element.html).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `abstract `[Boolean](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Boolean.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [getHandleProfiling](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#getHandleProfiling())`()` See[instrumentation](http://developer.android.com/guide/topics/manifest/instrumentation-element.html).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `abstract @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[Installation](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/Installation)                                                                                                                                                                                                                                                                                                                                                                                         | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [getInstallation](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#getInstallation())`()` Specifies options for the[Android Debug Bridge (ADB)](https://developer.android.com/studio/command-line/adb.html), such as APK installation options.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `abstract `[String](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [getInstrumentationRunner](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#getInstrumentationRunner())`()` Test instrumentation runner class name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `abstract @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[Map](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Map.html)`<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[String](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html)`, @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[String](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html)`>` | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [getInstrumentationRunnerArguments](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#getInstrumentationRunnerArguments())`()` Test instrumentation runner custom arguments.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `abstract @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[ManagedDevices](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/ManagedDevices)                                                                                                                                                                                                                                                                                                                                                                                     | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [getManagedDevices](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#getManagedDevices())`()` Configures Gradle Managed Devices for use in testing with the Unified test platform.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `abstract @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[MultiDexConfig](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/MultiDexConfig)                                                                                                                                                                                                                                                                                                                                                                                     | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [getMultidex](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#getMultidex())`()`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `abstract @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[ApkSigningConfig](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/ApkSigningConfig)                                                                                                                                                                                                                                                                                                                                                                                 | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [getSigning](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#getSigning())`()` Encapsulates signing configurations that you can apply to test APK                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [installation](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#installation(kotlin.Function1))`(` ` @`[ExtensionFunctionType](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-extension-function-type/index.html)` @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` Function1<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[Installation](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/Installation)`, `[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html)`> action` `)` Specifies options for the[Android Debug Bridge (ADB)](https://developer.android.com/studio/command-line/adb.html), such as APK installation options. |
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [managedDevices](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#managedDevices(kotlin.Function1))`(` ` @`[ExtensionFunctionType](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-extension-function-type/index.html)` @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` Function1<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[ManagedDevices](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/ManagedDevices)`, `[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html)`> action` `)` Configures Gradle Managed Devices for use in testing with the Unified test platform.                                                         |
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [multidex](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#multidex(kotlin.Function1))`(` ` @`[ExtensionFunctionType](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-extension-function-type/index.html)` @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` Function1<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[MultiDexConfig](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/MultiDexConfig)`, `[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html)`> action` `)`                                                                                                                                                          |
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [setAnimationsDisabled](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#setAnimationsDisabled(kotlin.Boolean))`(boolean animationsDisabled)` Disables animations during instrumented tests you run from the command line.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [setApplicationId](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#setApplicationId(kotlin.String))`(`[String](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html)` applicationId)` The test application id.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [setEnableCoverage](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#setEnableCoverage(kotlin.Boolean))`(boolean enableCoverage)` Specifies code coverage is enabled for module tests of type AndroidTest.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [setExecution](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#setExecution(kotlin.String))`(@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[String](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html)` execution)` Specifies whether to use on-device test orchestration.                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [setFunctionalTest](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#setFunctionalTest(kotlin.Boolean))`(`[Boolean](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Boolean.html)` functionalTest)` See[instrumentation](http://developer.android.com/guide/topics/manifest/instrumentation-element.html).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [setHandleProfiling](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#setHandleProfiling(kotlin.Boolean))`(`[Boolean](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Boolean.html)` handleProfiling)` See[instrumentation](http://developer.android.com/guide/topics/manifest/instrumentation-element.html).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [setInstrumentationRunner](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#setInstrumentationRunner(kotlin.String))`(`[String](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html)` instrumentationRunner)` Test instrumentation runner class name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `@`[Incubating](https://docs.gradle.org/current/javadoc/org/gradle/api/Incubating.html) [signing](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/KotlinMultiplatformAndroidTestOnDevice#signing(kotlin.Function1))`(` ` @`[ExtensionFunctionType](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-extension-function-type/index.html)` @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` Function1<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[ApkSigningConfig](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/ApkSigningConfig)`, `[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html)`> action` `)`                                                                                                                                                        |

## Public methods

### emulatorControl

```
@Incubating
abstract void emulatorControl(
    @ExtensionFunctionType @NonNull Function1<@NonNull EmulatorControl, Unit> action
)
```  

### emulatorSnapshots

```
@Incubating
abstract void emulatorSnapshots(
    @ExtensionFunctionType @NonNull Function1<@NonNull EmulatorSnapshots, Unit> action
)
```  

### getAnimationsDisabled

```
@Incubating
abstract boolean getAnimationsDisabled()
```

Disables animations during instrumented tests you run from the command line.

If you set this property to`true`, running instrumented tests with Gradle from the command line executes`am instrument`with the`--no-window-animation`flag. By default, this property is set to`false`.

This property does not affect tests that you run using Android Studio. To learn more about running tests from the command line, see[Test from the Command Line](https://d.android.com/studio/test/command-line.html).  

### getApplicationId

```
@Incubating
abstract String getApplicationId()
```

The test application id.  

### getEmulatorControl

```
@Incubating
abstract @NonNull EmulatorControl getEmulatorControl()
```

Configures Android Emulator Grpc Access

Android Emulator Grpc Access will make it possible to interact with the emulator over gRPC  

```kotlin
emulatorControl {
  enable true
  secondsValid 180
  allowedEndpoints.addAll(
      "/android.emulation.control.EmulatorController/getStatus",
      "/android.emulation.control.EmulatorController/getVmState")
}
```  

### getEmulatorSnapshots

```
@Incubating
abstract @NonNull EmulatorSnapshots getEmulatorSnapshots()
```

Configures Android Test Retention.

Android Test Retention automatically takes emulator snapshots on test failures. It can only work with Unified Test Platform (UTP).  

```kotlin
emulatorSnapshots {
  enableForTestFailures true
  maxSnapshotsForTestFailures 2
  compressSnapshots false
}
```  

### getEnableCoverage

```
@Incubating
abstract boolean getEnableCoverage()
```

Specifies code coverage is enabled for module tests of type AndroidTest.

If enabled, prepares module class files for code coverage collection such as instrumenting dependent library classes and module classes. This allows for code coverage reports to be generated.  

### getExecution

```
@Incubating
abstract @NonNull String getExecution()
```

Specifies whether to use on-device test orchestration.

If you want to[use Android Test Orchestrator](https://developer.android.com/training/testing/junit-runner.html#using-android-test-orchestrator)you need to specify`"ANDROID_TEST_ORCHESTRATOR"`, as shown below. By default, this property is set to`"HOST"`, which disables on-device orchestration.  

### getFunctionalTest

```
@Incubating
abstract Boolean getFunctionalTest()
```

See[instrumentation](http://developer.android.com/guide/topics/manifest/instrumentation-element.html).  

### getHandleProfiling

```
@Incubating
abstract Boolean getHandleProfiling()
```

See[instrumentation](http://developer.android.com/guide/topics/manifest/instrumentation-element.html).  

### getInstallation

```
@Incubating
abstract @NonNull Installation getInstallation()
```

Specifies options for the[Android Debug Bridge (ADB)](https://developer.android.com/studio/command-line/adb.html), such as APK installation options.

For more information about the properties you can configure in this block, see[Installation](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/Installation).  

### getInstrumentationRunner

```
@Incubating
abstract String getInstrumentationRunner()
```

Test instrumentation runner class name. This is a fully qualified class name of the runner See[instrumentation](http://developer.android.com/guide/topics/manifest/instrumentation-element.html).  

### getInstrumentationRunnerArguments

```
@Incubating
abstract @NonNull Map<@NonNull String, @NonNull String> getInstrumentationRunnerArguments()
```

Test instrumentation runner custom arguments.

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

See[instrumentation](http://developer.android.com/guide/topics/manifest/instrumentation-element.html).

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

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

### getManagedDevices

```
@Incubating
abstract @NonNull ManagedDevices getManagedDevices()
```

Configures Gradle Managed Devices for use in testing with the Unified test platform.  

### getMultidex

```
@Incubating
abstract @NonNull MultiDexConfig getMultidex()
```  

### getSigning

```
@Incubating
abstract @NonNull ApkSigningConfig getSigning()
```

Encapsulates signing configurations that you can apply to test APK

For more information about the properties you can configure in this block, see[ApkSigningConfig](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/ApkSigningConfig).  

### installation

```
@Incubating
abstract void installation(
    @ExtensionFunctionType @NonNull Function1<@NonNull Installation, Unit> action
)
```

Specifies options for the[Android Debug Bridge (ADB)](https://developer.android.com/studio/command-line/adb.html), such as APK installation options.

For more information about the properties you can configure in this block, see[Installation](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/Installation).  

### managedDevices

```
@Incubating
abstract void managedDevices(
    @ExtensionFunctionType @NonNull Function1<@NonNull ManagedDevices, Unit> action
)
```

Configures Gradle Managed Devices for use in testing with the Unified test platform.  

### multidex

```
@Incubating
abstract void multidex(
    @ExtensionFunctionType @NonNull Function1<@NonNull MultiDexConfig, Unit> action
)
```  

### setAnimationsDisabled

```
@Incubating
abstract void setAnimationsDisabled(boolean animationsDisabled)
```

Disables animations during instrumented tests you run from the command line.

If you set this property to`true`, running instrumented tests with Gradle from the command line executes`am instrument`with the`--no-window-animation`flag. By default, this property is set to`false`.

This property does not affect tests that you run using Android Studio. To learn more about running tests from the command line, see[Test from the Command Line](https://d.android.com/studio/test/command-line.html).  

### setApplicationId

```
@Incubating
abstract void setApplicationId(String applicationId)
```

The test application id.  

### setEnableCoverage

```
@Incubating
abstract void setEnableCoverage(boolean enableCoverage)
```

Specifies code coverage is enabled for module tests of type AndroidTest.

If enabled, prepares module class files for code coverage collection such as instrumenting dependent library classes and module classes. This allows for code coverage reports to be generated.  

### setExecution

```
@Incubating
abstract void setExecution(@NonNull String execution)
```

Specifies whether to use on-device test orchestration.

If you want to[use Android Test Orchestrator](https://developer.android.com/training/testing/junit-runner.html#using-android-test-orchestrator)you need to specify`"ANDROID_TEST_ORCHESTRATOR"`, as shown below. By default, this property is set to`"HOST"`, which disables on-device orchestration.  

### setFunctionalTest

```
@Incubating
abstract void setFunctionalTest(Boolean functionalTest)
```

See[instrumentation](http://developer.android.com/guide/topics/manifest/instrumentation-element.html).  

### setHandleProfiling

```
@Incubating
abstract void setHandleProfiling(Boolean handleProfiling)
```

See[instrumentation](http://developer.android.com/guide/topics/manifest/instrumentation-element.html).  

### setInstrumentationRunner

```
@Incubating
abstract void setInstrumentationRunner(String instrumentationRunner)
```

Test instrumentation runner class name. This is a fully qualified class name of the runner See[instrumentation](http://developer.android.com/guide/topics/manifest/instrumentation-element.html).  

### signing

```
@Incubating
abstract void signing(
    @ExtensionFunctionType @NonNull Function1<@NonNull ApkSigningConfig, Unit> action
)
```