summaryrefslogtreecommitdiff
path: root/Library/PackageCache/com.unity.test-framework@1.1.11/Documentation~/reference-itest-run-settings.md
blob: 7f7b06ecd1b5db6577c9b9ec934d6a048e02a7b7 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# ITestRunSettings
`ITestRunSettings` lets you set any of the global settings right before building a Player for a test run and then reverts the settings afterward.
`ITestRunSettings` implements [IDisposable](https://docs.microsoft.com/en-us/dotnet/api/system.idisposable), and runs after building the Player with tests.

## Public methods

| Syntax           | Description                                                  |
| ---------------- | ------------------------------------------------------------ |
| `void Apply()`   | A method called before building the Player.                  |
| `void Dispose()` | A method called after building the Player or if the build failed. |

## Example
The following example sets the iOS SDK version to be the simulator SDK and resets it to the original value after the run.
``` C#
public class MyTestSettings : ITestRunSettings
{
    private iOSSdkVersion originalSdkVersion;
    public void Apply()
    {
        originalSdkVersion = PlayerSettings.iOS.sdkVersion;
        PlayerSettings.iOS.sdkVersion = iOSSdkVersion.SimulatorSDK;
    }

    public void Dispose()
    {
        PlayerSettings.iOS.sdkVersion = originalSdkVersion;
    }
}
```