116 lines
2.9 KiB
Markdown
116 lines
2.9 KiB
Markdown
|
# Running tests from the command line
|
|||
|
|
|
|||
|
|
It’s pretty simple to run a test project from the command line. Here is an example in Windows:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
Unity.exe -runTests -batchmode -projectPath PATH_TO_YOUR_PROJECT -testResults C:\temp\results.xml -testPlatform PS4
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
For more information, see [Command line arguments](https://docs.unity3d.com/Manual/CommandLineArguments.html).
|
|||
|
|
|
|||
|
|
## Commands
|
|||
|
|
|
|||
|
|
### batchmode
|
|||
|
|
|
|||
|
|
Runs Unity in batch mode and ensures no pop-up windows appear to eliminate the need for any human intervention.
|
|||
|
|
|
|||
|
|
### forgetProjectPath
|
|||
|
|
|
|||
|
|
Don't save your current **Project** into the Unity launcher/hub history.
|
|||
|
|
|
|||
|
|
### runTest
|
|||
|
|
|
|||
|
|
Runs tests in the Project.
|
|||
|
|
|
|||
|
|
### testCategory
|
|||
|
|
|
|||
|
|
A semicolon-separated list of test categories to include in the run. If using both `testFilter` and `testCategory`, then tests only run that matches both.
|
|||
|
|
|
|||
|
|
### testFilter
|
|||
|
|
|
|||
|
|
A semicolon-separated list of test names to run, or a regular expression pattern to match tests by their full name.
|
|||
|
|
|
|||
|
|
### testPlatform
|
|||
|
|
|
|||
|
|
The platform you want to run tests on. Available platforms are **EditMode** and **PlayMode**.
|
|||
|
|
|
|||
|
|
> **Note**: If unspecified, tests run in Edit Mode by default.
|
|||
|
|
|
|||
|
|
Platform/Type convention is from the [BuildTarget](https://docs.unity3d.com/ScriptReference/BuildTarget.html) enum. Supported platforms are:
|
|||
|
|
|
|||
|
|
* StandaloneWindows
|
|||
|
|
* StandaloneWindows64
|
|||
|
|
* StandaloneLinux64
|
|||
|
|
* StandaloneOSX
|
|||
|
|
* iOS
|
|||
|
|
* Android
|
|||
|
|
* PS4
|
|||
|
|
* XboxOne
|
|||
|
|
|
|||
|
|
### testResults
|
|||
|
|
|
|||
|
|
The path where Unity should save the result file. By default, Unity saves it in the Project’s root folder.
|
|||
|
|
|
|||
|
|
### playerHeartbeatTimeout
|
|||
|
|
|
|||
|
|
The time, in seconds, the editor should wait for heartbeats after starting a test run on a player. This defaults to 10 minutes.
|
|||
|
|
|
|||
|
|
### testSettingsFile
|
|||
|
|
|
|||
|
|
Path to a *TestSettings.json* file that allows you to set up extra options for your test run. An example of the *TestSettings.json* file could look like this:
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"scriptingBackend":2,
|
|||
|
|
"Architecture":null,
|
|||
|
|
"apiProfile":0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### apiProfile
|
|||
|
|
|
|||
|
|
The .Net compatibility level. Set to one of the following values:
|
|||
|
|
|
|||
|
|
- 1 - .Net 2.0
|
|||
|
|
- 2 - .Net 2.0 Subset
|
|||
|
|
- 3 - .Net 4.6
|
|||
|
|
- 5 - .Net micro profile (used by Mono scripting backend if **Stripping Level** is set to **Use micro mscorlib**)
|
|||
|
|
- 6 - .Net Standard 2.0
|
|||
|
|
|
|||
|
|
#### appleEnableAutomaticSigning
|
|||
|
|
|
|||
|
|
Sets option for automatic signing of Apple devices.
|
|||
|
|
|
|||
|
|
#### appleDeveloperTeamID
|
|||
|
|
|
|||
|
|
Sets the team ID for the apple developer account.
|
|||
|
|
|
|||
|
|
#### architecture
|
|||
|
|
|
|||
|
|
Target architecture for Android. Set to one of the following values:
|
|||
|
|
|
|||
|
|
* None = 0
|
|||
|
|
* ARMv7 = 1
|
|||
|
|
* ARM64 = 2
|
|||
|
|
* X86 = 4
|
|||
|
|
* All = 4294967295
|
|||
|
|
|
|||
|
|
#### iOSManualProvisioningProfileType
|
|||
|
|
|
|||
|
|
Set to one of the following values:
|
|||
|
|
|
|||
|
|
* 0 - Automatic
|
|||
|
|
* 1 - Development
|
|||
|
|
* 2 - Distribution iOSManualProvisioningProfileID
|
|||
|
|
|
|||
|
|
#### scriptingBackend
|
|||
|
|
|
|||
|
|
Set to one of the following values:
|
|||
|
|
|
|||
|
|
- Mono2x = 0
|
|||
|
|
- IL2CPP = 1
|
|||
|
|
- WinRT DotNET = 2
|
|||
|
|
|
|||
|
|
#### useLatestScriptingRuntimeVersion
|
|||
|
|
|
|||
|
|
Sets option to always use the latest [Scripting Runtime Version](https://docs.unity3d.com/Manual/ScriptingRuntimeUpgrade.html).
|