# FailureRetention

# FailureRetention


```
@Incubating
public interface FailureRetention extends EmulatorSnapshots
```

<br />

*** ** * ** ***

| **This interface is deprecated.**   
| Renamed to EmulatorSnapshots

Options for configuring Android Test Retention.

When enabled, Android Test Retention automatically takes emulator snapshots on test failures.

## Summary

| ### Public methods |
|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `abstract boolean` | [getEnable](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/FailureRetention#getEnable())`()`                                       |
| `abstract int`     | [getMaxSnapshots](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/FailureRetention#getMaxSnapshots())`()`                           |
| `abstract void`    | [setEnable](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/FailureRetention#setEnable(kotlin.Boolean))`(boolean enable)`           |
| `abstract void`    | [setMaxSnapshots](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/FailureRetention#setMaxSnapshots(kotlin.Int))`(int maxSnapshots)` |

|                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           ### Inherited methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| From [com.android.build.api.dsl.EmulatorSnapshots](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/EmulatorSnapshots) |--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `abstract boolean` | [getCompressSnapshots](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/EmulatorSnapshots#getCompressSnapshots())`()` Enables snapshot compression.                                                                                      | | `abstract boolean` | [getEnableForTestFailures](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/EmulatorSnapshots#getEnableForTestFailures())`()` Enables automated test failure snapshots.                                                                  | | `abstract int`     | [getMaxSnapshotsForTestFailures](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/EmulatorSnapshots#getMaxSnapshotsForTestFailures())`()` Maximum number of failures that would be snapshotted.                                          | | `abstract void`    | [retainAll](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/EmulatorSnapshots#retainAll())`()` Call this function to take unlimited number of test failure snapshots (will ignore maxSnapshotsForTestFailures setting)                  | | `abstract void`    | [setCompressSnapshots](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/EmulatorSnapshots#setCompressSnapshots(kotlin.Boolean))`(boolean compressSnapshots)` Enables snapshot compression.                                               | | `abstract void`    | [setEnableForTestFailures](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/EmulatorSnapshots#setEnableForTestFailures(kotlin.Boolean))`(boolean enableForTestFailures)` Enables automated test failure snapshots.                       | | `abstract void`    | [setMaxSnapshotsForTestFailures](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/dsl/EmulatorSnapshots#setMaxSnapshotsForTestFailures(kotlin.Int))`(int maxSnapshotsForTestFailures)` Maximum number of failures that would be snapshotted. | |

## Public methods

### getEnable

```
abstract boolean getEnable()
```  

### getMaxSnapshots

```
abstract int getMaxSnapshots()
```  

### setEnable

```
abstract void setEnable(boolean enable)
```  

### setMaxSnapshots

```
abstract void setMaxSnapshots(int maxSnapshots)
```