dotnet tool install

  • 아티클

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

이름

dotnet tool install - 머신에 지정된 .NET 도구를 설치합니다.

개요

dotnet tool install <PACKAGE_NAME> -g|--global
    [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

설명

dotnet tool install 명령은 머신에 .NET 도구를 설치하는 방법을 제공합니다. 이 명령을 사용하려면 다음 설치 옵션 중 하나를 지정합니다.

  • 전역 도구를 기본 위치에 설치하려면 --global 옵션을 사용합니다.
  • 사용자 지정 위치에 전역 도구를 설치하려면 옵션을 사용합니다 --tool-path .
  • 로컬 도구를 설치하려면 --global 및 --tool-path 옵션을 생략합니다.

설치 위치

전역 도구

-g 또는 --global 옵션을 지정하면 전역 도구는 기본적으로 다음 디렉터리에 설치됩니다.

OS 경로
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

실행 파일은 전역적으로 설치된 각 도구에 대해 이러한 폴더에 생성되지만 실제 도구 이진 파일은 형제 .store 디렉터리 깊숙이 중첩됩니다.

--tool-path 도구

명시적 도구 경로가 있는 로컬 도구는 가리킬 매개 변수를 --tool-path 지정한 위치에 저장됩니다. 전역 도구와 동일한 방식으로 저장됩니다. 형제 .store 디렉터리에 실제 이진 파일이 있는 실행 파일 이진 파일입니다.

로컬 도구

로컬 도구는 설정한 대로 NuGet 전역 디렉터리에 저장됩니다. 각 로컬 도구에 $HOME/.dotnet/toolResolverCache 대해 도구가 해당 위치 내에 있는 위치를 가리키는 shim 파일이 있습니다.

로컬 도구에 대한 참조는 현재 디렉터리 아래의 .config 디렉터리에 있는 dotnet-tools.json 파일에 추가됩니다. 매니페스트 파일이 아직 없는 경우 옵션을 사용 --create-manifest-if-needed 하거나 다음 명령을 실행하여 만듭니다.

dotnet new tool-manifest

자세한 내용은 로컬 도구 설치를 참조하세요.

인수

  • PACKAGE_NAME

    설치할 .NET 도구를 포함하는 NuGet 패키지의 이름/ID입니다.

옵션

  • -a|--arch <ARCHITECTURE>

    대상 아키텍처를 지정합니다. 이는 제공된 값이 기본 RID와 결합되는 RID(런타임 식별자)를 설정하는 약식 구문입니다. 예를 들어, win-x64 머신에서 --arch x86을 지정하면 RID가 win-x86으로 설정됩니다.

  • --add-source <SOURCE>

    설치 중에 사용할 추가 NuGet 패키지 원본을 추가합니다. 피드는 우선 순위에 따라 순차적으로 액세스하는 것이 아니라 병렬로 액세스합니다. 동일한 패키지와 버전이 여러 피드에 있는 경우 가장 빠른 피드가 적용됩니다. 자세한 내용은 NuGet 패키지를 설치하면 어떻게 되나요?를 참조하세요.

  • --configfile <FILE>

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

  • --create-manifest-if-needed

    로컬 도구에 적용됩니다. 매니페스트를 찾기 위해 검색 알고리즘은 디렉터리 트리 dotnet-tools.json 또는 파일이 포함된 폴더를 .configdotnet-tools.json 검색합니다.

    도구 매니페스트를 찾을 --create-manifest-if-needed 수 없고 옵션이 false CannotFindAManifestFile 로 설정된 경우 오류가 발생합니다.

    도구 매니페스트를 찾을 --create-manifest-if-needed 수 없고 옵션이 true로 설정된 경우 도구는 자동으로 매니페스트를 만듭니다. 다음과 같이 매니페스트의 폴더를 선택합니다.

    • 하위 폴더가 있는 디렉터리를 검색하는 디렉터리 트리를 .git 안내합니다. 매니페스트가 발견되면 해당 디렉터리에 매니페스트를 만듭니다.
    • 이전 단계에서 디렉터리를 찾을 수 없는 경우 파일이 있는 디렉터리를 검색하는 디렉터리 트리를 .sln/git 안내합니다. 매니페스트가 발견되면 해당 디렉터리에 매니페스트를 만듭니다.
    • 이전 두 단계 중 어느 단계도 디렉터리를 찾지 못하면 현재 작업 디렉터리에 매니페스트를 만듭니다.

  • --disable-parallel

    여러 프로젝트를 병렬로 복원하지 않습니다.

  • --framework <FRAMEWORK>

    도구를 설치할 대상 프레임워크를 지정합니다. 기본적으로 .NET SDK는 가장 적합한 대상 프레임워크를 선택하려고 합니다.

  • -g|--global

    사용자 전체 설치임을 지정합니다. --tool-path 옵션과 함께 사용할 수 없습니다. --global 및 --tool-path 옵션을 모두 생략하면 로컬 도구 설치가 지정됩니다.

  • -?|-h|--help

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

  • --ignore-failed-sources

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

  • --interactive

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

  • --local

    도구 및 로컬 도구 매니페스트를 업데이트합니다. --global 옵션 또는 --tool-path 옵션과 함께 사용할 수 없습니다.

  • --no-cache

    패키지 및 HTTP 요청을 캐시하지 않습니다.

  • --prerelease

    시험판 패키지를 포함합니다.

  • --tool-manifest <PATH>

    매니페스트 파일 경로입니다.

  • --tool-path <PATH>

    전역 도구를 설치할 위치를 지정합니다. 경로는 절대 또는 상대 경로일 수 있습니다. 경로가 존재하지 않는 경우 이 명령은 해당 경로를 만들려고 합니다. --global 및 --tool-path 옵션을 모두 생략하면 로컬 도구 설치가 지정됩니다.

  • -v|--verbosity <LEVEL>

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

  • --version <VERSION_NUMBER>

    설치할 도구의 버전입니다. 기본적으로 안정적인 최신 버전이 설치됩니다. 도구의 미리 보기 또는 이전 버전을 설치할 경우 이 옵션을 사용합니다.

예

  • dotnet tool install -g dotnetsay

    dotnetsay를 기본 위치에 전역 도구로 설치합니다.

  • dotnet tool install dotnetsay --tool-path c:\global-tools

    dotnetsay를 특정 Windows 디렉터리에 전역 도구로 설치합니다.

  • dotnet tool install dotnetsay --tool-path ~/bin

    dotnetsay를 특정 Linux/macOS 디렉터리에 전역 도구로 설치합니다.

  • dotnet tool install -g dotnetsay --version 2.0.0

    dotnetsay의 버전 2.0.0을 전역 도구로 설치합니다.

  • dotnet tool install dotnetsay

    dotnetsay를 현재 디렉터리용 로컬 도구로 설치합니다.

참조