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

Artykuł dotyczy: ✔️ .NET 8 SDK i nowszych wersji

W tym samouczku przedstawiono sposób instalowania i używania narzędzia globalnego. Używane narzędzie jest tym, które tworzysz 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 dotnet-env --add-source ./nupkg
   

   Parametr --add-source informuje interfejs wiersza polecenia .NET o użyciu ./nupkg katalogu 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 dotnet-env :

   dotnet tool install --global --add-source ./nupkg dotnet-env
   

   Parametr --global informuje interfejs wiersza polecenia .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 znajduje się ona tylko w katalogu ./nupkg , a nie w 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: dotnet-env
   Tool 'dotnet-env' (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:

   dotnet-env
   

   Uwaga / Notatka

   Jeśli polecenie zakończy się niepowodzeniem, otwórz nowy terminal, aby odświeżyć zmienną PATH środowiskową.

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

   dotnet tool uninstall -g dotnet-env
   

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 dotnet-env
   

   W systemie Linux lub macOS:

   dotnet tool install --tool-path ~/bin --add-source ./nupkg dotnet-env
   

   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. 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: dotnet-env
   Tool 'dotnet-env' (version '1.0.0') was successfully installed.
   

2. Wywołaj narzędzie:

   W systemie Windows:

   c:\dotnet-tools\dotnet-env
   

   W systemie Linux lub macOS:

   ~/bin/dotnet-env
   

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

   W systemie Windows:

   dotnet tool uninstall --tool-path c:\dotnet-tools dotnet-env
   

   W systemie Linux lub macOS:

   dotnet tool uninstall --tool-path ~/bin dotnet-env
   

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.

Instalowanie i używanie narzędzi lokalnych