다음을 통해 공유

Microsoft.Testing.Platform CLI 옵션 참조

이 문서에서는 Microsoft.Testing.Platform 명령줄 옵션에 대한 중앙 진입점을 제공합니다.

플랫폼 옵션

  • @

    응답 파일의 이름을 지정합니다. 응답 파일 이름은 @ 바로 뒤에 와야 하며, @ 문자와 응답 파일 이름 사이에 공백이 없어야 합니다.

    응답 파일의 옵션은 명령줄의 해당 위치에 있는 것처럼 해석됩니다. 백슬래시 문자를 \ 사용하여 선을 연결할 수 없습니다. 응답 파일을 사용하면 터미널 제한을 초과할 수 있는 매우 긴 명령에 도움이 됩니다. 응답 파일을 인라인 명령줄 인수와 결합할 수 있습니다. 다음은 그 예입니다.

    ./TestExecutable.exe @"filter.rsp" --timeout 10s

    여기서 filter.rsp 다음 내용을 포함할 수 있습니다.

    --filter "A very long filter"

    또는 다음과 같이 단일 rsp 파일을 사용하여 시간 제한과 필터를 모두 지정할 수 있습니다.

    ./TestExecutable.exe @"arguments.rsp"

    --filter "A very long filter" --timeout 10s

    비고

    SDK 명령줄 파서는 응답 파일의 각 줄이 단일 토큰으로 처리되는 토큰별 접근 방식을 사용합니다 dotnet test. 이 경우 각 인수는 별도의 줄에 있어야 합니다.

    --filter
A very long filter
--timeout
10s

  • --config-file

    testconfig.json 파일을 지정합니다.

  • --diagnostic

    진단 로깅을 사용하도록 설정합니다. 기본 로그 수준은 Trace. 파일은 출력 디렉터리에 다음과 같은 이름 형식으로 작성됩니다. log_[MMddHHssfff].diag.

  • --diagnostic-synchronous-write

    기본 제공 파일 로거가 로그를 동기적으로 작성하도록 합니다. 로그 항목을 손실하지 않으려는 시나리오에 유용합니다(프로세스가 충돌하는 경우). 이렇게 하면 테스트 실행 속도가 느려집니다.

  • --diagnostic-output-directory

    진단 로깅의 출력 디렉터리(지정되지 않은 경우)는 기본 TestResults 디렉터리에 생성됩니다.

  • --diagnostic-file-prefix

    로그 파일 이름의 접두사입니다. 기본값은 "log"입니다.

  • --diagnostic-verbosity

    --diagnostic 스위치를 사용할 때 자세한 정보 표시 수준을 설정합니다. 사용 가능한 값은 Trace, Debug, Information, Warning, Error또는 Critical.

  • --exit-on-process-exit

    종속 프로세스가 종료되면 테스트 프로세스를 종료합니다. PID를 제공해야 합니다.

  • --help

    명령을 사용하는 방법에 대한 설명을 출력합니다.

  • --ignore-exit-code

    0이 아닌 일부 종료 코드를 무시하고 대신 0반환할 수 있습니다. 자세한 내용은 특정 종료 코드 무시를 참조하세요.

  • --info

    다음과 같은 .NET 테스트 애플리케이션에 대한 고급 정보를 표시합니다.

    • 플랫폼
    • 환경입니다.
    • 등록된 각 명령줄 공급자(예: name, version, description및 options).
    • 등록된 각 도구(예: command, name, version, description) 및 모든 명령줄 공급자

    이 기능은 동일한 명령줄 옵션을 등록하는 확장 또는 여러 버전의 확장(또는 플랫폼) 간에 사용 가능한 옵션의 변경 내용을 이해하는 데 사용됩니다.

  • --list-tests

    사용 가능한 테스트를 나열합니다. 테스트는 실행되지 않습니다.

  • --maximum-failed-tests

    도달하면 테스트 실행을 중지하는 최대 테스트 실패 수를 지정합니다. 이 스위치를 지원하려면 프레임워크 작성자가 IGracefulStopTestExecutionCapability 기능을 구현해야 합니다. 테스트 실패의 양에 도달할 때 종료 코드는 13입니다. 자세한 내용은 microsoft.Testing.Platform 종료 코드 참조하세요.

    비고

    이 기능은 버전 1.5부터 Microsoft.Testing.Platform에서 사용할 수 있습니다.

  • --minimum-expected-tests

    실행될 것으로 예상되는 최소 테스트 수를 지정합니다. 기본적으로 하나 이상의 테스트가 실행되어야 합니다.

  • --results-directory

    테스트 결과를 배치할 디렉터리입니다. 지정된 디렉터리가 없으면 생성됩니다. 기본값은 테스트 애플리케이션을 포함하는 디렉터리에 TestResults.

  • --timeout

    글로벌 테스트 실행 타임아웃입니다. 하나의 인수를 <value>[h|m|s] 형식의 문자열로 사용하며, 여기서 <value>은 부동 소수점 숫자입니다.

시나리오별 확장 옵션

확장 옵션을 빠르게 찾으려면 다음 표를 사용합니다.

시나리오 기능 설명서
코드 커버리지 수집 코드 검사
크래시 또는 응답 중지 덤프 수집 크래시 및 멈춤 덤프
테스트 보고서 생성(예: TRX) 테스트 보고서
터미널 출력 사용자 지정 터미널 출력
호스팅 수준 컨트롤 적용 Hot Reload
실패한 테스트 다시 시도 재시도
Microsoft Fakes를 사용하는 테스트 실행 Microsoft Fakes
OpenTelemetry 추적 및 메트릭 내보내기 OpenTelemetry

테스트 앱에서 옵션 검색

테스트 실행 파일을 --help 실행하여 현재 확장 집합에 사용할 수 있는 옵션을 나열합니다.

등록된 공급자 및 옵션에 대한 고급 진단의 경우 다음을 실행합니다 --info.

참고하십시오

  • Last updated on