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

Ten artykuł dotyczy: ✔️ zestawu SDK dla .NET Core 2.1 i nowszych wersji

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

Wymagania wstępne

• Ukończ pierwszy samouczek tej serii.
• Pakiet .NET 10.0.100 SDK lub nowszy (dla dnx) — opcjonalny, ale zalecany.

Uruchamianie narzędzia bez instalacji (zalecane)

Począwszy od platformy .NET 10.0.100, można uruchamiać narzędzia .NET bez stałej instalacji przy użyciu polecenia dnx:

1. Uruchom narzędzie bezpośrednio przy użyciu narzędzia dnx (uproszczona składnia):

   dnx microsoft.botsay --add-source ./nupkg microsoft.botsay hello from the bot
   

   Parametr --add-source informuje interfejs wiersza polecenia platformy .NET o użyciu katalogu ./nupkg jako dodatkowego źródła danych dla pakietów NuGet, gdy narzędzie nie jest dostępne w NuGet.org.

Użyj narzędzia jako globalnego narzędzia (tradycyjna instalacja)

Jeśli wolisz instalację trwałą do częstego użycia:

1. 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 o tymczasowym użyciu katalogu ./nupkg jako dodatkowego źródła danych 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 / Notatka

   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).

2. Wywołaj narzędzie:

   botsay hello from the bot
   

   Uwaga / Notatka

   Jeśli to polecenie nie powiedzie się, może być konieczne otwarcie nowego terminalu w celu odświeżenia ścieżki.

3. Usuń narzędzie, wydając polecenie dotnet tool uninstall :

   dotnet tool uninstall -g microsoft.botsay
   

Korzystaj z narzędzia jako globalnego narzędzia zainstalowanego w niestandardowej lokalizacji

1. 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 mówi interfejsowi wiersza polecenia platformy .NET, żeby zainstalować pliki binarne 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.
   

2. 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
   

3. Usuń narzędzie, uruchamiając komendę dotnet tool uninstall:

   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
   

Troubleshoot

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

Dalsze kroki

W tym samouczku zainstalowałeś i używałeś narzędzia jako 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.