다음을 통해 공유

dotnet 클린 명령

이 문서의 적용 대상: ✔️ .NET 6 SDK 이상 버전

이름

dotnet clean - 프로젝트의 출력을 정리합니다.

개요

dotnet clean [<PROJECT>|<SOLUTION>|<FILE>] [--artifacts-path <ARTIFACTS_DIR>]
    [-c|--configuration <CONFIGURATION>]
    [-f|--framework <FRAMEWORK>] [--interactive]
    [--nologo] [-o|--output <OUTPUT_DIRECTORY>]
    [-r|--runtime <RUNTIME_IDENTIFIER>] [--tl:[auto|on|off]]
    [-v|--verbosity <LEVEL>]

dotnet clean -h|--help

Description

이 dotnet clean 명령은 이전 빌드의 출력을 정리합니다. MSBuild 대상으로 구현되므로 명령이 실행될 때 프로젝트가 평가됩니다. 빌드 중에 생성된 출력만 정리됩니다. 중간(obj) 및 최종 출력(bin) 폴더가 모두 정리됩니다.

Arguments

PROJECT | SOLUTION | FILE

작업할 프로젝트 또는 솔루션 또는 C#(파일 기반 앱) 파일입니다. 파일이 지정되지 않은 경우 MSBuild는 현재 디렉터리에서 프로젝트 또는 솔루션을 검색합니다.

  • PROJECT C#, F#또는 Visual Basic 프로젝트 파일의 경로 및 파일 이름 또는 C#, F# 또는 Visual Basic 프로젝트 파일이 포함된 디렉터리의 경로입니다.

  • SOLUTION 솔루션 파일의 경로 및 파일 이름(.sln 또는 .slnx 확장명) 또는 솔루션 파일이 포함된 디렉터리의 경로입니다.

  • FILE 는 .NET 10에 추가된 인수입니다. 파일 기반 앱의 경로 및 파일 이름입니다. 파일 기반 앱은 해당 프로젝트(.csproj) 파일 없이 빌드되고 실행되는 단일 파일 내에 포함됩니다. 자세한 내용은 파일 기반 C# 앱 빌드를 참조하세요.

Options

  • --artifacts-path <ARTIFACTS_DIR>

    실행된 명령의 모든 빌드 출력 파일은 지정된 경로 아래의 하위 폴더에서 프로젝트로 구분됩니다. 자세한 내용은 아티팩트 출력 레이아웃을 참조하세요. .NET 8 SDK부터 사용할 수 있습니다.

  • -c|--configuration <CONFIGURATION>

    빌드 구성을 정의합니다. 대부분의 프로젝트의 기본값은 />이지만 프로젝트에서 빌드 구성 설정을 재정의할 수 있습니다. 이 옵션은 빌드 시간 동안 지정한 경우에만 정리해야 합니다.

  • -f|--framework <FRAMEWORK>

    빌드 시 지정된 프레임워크 입니다. 프레임워크는 프로젝트 파일에 정의되어야 합니다. 빌드 시 프레임워크를 지정한 경우 정리할 때 프레임워크를 지정해야 합니다.

  • -?|-h|--help

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

  • --interactive

    명령을 중지하고 사용자 입력 또는 작업을 기다릴 수 있습니다. 예를 들어 인증을 완료합니다.

  • --nologo

    시작 배너 또는 저작권 메시지를 표시하지 않습니다.

  • -o|--output <OUTPUT_DIRECTORY>

    정리할 빌드 아티팩트가 포함된 디렉터리입니다. -f|--framework <FRAMEWORK> 프로젝트를 빌드할 때 프레임워크를 지정한 경우 출력 디렉터리 스위치를 사용하여 스위치를 지정합니다.

    • .NET 7.0.200 SDK 이상

      솔루션에서 --output 이 명령을 실행할 때 옵션을 지정하면 CLI는 출력 경로의 의미 체계가 명확하지 않아 경고(7.0.200의 오류)를 내보냅니다. 모든 빌드된 프로젝트의 모든 출력이 다중 대상 프로젝트와 호환되지 않는 지정된 디렉터리에 복사되고 서로 다른 버전의 직접 및 전이적 종속성이 있는 프로젝트로 복사되므로 이 --output 옵션은 허용되지 않습니다. 자세한 내용은 빌드 관련 명령에 더 이상 유효하지 않은 솔루션 수준 --output 옵션을 참조하세요.

  • -r|--runtime <RUNTIME_IDENTIFIER>

    지정된 런타임의 출력 폴더를 정리합니다. 자체 포함 배포 를 만들 때 사용됩니다.

  • --tl:[auto|on|off]

    빌드 출력에 터미널 로거 를 사용할지 여부를 지정합니다. 기본값은 auto터미널 로깅을 사용하도록 설정하기 전에 먼저 환경을 확인하는 것입니다. 환경 검사는 터미널이 최신 출력 기능을 사용할 수 있고 새 로거를 사용하도록 설정하기 전에 리디렉션된 표준 출력을 사용하지 않는지 확인합니다. on 환경 검사를 건너뛰고 터미널 로깅을 사용하도록 설정합니다. off 환경 검사를 건너뛰고 기본 콘솔 로거를 사용합니다.

    터미널 로거는 복원 단계와 빌드 단계를 보여줍니다. 각 단계에서 현재 빌드 프로젝트는 터미널 아래쪽에 표시됩니다. 빌드 중인 각 프로젝트는 현재 빌드 중인 MSBuild 대상과 해당 대상에 소요된 시간을 모두 출력합니다. 이 정보를 검색하여 빌드에 대해 자세히 알아볼 수 있습니다. 프로젝트 빌드가 완료되면 다음을 캡처하는 단일 "빌드 완료" 섹션이 작성됩니다.

    • 빌드된 프로젝트의 이름입니다.
    • 대상 프레임워크(다중 대상인 경우)입니다.
    • 해당 빌드의 상태입니다.
    • 해당 빌드의 기본 출력(하이퍼링크)입니다.
    • 해당 프로젝트에 대해 생성된 모든 진단입니다.

    이 옵션은 .NET 8부터 사용할 수 있습니다.

  • -v|--verbosity <LEVEL>

    명령의 세부 정보 표시 수준을 설정합니다. 허용되는 값은 q[uiet], m[inimal], n[ormal], d[etailed], diag[nostic]입니다. 기본값은 normal입니다. 자세한 내용은 LoggerVerbosity를 참조하세요.

예시

  • 프로젝트의 기본 빌드를 정리합니다.

    dotnet clean

  • 파일 기반 프로그램을 정리합니다.

    dotnet clean Program.cs.

    파일 기반 앱 지원이 .NET SDK 10.0.100에 추가되었습니다.

  • 릴리스 구성을 사용하여 빌드된 프로젝트를 정리합니다.

    dotnet clean --configuration Release
  • Last updated on