dotnet workload install

  • 아티클

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

이름

dotnet workload install - 선택적 워크로드를 설치합니다.

개요

dotnet workload install <WORKLOAD_ID>...
    [--configfile <FILE>] [--disable-parallel]
    [--ignore-failed-sources] [--include-previews] [--interactive]
    [--no-cache] [--skip-manifest-update]
    [--source <SOURCE>] [--temp-dir <PATH>] [-v|--verbosity <LEVEL>]

dotnet workload install -?|-h|--help

설명

dotnet workload install 명령은 하나 이상의 ‘선택적 워크로드’를 설치합니다. 선택적 워크로드는 .NET SDK 위에 설치하여 .NET MAUI 및 Blazor WebAssembly AOT와 같은 다양한 애플리케이션 유형에 대한 지원을 제공할 수 있습니다.

어떤 워크로드를 설치할 수 있는지 알아보려면 dotnet workload search를 사용하세요.

관리자 권한으로 실행해야 하는 경우

보호된 디렉터리에 설치된 macOS 및 Linux SDK 설치의 경우 관리자 권한으로 명령을 실행해야 합니다(sudo 명령 사용). Windows에서 SDK가 Program Files 디렉터리에 설치된 경우에도 관리자 권한으로 명령을 실행할 필요가 없습니다. Windows의 경우 명령은 해당 위치에 대한 MSI 설치 프로그램을 사용합니다.

SDK 버전에 따라 결과가 달라집니다.

dotnet workload 명령은 특정 SDK 버전의 컨텍스트에서 작동합니다. .NET 6.0.100 SDK 및 .NET 6.0.200 SDK가 모두 설치되어 있다고 가정합니다. dotnet workload 명령은 선택한 SDK 버전에 따라 다른 결과를 제공합니다. 이 동작은 패치 버전의 차이점이 아니라 주 버전과 부 버전 및 기능 밴드 차이점에 적용됩니다. 예를 들어 .NET SDK 6.0.101 및 6.0.102는 동일한 결과를 제공하는 반면 6.0.100 및 6.0.200은 다른 결과를 제공합니다. global.json 파일을 사용하여 SDK 버전을 지정할 수 있습니다.

광고 매니페스트

워크로드 설치에 필요한 자산의 이름과 버전은 ‘매니페스트’에서 유지 관리됩니다. 기본적으로 dotnet workload install 명령은 워크로드를 설치하기 전에 사용 가능한 최신 매니페스트를 다운로드합니다. 그런 다음, 매니페스트의 로컬 복사본은 워크로드에 대한 자산을 찾아서 다운로드하는 데 필요한 정보를 제공합니다.

dotnet workload list 명령은 설치된 워크로드의 버전을 현재 사용할 수 있는 버전과 비교합니다. 설치된 버전보다 최신 버전을 사용할 수 있다는 것을 발견하면 명령 출력에서 해당 사실을 알립니다. dotnet workload list의 최신 버전 알림은 .NET 6부터 사용할 수 있습니다.

최신 버전 알림을 사용하도록 설정하기 위해, 사용 가능한 최신 버전의 매니페스트가 ‘광고 매니페스트’로 다운로드 및 저장됩니다. 다음 명령이 실행될 때 백그라운드에서 비동기적으로 다운로드가 수행됩니다.

매니페스트 다운로드가 완료되기 전에 명령이 완료되면 다운로드가 중지됩니다. 다음번에 이러한 명령 중 하나를 실행하면 다운로드가 다시 시도됩니다. 백그라운드 다운로드를 사용하지 않도록 설정하거나 빈도를 제어하도록 환경 변수를 설정할 수 있습니다. 기본적으로 하루에 한 번 넘게 발생하지 않습니다.

--skip-manifest-update 옵션을 사용하여 dotnet workload install 명령이 매니페스트 다운로드를 수행하는 것을 방지할 수 있습니다.

dotnet workload update 명령은 또한 광고 매니페스트를 다운로드합니다. 업데이트를 사용할 수 있는지 확인하려면 다운로드가 필요하므로, 업데이트 실행을 방지할 수 있는 옵션이 없습니다. 그러나 --advertising-manifests-only 옵션을 사용하여 워크로드 업데이트를 건너뛰고 매니페스트 다운로드만 수행할 수 있습니다. 이 옵션은 .NET 6부터 사용할 수 있습니다.

인수

  • WORKLOAD_ID...

    설치할 워크로드 ID 또는 여러 ID입니다. 어떤 워크로드를 사용할 수 있는지 알아보려면 dotnet workload search를 사용하세요.

옵션

  • --configfile <FILE>

    사용할 NuGet 구성 파일(nuget.config)입니다. 지정된 경우 이 파일의 설정만 사용됩니다. 지정되지 않으면 현재 디렉터리의 구성 파일의 계층 구조가 사용됩니다. 자세한 내용은 일반적인 NuGet 구성을 참조하세요.

  • --disable-parallel

    여러 프로젝트를 병렬로 복원하는 것을 방지합니다.

  • -?|-h|--help

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

  • --ignore-failed-sources

    패키지 소스 오류를 경고로 처리합니다.

  • --include-previews

    시험판 워크로드 매니페스트를 허용합니다.

  • --interactive

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

  • --no-cache

    패키지 및 http 요청의 캐시를 방지합니다.

  • --skip-manifest-update

    워크로드 매니페스트 업데이트를 건너뜁니다. 워크로드 매니페스트는 각 워크로드에 대해 설치해야 하는 자산 및 버전을 정의합니다.

  • -s|--source <SOURCE>

    사용할 NuGet 패키지 소스의 URI를 지정합니다. 이 설정은 nuget.config 파일에 지정된 모든 소스를 재정의합니다. 이 옵션을 여러 번 지정하여 여러 소스를 제공할 수 있습니다.

  • --temp-dir <PATH>

    NuGet 패키지를 다운로드하고 추출하는 데 사용되는 임시 디렉터리를 지정합니다(안전해야 함).

  • -v|--verbosity <LEVEL>

    명령의 세부 정보 표시 수준을 설정합니다. 허용되는 값은 q[uiet], m[inimal], n[ormal], d[etailed], diag[nostic]입니다. 기본값은 minimal입니다. detailed 또는 diagnostic 세부 정보 표시를 지정하면, 명령은 다운로드하는 Nuget 패키지에 대한 정보를 표시합니다.

예제

  • maui 워크로드를 설치합니다.

    dotnet workload install maui

  • maui-android 및 maui-ios 워크로드를 설치합니다.

    dotnet workload install maui-android maui-ios