자습서: .NET CLI를 사용하여 .NET 전역 도구 설치 및 사용

이 문서는 .NET Core 2.1 SDK 이상 버전에 적용됩니다 ✔️.

튜토리얼에서는 전역 도구를 설치하고 사용하는 방법을 설명합니다. 이 시리즈의 첫 번째 자습서에서 만든 도구를 사용합니다.

필수 조건

.NET 10.0.100부터 다음을 사용하여 dnx영구 설치 없이 .NET 도구를 실행할 수 있습니다.

dnx(간소화된 구문)를 사용하여 도구를 직접 실행합니다.
```
dnx microsoft.botsay --add-source ./nupkg microsoft.botsay hello from the bot
```
이 매개 변수는 --add-source NuGet.org 도구를 사용할 수 없는 경우 .NET CLI에 ./nupkg 디렉터리를 NuGet 패키지에 대한 추가 소스 피드로 사용하도록 지시합니다.

자주 사용하기 위해 영구 설치를 선호하는 경우:

microsoft.botsay 프로젝트 폴더에서 dotnet tool install 명령을 실행하여 패키지에서 도구를 설치합니다.
```
dotnet tool install --global --add-source ./nupkg microsoft.botsay
```
매개 변수는 --global .NET CLI에 PATH 환경 변수에 자동으로 추가되는 기본 위치에 도구 이진 파일을 설치하도록 지시합니다.

매개 변수는 --add-source .NET CLI에 ./nupkg 디렉터리를 NuGet 패키지에 대한 추가 소스 피드로 일시적으로 사용하도록 지시합니다. 패키지에 고유한 이름을 지정하여 Nuget.org 사이트가 아닌 ./nupkg 디렉터리에서만 찾을 수 있도록 했습니다.

출력에는 도구를 호출하는 데 사용되는 명령과 설치된 버전이 표시됩니다.
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```
비고

기본적으로 설치할 .NET 이진 파일의 아키텍처는 현재 실행 중인 OS 아키텍처를 나타냅니다. 다른 OS 아키텍처를 지정하려면 dotnet 도구 설치, --arch 옵션을 참조하세요.
도구를 호출합니다.
```
botsay hello from the bot
```
비고

이 명령이 실패하면 PATH를 새로 고치려면 새 터미널을 열어야 할 수 있습니다.
dotnet tool uninstall 명령을 실행하여 도구를 제거합니다.
```
dotnet tool uninstall -g microsoft.botsay
```

도구를 호출합니다.

Windows에서:

c:\dotnet-tools\botsay hello from the bot

Linux 또는 macOS에서:

~/bin/botsay hello from the bot

dotnet tool uninstall 명령을 실행하여 도구를 제거합니다.

Windows에서:

dotnet tool uninstall --tool-path c:\dotnet-tools microsoft.botsay

Linux 또는 macOS에서:

dotnet tool uninstall --tool-path ~/bin microsoft.botsay

자습서를 수행하는 동안 오류 메시지가 표시되면 .NET 도구 사용 문제 해결을 참조하세요.

이 자습서에서는 도구를 설치한 후 전역 도구로 사용했습니다. 전역 도구를 설치하고 사용하는 방법에 대한 자세한 내용은 전역 도구 관리를 참조하세요. 로컬 도구와 동일한 도구를 설치하고 사용하려면 다음 자습서로 진행합니다.

이 페이지가 도움이 되었나요?