Samouczek: instalowanie i używanie narzędzia globalnego platformy .NET przy użyciu interfejsu wiersza polecenia platformy .NET

Artykuł
07/27/2023

Ten artykuł dotyczy: ✔️ zestaw .NET Core 2.1 SDK i nowsze wersje

W tym samouczku przedstawiono sposób instalowania i używania narzędzia globalnego. Użyjesz narzędzia utworzonego w pierwszym samouczku tej serii.

Wymagania wstępne

Ukończ pierwszy samouczek tej serii.

Używanie narzędzia jako narzędzia globalnego

Zainstaluj narzędzie z pakietu, uruchamiając polecenie dotnet tool install w folderze projektu microsoft.botsay :
```
dotnet tool install --global --add-source ./nupkg microsoft.botsay
```
Parametr --global informuje interfejs wiersza polecenia platformy .NET o zainstalowaniu plików binarnych narzędzi w domyślnej lokalizacji, która jest automatycznie dodawana do zmiennej środowiskowej PATH.

Parametr --add-source informuje interfejs wiersza polecenia platformy .NET, aby tymczasowo użyć katalogu ./nupkg jako dodatkowego źródła źródła dla pakietów NuGet. Nadaliśmy pakietowi unikatową nazwę, aby upewnić się, że zostanie ona znaleziona tylko w katalogu ./nupkg , a nie w witrynie Nuget.org.

Dane wyjściowe pokazują polecenie użyte do wywołania narzędzia i zainstalowanej wersji:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```
Uwaga

Domyślnie architektura plików binarnych platformy .NET do zainstalowania reprezentuje obecnie uruchomioną architekturę systemu operacyjnego. Aby określić inną architekturę systemu operacyjnego, zobacz dotnet tool install, --arch option (Instalacja narzędzia dotnet, --arch).
Wywołaj narzędzie:
```
botsay hello from the bot
```
Uwaga

Jeśli to polecenie zakończy się niepowodzeniem, może być konieczne otwarcie nowego terminalu w celu odświeżenia ścieżki.
Usuń narzędzie, uruchamiając polecenie odinstalowywania narzędzia dotnet :
```
dotnet tool uninstall -g microsoft.botsay
```

Użyj narzędzia jako narzędzia globalnego zainstalowanego w lokalizacji niestandardowej

Zainstaluj narzędzie z pakietu.

W systemie Windows:
```
dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg microsoft.botsay
```
W systemie Linux lub macOS:
```
dotnet tool install --tool-path ~/bin --add-source ./nupkg microsoft.botsay
```
Parametr --tool-path informuje interfejs wiersza polecenia platformy .NET o zainstalowaniu plików binarnych narzędzi w określonej lokalizacji. Jeśli katalog nie istnieje, zostanie utworzony. Ten katalog nie jest automatycznie dodawany do zmiennej środowiskowej PATH.

Dane wyjściowe pokazują polecenie użyte do wywołania narzędzia i zainstalowanej wersji:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```

Wywołaj narzędzie:

W systemie Windows:

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

W systemie Linux lub macOS:

~/bin/botsay hello from the bot

Usuń narzędzie, uruchamiając polecenie odinstalowywania narzędzia dotnet :

W systemie Windows:

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

W systemie Linux lub macOS:

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

Rozwiązywanie problemów

Jeśli podczas wykonywania samouczka zostanie wyświetlony komunikat o błędzie, zobacz Rozwiązywanie problemów z użyciem narzędzi platformy .NET.

Następne kroki

W tym samouczku zainstalowano i użyto narzędzia jako narzędzia globalnego. Aby uzyskać więcej informacji na temat instalowania i używania narzędzi globalnych, zobacz Zarządzanie narzędziami globalnymi. Aby zainstalować i użyć tego samego narzędzia co narzędzie lokalne, przejdź do następnego samouczka.

Instalowanie i używanie narzędzi lokalnych