dotnet run

  • 아티클

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

이름

dotnet run - 명시적 컴파일이나 시작 명령을 사용하지 않고 소스 코드를 실행합니다.

개요

dotnet run [-a|--arch <ARCHITECTURE>] [-c|--configuration <CONFIGURATION>]
    [-f|--framework <FRAMEWORK>] [--force] [--interactive]
    [--launch-profile <NAME>] [--no-build]
    [--no-dependencies] [--no-launch-profile] [--no-restore]
    [--os <OS>] [--project <PATH>] [-r|--runtime <RUNTIME_IDENTIFIER>]
    [--tl:[auto|on|off]] [-v|--verbosity <LEVEL>]
    [[--] [application arguments]]

dotnet run -h|--help

설명

dotnet run 명령은 하나의 명령을 사용하여 소스 코드에서 애플리케이션을 실행하는 편리한 옵션을 제공합니다. 명령줄에서 빠른 반복 개발에 유용합니다. 이 명령은 코드 빌드 시 dotnet build 명령에 의존합니다. 프로젝트를 먼저 복원해야 하는 등, 빌드에 대한 요구 사항은 dotnet run에도 적용됩니다.

참고 항목

dotnet run은 dotnet build에서는 반영하는 /property:property=value와 같은 인수를 적용하지 않습니다.

출력 파일은 기본 위치, 즉 bin/<configuration>/<target>에 기록됩니다. 예를 들어 netcoreapp2.1 애플리케이션이 있고 dotnet run을 실행하는 경우 출력은 bin/Debug/netcoreapp2.1에 추가됩니다. 필요에 따라 파일을 덮어씁니다. 임시 파일은 obj 디렉터리에 놓입니다.

프로젝트가 여러 프레임워크를 지정하는 경우 프레임워크를 지정하는 데 -f|--framework <FRAMEWORK> 옵션을 사용하지 않은 한, dotnet run을 실행하면 오류가 발생합니다.

dotnet run 명령은 빌드된 어셈블리가 아닌 프로젝트의 컨텍스트에서 사용됩니다. 대신 프레임워크 종속 애플리케이션 DLL을 실행하려고 하는 경우 명령 없이 dotnet을 사용해야 합니다. 예를 들어 myapp.dll을 실행하려면 다음을 사용합니다.

dotnet myapp.dll

dotnet 드라이버에 대한 자세한 내용은 .NET 명령줄 도구(CLI) 항목을 참조하세요.

애플리케이션을 실행하기 위해 dotnet run 명령은 NuGet 캐시에서 공유 런타임의 외부에 있는 애플리케이션의 종속성을 확인합니다. 캐시된 종속성을 사용하기 때문에 프로덕션 환경에서 애플리케이션을 실행하는 데 dotnet run을 사용하는 것은 바람직하지 않습니다. 대신, dotnet publish 명령을 사용하여 배포를 만들고 게시된 출력을 배포합니다.

암시적 복원

dotnet new, dotnet build, dotnet run, dotnet test, dotnet publish 및 dotnet pack 등 복원이 필요한 모든 명령에 의해 암시적으로 실행되므로 dotnet restore를 실행할 필요가 없습니다. 암시적 복원을 사용하지 않으려면 --no-restore 옵션을 사용합니다.

dotnet restore 명령은 Azure DevOps Services의 연속 통합 빌드 또는 복원 발생 시점을 명시적으로 제어해야 하는 빌드 시스템과 같이 명시적으로 복원이 가능한 특정 시나리오에서 여전히 유용합니다.

NuGet 피드를 관리하는 방법에 대한 자세한 내용은 dotnet restore 설명서를 참조하세요.

이 명령은 긴 형식(예: --source)으로 전달될 때 dotnet restore 옵션을 지원합니다. -s와 같이 짧은 형식의 옵션은 지원되지 않습니다.

워크로드 매니페스트 다운로드

이 명령을 실행하면 워크로드에 대한 광고 매니페스트의 비동기 백그라운드 다운로드가 시작됩니다. 이 명령이 완료될 때 다운로드가 계속 실행되면 다운로드가 중지됩니다. 자세한 내용은 광고 매니페스트를 참조하세요.

옵션

  • --

    실행 중인 애플리케이션에 대한 인수에서 dotnet run에 대한 인수를 구분합니다. 이 구분 기호 다음의 모든 인수가 실행 중인 애플리케이션에 전달됩니다.

  • -a|--arch <ARCHITECTURE>

    대상 아키텍처를 지정합니다. 이는 제공된 값이 기본 RID와 결합되는 RID(런타임 식별자)를 설정하는 약식 구문입니다. 예를 들어, win-x64 머신에서 --arch x86을 지정하면 RID가 win-x86으로 설정됩니다. 이 옵션을 사용하는 경우 -r|--runtime 옵션을 사용하지 마세요. .NET 6 미리 보기 7 이후 사용 가능합니다.

  • -c|--configuration <CONFIGURATION>

    빌드 구성을 정의합니다. 대부분의 프로젝트에 대한 기본값은 Debug이지만 프로젝트의 빌드 구성 설정을 재정의할 수 있습니다.

  • -f|--framework <FRAMEWORK>

    지정된 프레임워크를 사용하여 앱을 빌드하고 실행합니다. 프레임워크는 프로젝트 파일에 지정되어야 합니다.

  • --force

    마지막 복원이 성공한 경우에도 모든 종속성을 강제 확인합니다. 이 플래그를 지정하는 것은 project.assets.json 파일을 삭제하는 것과 같습니다.

  • -?|-h|--help

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

  • --interactive

    명령이 중지되고 사용자 입력 또는 작업을 대기할 수 있도록 허용합니다. 예를 들어 인증을 완료합니다. .NET Core 3.0 SDK 이후 사용할 수 있습니다.

  • --launch-profile <NAME>

    애플리케이션을 시작할 때 사용할 시작 프로필(있는 경우)의 이름입니다. 시작 프로필은 launchSettings.json 파일에서 정의되고 일반적으로 Development, Staging 및 Production이라고 합니다. 자세한 내용은 여러 환경 사용을 참조하세요.

  • --no-build

    실행하기 전에 프로젝트를 빌드하지 않습니다. 또한 --no-restore 플래그를 암시적으로 설정합니다.

  • --no-dependencies

    프로젝트 간(P2P) 참조를 사용하여 프로젝트를 복원할 경우 참조가 아닌 루트 프로젝트를 복원하세요.

  • --no-launch-profile

    애플리케이션을 구성하는 데 launchSettings.json을 사용하지 않습니다.

  • --no-restore

    명령을 실행할 때 암시적 복원을 실행하지 않습니다.

  • --os <OS>

    대상 운영 체제(OS)를 지정합니다. 이는 제공된 값이 기본 RID와 결합되는 RID(런타임 식별자)를 설정하는 약식 구문입니다. 예를 들어, win-x64 머신에서 --os linux을 지정하면 RID가 linux-x64으로 설정됩니다. 이 옵션을 사용하는 경우 -r|--runtime 옵션을 사용하지 마세요. .NET 6부터 사용할 수 있습니다.

  • --project <PATH>

    실행할 프로젝트 파일의 경로를 지정합니다(폴더 이름 또는 전체 경로). 지정하지 않으면 현재 디렉터리로 기본 설정됩니다.

    .NET 6 SDK부터 --project에 대한 -p 약어가 사용되지 않습니다. .NET 6 RC1 SDK부터 제한된 시간 동안은 사용 중단 경고에도 불구하고 --project에 대해 -p를 사용할 수 있습니다. 옵션에 대해 제공된 인수에 =이 포함되지 않은 경우 명령은 -p를 --project의 약어로 수락합니다. 포함된 경우 명령은 -p를 --property의 약어로 가정합니다. --project에 대해 -p를 유연하게 사용하는 기능은 .NET 7에서 단계적으로 사용이 중단됩니다.

  • --property:<NAME>=<VALUE>

    하나 이상의 MSBuild 속성을 설정합니다. 세미콜론을 사용하거나 옵션을 반복하여 구분된 여러 속성을 지정합니다.

    --property:<NAME1>=<VALUE1>;<NAME2>=<VALUE2>
--property:<NAME1>=<VALUE1> --property:<NAME2>=<VALUE2>

    약식 -p는 --property 대신 사용할 수 있습니다. 옵션에 대해 제공된 인수에 =이 포함된 경우 -p는 --property의 약어로 수락됩니다. 포함된 경우 명령은 -p를 --project의 약어로 가정합니다.

    MSBuild 속성을 설정하는 대신 애플리케이션에 --property를 전달하려면 -- 구문 구분 기호 뒤에 옵션을 제공합니다. 예를 들면 다음과 같습니다.

    dotnet run -- --property name=value

  • -r|--runtime <RUNTIME_IDENTIFIER>

    패키지를 복원할 대상 런타임을 지정합니다. RID(런타임 식별자) 목록은 RID 카탈로그를 참조하세요.

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

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

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

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

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

  • -v|--verbosity <LEVEL>

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

예제

  • 현재 디렉터리에 있는 프로젝트를 실행합니다.

    dotnet run

  • 지정된 프로젝트를 실행합니다.

    dotnet run --project ./projects/proj1/proj1.csproj

  • 현재 디렉터리에서 프로젝트를 실행하여 릴리스 구성을 지정합니다.

    dotnet run --property:Configuration=Release

  • 현재 디렉터리에 있는 프로젝트를 실행합니다. 비어 있는 -- 옵션을 사용하므로 이 예제의 --help 인수는 애플리케이션에 전달됩니다.

    dotnet run --configuration Release -- --help

  • 최소 출력만 표시하는 현재 디렉터리의 프로젝트에 대한 종속성 및 도구를 복원한 다음, 프로젝트를 실행합니다.

    dotnet run --verbosity m