dotnet restore

  • 아티클
  • 읽는 데 9분 걸림

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

이름

dotnet restore - 프로젝트의 종속성 및 도구를 복원합니다.

개요

dotnet restore [<ROOT>] [--configfile <FILE>] [--disable-parallel]
    [-f|--force] [--force-evaluate] [--ignore-failed-sources]
    [--interactive] [--lock-file-path <LOCK_FILE_PATH>] [--locked-mode]
    [--no-cache] [--no-dependencies] [--packages <PACKAGES_DIRECTORY>]
    [-r|--runtime <RUNTIME_IDENTIFIER>] [-s|--source <SOURCE>]
    [--use-lock-file] [-v|--verbosity <LEVEL>]

dotnet restore -h|--help

설명

dotnet restore 명령은 NuGet을 사용하여 프로젝트 파일에 지정된 종속성 및 프로젝트 관련 도구를 복원합니다. 대부분의 경우 다음 명령을 실행할 때 필요한 경우 NuGet 복원이 암시적으로 실행되므로 dotnet restore 명령을 명시적으로 사용할 필요가 없습니다.

경우에 따라 이러한 명령으로 암시적 NuGet 복원을 실행하는 것이 불편할 수 있습니다. 예를 들어 빌드 시스템과 같은 자동화된 일부 시스템은 네트워크 사용량을 제어할 수 있도록 복원이 발생하는 경우를 제어하기 위해 명시적으로 dotnet restore를 호출해야 합니다. 암시적 NuGet 복원을 방지하기 위해 이러한 명령 중 하나와 함께 --no-restore 플래그를 사용하여 암시적 복원을 사용하지 않도록 설정할 수 있습니다.

피드 지정

종속성을 복원하려면 NuGet에 패키지가 있는 피드가 필요합니다. 피드는 일반적으로 nuget.config 구성 파일을 통해 제공됩니다. 기본 구성 파일은 .NET SDK가 설치될 때 제공됩니다. 추가 피드를 지정하려면 다음 중 하나를 수행합니다.

-s 옵션을 사용하여 nuget.config를 재정할 수 있습니다.

인증된 피드를 사용하는 방법에 대한 자세한 내용은 인증된 피드의 패키지 사용을 참조하세요.

글로벌 패키지 폴더

종속성의 경우 복원 작업 중 --packages 인수를 사용하여 복원된 패키지가 배치될 위치를 지정할 수 있습니다. 지정하지 않으면 모든 운영 체제에서 사용자의 홈 디렉터리의 .nuget/packages 디렉터리에 있는 기본 NuGet 패키지 캐시가 사용됩니다. 예를 들어 Linux의 경우 /home/user1 또는 Windows의 경우 C:\Users\user1입니다.

프로젝트별 도구

프로젝트 관련 도구의 경우 dotnet restore는 먼저 도구가 압축된 패키지를 복원한 다음 프로젝트 파일에 지정된 대로 도구의 종속성을 계속 복원합니다.

nuget 구성 차이점

dotnet restore 명령의 동작은 있는 경우 nuget.config 파일에 있는 일부 설정의 영향을 받습니다. 예를 들어 nuget.config의 globalPackagesFolder를 설정하면 복원된 NuGet 패키지가 지정한 폴더에 저장됩니다. dotnet restore 명령의 --packages 옵션을 지정하는 대신 이 방법을 사용할 수 있습니다. 자세한 내용은 nuget.config 참조를 참조하세요.

dotnet restore에서 무시하는 3가지 특정 설정은 다음과 같습니다.

  • bindingRedirects

    바인딩 리디렉션은 <PackageReference> 요소에서 작동하지 않으며 .NET에서는 NuGet 패키지의 <PackageReference> 요소만 지원합니다.

  • 솔루션

    이 설정은 Visual Studio에만 적용되며 .NET에는 적용되지 않습니다. .NET에서는 packages.config 파일을 사용하지 않고, 대신 NuGet 패키지의 <PackageReference> 요소를 사용합니다.

  • trustedSigners

    플랫폼 간 패키지 시그니처 확인을 위한 지원이 .NET 5.0.100 SDK에 추가되었습니다.

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

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

인수

  • ROOT

    프로젝트 파일을 복원하는 선택적 경로입니다.

옵션

  • --configfile <FILE>

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

  • --disable-parallel

    여러 프로젝트를 병렬로 복원을 사용하지 않도록 설정합니다.

  • --force

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

  • --force-evaluate

    잠금 파일이 이미 존재하는 경우에도 모든 종속성을 다시 평가하기 위해 복원합니다.

  • -?|-h|--help

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

  • --ignore-failed-sources

    버전 요구 사항을 충족하는 패키지가 있는 경우 실패한 소스에 대해서만 경고합니다.

  • --interactive

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

  • --lock-file-path <LOCK_FILE_PATH>

    프로젝트 잠금 파일이 작성되는 출력 위치입니다. 기본적으로 PROJECT_ROOT\packages.lock.json입니다.

  • --locked-mode

    프로젝트 잠금 파일 업데이트를 허용하지 않습니다.

  • --no-cache

    HTTP 요청을 캐시하지 않도록 지정합니다.

  • --no-dependencies

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

  • --packages <PACKAGES_DIRECTORY>

    복원된 패키지에 대한 디렉터리를 지정합니다.

  • -r|--runtime <RUNTIME_IDENTIFIER>

    패키지 복원의 런타임을 지정합니다. .csproj 파일의 <RuntimeIdentifiers> 태그에 명시적으로 나열되지 않은 런타임의 패키지를 복원하는 데 사용됩니다. RID(런타임 식별자) 목록은 RID 카탈로그를 참조하세요. 이 옵션을 여러 번 지정하여 여러 RID를 제공합니다.

  • -s|--source <SOURCE>

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

  • --use-lock-file

    복원에 사용되고 생성될 프로젝트 잠금 파일을 사용합니다.

  • -v|--verbosity <LEVEL>

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

예

  • 현재 디렉터리에 있는 프로젝트에 대한 종속성 및 도구를 복원합니다.

    dotnet restore

  • 지정된 경로에 있는 app1 프로젝트에 대한 종속성 및 도구를 복원합니다.

    dotnet restore ./projects/app1/app1.csproj

  • 소스로 제공된 파일 경로를 사용하여 현재 디렉터리에 있는 프로젝트에 대한 종속성 및 도구를 복원합니다.

    dotnet restore -s c:\packages\mypackages

  • 소스로 제공된 2개의 파일 경로를 사용하여 현재 디렉터리에 있는 프로젝트에 대한 종속성 및 도구를 복원합니다.

    dotnet restore -s c:\packages\mypackages -s c:\packages\myotherpackages

  • 자세한 출력을 표시하는 현재 디렉터리에 있는 프로젝트에 대한 종속성 및 도구를 복원합니다.

    dotnet restore --verbosity detailed