Справка командной строки
Unity Test Framework добавляет следующие дополнительные аргументы к обычным Unity Editor аргументам командной строки:
| Команда | Описание |
|---|---|
-assemblyNames |
Список тестовых сборок, разделенный точкой с запятой, для включения в запуск. Список, разделенный точкой с запятой, должен быть форматирован как строка в кавычках, e.g. -assemblyNames "firstAssembly;secondAssembly". |
-forgetProjectPath |
Запрещает Unity сохранять текущий проект в историю запуска/концентратора Unity. |
-orderedTestListFile |
Путь к файлу .txt, который содержит список полных имен тестов, которые вы хотите запустить в указанном порядке. Нет никаких ограничений на имя файла, пока формат является текстовым. Разделите тесты новыми строками и укажите параметры, если тесты имеют их. Ниже приведен пример содержимого такого файла:Unity.Framework.Tests.OrderedTests.NoParametersUnity.Framework.Tests.OrderedTests.ParametrizedTestA(3,2)Unity.Framework.Tests.OrderedTests.ParametrizedTestB("Assets/file.fbx")Unity.Framework.Tests.OrderedTests.ParametrizedTestD(1.0f)Unity.Framework.Tests.OrderedTests.ParametrizedTestE(null)Unity.Framework.Tests.OrderedTests.ParametrizedTestF(False, 1)Unity.Framework.Tests.OrderedTests.ParametrizedTestG(float.NaN)Unity.Framework.Tests.OrderedTests.ParametrizedTestH(SomeEnum) |
-playerHeartbeatTimeout |
Определяет продолжительность времени в секундах, в течение которого Редактор ожидает сердцебиения после начала тестового запуска на Проигрывателе. По умолчанию это 10 минут. |
-randomOrderSeed |
Ненулевое целое число, представляющее собой начальное значение, которое должно использоваться для рандомизированных тестов в проекте, независимо от фиксации.# normal orderTest_1Test_2Test_3Test_4# randomized with seed xTest_3 Test_1Test_4Test_2# randomized with same seed x and a new testTest_3Test_5Test_1Test_4Test_2 |
-repeat |
Целое число, определяющее количество повторений. Успешные тесты повторяются до указанного количества раз или до тех пор, пока они не завершатся неудачей, в зависимости от того, что произойдет раньше. |
-retry |
Целое число, определяющее количество повторных попыток. Неудачные тесты повторяются до указанного количества раз или до тех пор, пока они не завершатся успешно, в зависимости от того, что произойдет раньше. |
-runSynchronously |
Передайте этот аргумент для синхронного запуска тестов, гарантируя, что все тесты будут выполняться в одном вызове Editor update. Это поддерживается только для тестов режима редактирования. Тесты, которые принимают несколько кадров, такие как тесты [UnityTest], или тесты с [UnitySetUp] или [UnityTearDown] скелетами, фильтруются. |
-runTests |
Запускает тесты в Project. |
-testCategory |
Список категорий тестов, разделенный точкой с запятой, для включения в запуск, или шаблон регулярного выражения для соответствия названиям категорий. Список, разделенный точкой с запятой, должен быть отформатирован как строка в кавычках, например -testCategory "firstCategory;secondCategory". Если указаны и -testFilter, и -testCategory, запускаются только тесты, соответствующие обоим. Этот аргумент поддерживает отрицание с помощью !. Использование !MyCategory исключает тесты с категорией MyCategory из запуска. |
-testfilter |
Разделённый точкой с запятой список имен тестов для запуска, или шаблон регулярного выражения для сопоставления тестов по их полному имени. Список, разделенный точкой с запятой, должен быть форматирован как строка в кавычках, например testFilter "Low;Medium". Этот аргумент поддерживает отрицание с помощью !. Тестовый фильтр !MyNamespace.Something.MyTest запускает все тесты, кроме одного, называемого MyNamespace.Something.MyTest. Запустите конкретную вариацию параметризированного теста следующим образом: "ClassName\.MethodName\(Param1,Param2\)" |
-testPlatform |
Платформа для запуска тестов. Приемлемые значения:
|
-testResults |
Указывает путь, по которому Unity сохраняет файл результата теста. По умолчанию Unity сохраняет файл в корневой папке проекта. Результаты теста следуют формату XML, определенному NUnit, для более подробной информации см. Результат теста XML Формат. В настоящее время не существует общего определения кодов выхода, сообщаемых отдельными компонентами Unity, подвергающимися тестированию. Лучший способ понять источник проблемы — это содержание сообщений об ошибках и стека следов. |
-testSettingsFile |
Путь к файлу TestSettings.json. |
Примечание: Регулярный редактор -quit аргумент командной строки не поддерживается во время выполнения тестов.
Справочная информация о параметрах испытания
Вы можете определить параметры для тестового запуска в файле TestSettings.json. Вы можете указать расположение этого файла с помощью аргумента командной строки -testSettingsFile.
Следующий пример иллюстрирует содержимое типичного файла TestSettings.json:
{
"scriptingBackend":"WinRTDotNET",
"Architecture":null,
"apiProfile":0,
"featureFlags": { "requiresSplashScreen": true }
}
В следующей таблице перечислены действительные параметры и значения для файла TestSettings.json:
| Вариант | Описание |
|---|---|
apiProfile |
.NET API уровень совместимости. Установить одно из следующих значений:
|
appleEnableAutomaticSigning |
Включает автоматическое подписывание устройств Apple. Для получения дополнительной информации см. PlayerSettings.iOS.appleEnableAutomaticSigning. |
appleDeveloperTeamID |
Устанавливает команду ID для учетной записи разработчика Apple. Для получения дополнительной информации см. PlayerSettings.iOS.appleDeveloperTeamID. |
architecture |
Целевой показатель Android архитектура. Установить одно из следующих значений:
|
iOSManualProvisioningProfileType |
Более подробную информацию см. PlayerSettings.iOS.iOSManualProvisioningProfileType. Установить одно из следующих значений:
|
iOSTargetSDK |
Цель SDK для iOS. Установить одно из следующих значений, которое должно быть дано в виде буквальной строки в кавычках:
|
tvOSManualProvisioningProfileType |
Более подробную информацию см. PlayerSettings.iOS.tvOSManualProvisioningProfileType. Установить одно из следующих значений:
|
tvOSTargetSDK |
Цель SDK для tvOS. Установить одно из следующих значений, которое должно быть дано в виде буквальной строки в кавычках:
|
scriptingBackend |
Устанавливает одно из следующих значений, которое должно быть указано в виде буквальной строки в кавычках:
|
playerGraphicsAPI |
Установить графику API, которая будет использоваться во время тестового выполнения в проигрывателе. Значение может быть любым GraphicsDeviceType как строка в кавычках. Значение будет установлено только если оно поддерживается на целевой платформе. |
webGLClientBrowserType |
Браузер, который будет использоваться при запуске теста на платформе WebGL. Приемлемые типы браузеров:
|
webGLClientBrowserPath |
Абсолютный путь к расположению браузера на вашем устройстве. Если не определен, будет использоваться путь из переменной среды UNITY_AUTOMATION_DEFAULT_BROWSER_PATH. |
androidBuildAppBundle |
Логическое значение, позволяющее создавать пакет приложений Android (AAB) вместо пакета APK для тестов. |
featureFlags |
Карта строк и булевых значений, которые могут включать или выключать функции Unity Test Framework. В настоящее время поддерживаются следующие функции:
|