테스트 프레임워크 커맨드 라인 인자

이 섹션에는 Unity 테스트 프레임워크 커맨드 라인 인자가 나열되어 있습니다. 커맨드 라인에서 테스트를 실행하기 위한 예제 커맨드는 커맨드 라인에서 테스트 실행을 참조하십시오.

forgetProjectPath

현재 프로젝트를 Unity 런처/허브 이력에 저장하지 마십시오.

runTests

프로젝트에서 테스트를 실행합니다. 이 인수는 테스트를 실행하는 데 필요합니다.

testCategory

실행에 포함할 세미콜론으로 구분된 테스트 카테고리 리스트입니다. 세미콜론으로 구분된 리스트는 큰따옴표로 묶인 문자열 포맷이어야 합니다(예: testCategory "firstCategory;secondCategory"). testFilter와 testCategory를 둘 다 사용하는 경우 둘 다와 일치하는 테스트만 실행됩니다. 이 인수는 '!'를 사용하는 부정을 지원합니다. '!MyCategory'를 사용하는 경우 'MyCategory' 카테고리의 테스트는 실행에 포함되지 않습니다.

testFilter

실행할 테스트 이름 리스트(세미콜론으로 구분), 또는 전체 이름을 기준으로 테스트 매칭을 수행하는 정규식 표현식 패턴입니다. 세미콜론으로 구분된 리스트는 큰따옴표로 묶인 문자열 포맷이어야 합니다(예: testFilter "Low;Medium"). 이 인수는 '!'를 사용하는 부정을 지원합니다. '!MyNamespace.Something.MyTest' 테스트 필터를 사용하는 경우 해당 테스트를 제외한 모든 테스트가 실행됩니다. 다음과 같이 파라미터화 테스트의 특정 배리에이션을 실행할 수도 있습니다. "ClassName\.MethodName\(Param1,Param2\)"

testPlatform

테스트를 실행할 플랫폼입니다. 허용되는 값은 다음과 같습니다.

  • EditMode
    • 편집 모드 테스트입니다. Test Runner 창에서 Run Location > In Editor 옵션을 사용하고 EditMode 체크박스만 선택한 상태로 테스트를 실행하는 것과 동일합니다.
  • PlayMode
    • 에디터에서 실행되는 플레이 모드 테스트입니다. Test Runner 창에서 Run Location > In Editor 옵션을 사용하고 PlayMode 체크박스만 선택한 상태로 테스트를 실행하는 것과 동일합니다.
  • BuildTarget 열거형의 모든 값.
    • 특정 플랫폼용으로 빌드된 플레이어에서 실행되는 플레이 모드 테스트입니다. Test Runner 창에서 Run Location > On Player (<target_platform>) 옵션을 사용하는 것과 동일합니다.

참고: 이 인수에 대한 값이 지정되지 않으면 테스트는 편집 모드에서 실행됩니다.

requiresPlayMode

플레이 모드가 필요한 테스트를 실행할지 여부를 필터링합니다.

  • requiresPlayMode=true는 플레이 모드가 필요한 모든 테스트를 실행합니다.
  • requiresPlayMode=false는 플레이 모드가 필요하지 않는 모든 테스트를 실행합니다.
  • 파라미터를 지정하지 않으면 플레이 모드의 필요 여부에 관계없이 테스트를 실행합니다.

assemblyType

어셈블리 타입에 대한 테스트를 필터링합니다. EditorOnly 또는 EditorAndPlatforms입니다.

assemblyNames

실행에 포함할 테스트 어셈블리 리스트(세미콜론으로 구분)입니다. 세미콜론으로 구분된 리스트는 큰따옴표로 묶인 문자열 포맷이어야 합니다(예: assemblyNames "firstAssembly;secondAssembly").

testNames

필터 매칭에 사용되는 테스트의 전체 이름 리스트(세미콜론으로 구분)입니다. 일반적인 포맷은 FixtureName.TestName입니다. 테스트에 테스트 인수가 있으면 괄호로 묶습니다(예: MyTestClass2.MyTestWithMultipleValues(1)).

testResults

Unity가 결과 파일을 저장하는 경로입니다. 기본적으로 Unity는 프로젝트의 루트 폴더에 결과 파일을 저장합니다. 테스트 결과는 NUnit에 정의한 XML 포맷을 따릅니다. NUnit 문서를 참조하십시오. 현재 테스트 중인 개별 Unity 컴포넌트에서 보고하는 종료 코드에 대한 공통된 정의는 없습니다. 문제의 원인을 파악하는 가장 좋은 방법은 오류 메시지와 스택 추적의 내용을 확인하는 것입니다.

playerHeartbeatTimeout

플레이어에서 테스트 실행을 시작한 후 에디터가 하트비트를 기다리는 시간(초)입니다. 기본값은 10분입니다.

runSynchronously

이 인수를 포함하면 테스트를 동기식으로 실행하므로, 모든 테스트를 한 번의 에디터 업데이트 호출로 실행할 수 있습니다. EditMode 테스트에 대해서만 지원되며, 여러 프레임이 소요되는 테스트(예: [UnityTest] 테스트, 또는 [UnitySetUp] 또는 [UnityTearDown] 스캐폴딩이 포함된 테스트)는 필터링을 통해 제거됩니다.

buildPlayerPath

Unity가 테스트 폴더와 함께 빌드된 플레이어를 저장할 경로입니다. 기본적으로 프로젝트 경로 내에 임시 폴더를 생성합니다.

testSettingsFile

테스트 실행을 위한 추가 옵션을 설정할 수 있는 TestSettings.json 파일의 경로입니다. TestSettings.json 파일의 예제는 다음과 같은 모습입니다.

{
  "scriptingBackend":"WinRTDotNET",
  "Architecture":null,
  "apiProfile":0
}

apiProfile

.Net 호환성 레벨입니다. 다음 값 중 하나로 설정합니다.

  • 1 - .Net 2.0
  • 2 - .Net 2.0 하위 집합
  • 3 - .Net 4.6
  • 5 - .Net 마이크로 프로파일(Stripping Level이 Use micro mscorlib로 설정된 경우 Mono 스크립팅 백엔드에서 사용됨)
  • 6 - .Net Standard 2.0

appleEnableAutomaticSigning

Apple 기기의 자동 서명에 대한 옵션을 설정합니다.

appleDeveloperTeamID

Apple 개발자 계정의 팀 ID를 설정합니다.

architecture

Android용 타겟 아키텍처입니다. 다음 값 중 하나로 설정합니다.

  • 없음 = 0
  • ARMv7 = 1
  • ARM64 = 2
  • X86 = 4
  • 모두 = 4294967295

iOSManualProvisioningProfileType

다음 값 중 하나로 설정합니다.

  • 0 - 자동
  • 1 - 개발
  • 2 - 배포 iOSManualProvisioningProfileID

iOSTargetSDK

iOS용 타겟 SDK입니다. 다음 값 중 하나로 설정합니다. 단, 따옴표로 묶은 문자열 리터럴로 제공해야 합니다.

  • DeviceSDK
  • SimulatorSDK

tvOSTargetSDK

tvOS용 타겟 SDK입니다. 다음 값 중 하나로 설정합니다. 단, 따옴표로 묶은 문자열 리터럴로 제공해야 합니다.

  • DeviceSDK
  • SimulatorSDK

scriptingBackend

다음 값 중 하나로 설정합니다. 단, 따옴표로 묶은 문자열 리터럴로 제공해야 합니다.

  • Mono2x
  • IL2CPP
  • WinRTDotNET

playerGraphicsAPI

플레이어에서 테스트 실행 동안 사용되는 그래픽스 API를 설정합니다. 값은 따옴표로 묶인 문자열 리터럴인 GraphicsDeviceType일 수 있습니다. 값은 타겟 플랫폼에서 지원되는 경우에만 설정됩니다.

androidAppBundle

테스트를 위해 APK 대신 Android 앱 번들(AAB)을 빌드하도록 허용하는 부울 설정입니다.

orderedTestListFile

지정된 순서대로 실행할 전체 테스트 이름 리스트가 포함된 .txt 파일의 경로입니다. 테스트는 새 줄로 구분해야 하며, 파라미터가 있는 경우 파라미터도 지정해야 합니다. 파일 리스트는 다음과 같은 모습일 수 있습니다.

Unity.Framework.Tests.OrderedTests.NoParameters
Unity.Framework.Tests.OrderedTests.ParametrizedTestA(3,2)
Unity.Framework.Tests.OrderedTests.ParametrizedTestB(\"Assets/file.fbx\")
Unity.Framework.Tests.OrderedTests.ParametrizedTestC(System.String[],\"foo.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)