Globalne narzędzia platformy .NET Core — Omówienie.NET Core Global Tools overview

Ten artykuł dotyczy: ✓ zestawu SDK programu .NET Core 2.1This article applies to: ✓ .NET Core 2.1 SDK

Narzędzie globalne platformy .NET Core jest specjalnym pakietem NuGet, który zawiera aplikację konsolową.A .NET Core Global Tool is a special NuGet package that contains a console application. Narzędzie globalne można zainstalować na komputerze w lokalizacji domyślnej, która jest uwzględniona w zmiennej środowiskowej PATH lub w lokalizacji niestandardowej.A Global Tool can be installed on your machine on a default location that is included in the PATH environment variable or on a custom location.

Jeśli chcesz użyć globalnego narzędzia platformy .NET Core:If you want to use a .NET Core Global Tool:

  • Znajdź informacje o narzędziu (zazwyczaj witryna sieci Web lub GitHub).Find information about the tool (usually a website or GitHub page).
  • Sprawdź autora i statystyki na stronie głównej kanału informacyjnego (zwykle NuGet.org).Check the author and statistics in the home for the feed (usually NuGet.org).
  • Zainstaluj narzędzie.Install the tool.
  • Wywoływanie narzędzia.Call the tool.
  • Zaktualizuj narzędzie.Update the tool.
  • Odinstaluj narzędzie.Uninstall the tool.

Ważne

Narzędzia globalne platformy .NET Core są wyświetlane na ścieżce i działają w trybie pełnego zaufania..NET Core Global Tools appear on your path and run in full trust. Nie instaluj podstawowych narzędzi platformy .NET Core, chyba że ufasz autorowi.Do not install .NET Core Global Tools unless you trust the author.

Znajdź narzędzie globalne platformy .NET CoreFind a .NET Core Global Tool

Obecnie nie istnieje funkcja globalnego wyszukiwania narzędzi w interfejsie wiersza polecenia (CLI) platformy .NET Core.Currently, there isn't a Global Tool search feature in the .NET Core Command-line Interface (CLI). Poniżej przedstawiono kilka zaleceń dotyczących znajdowania narzędzi:The following are some recommendations on how to find tools:

  • Narzędzia platformy .NET Core można znaleźć na platformie NuGet.You can find .NET Core Global Tools on NuGet. Jednak pakiet NuGet nie zezwala jeszcze na wyszukiwanie dla narzędzi globalnych platformy .NET Core.However, NuGet doesn't yet allow you to search specifically for .NET Core Global Tools.
  • Zalecenia dotyczące narzędzi można znaleźć w wpisach w blogu lub w repozytorium GitHub natemcmaster/dotnet-Tools .You may find tool recommendations in blog posts or in the natemcmaster/dotnet-tools GitHub repository.
  • Kod źródłowy dla narzędzi globalnych utworzonych przez zespół ASP.NET można zobaczyć w repozytorium GitHub /aspnetcore w programie dotnet.You can see the source code for the Global Tools created by the ASP.NET team at the dotnet/aspnetcore GitHub repository.
  • Informacje o narzędziach diagnostycznych można znaleźć w narzędziach diagnostycznych diagnostyki dotnet programu .NET Core.You can learn about diagnostic tools at .NET Core dotnet diagnostic Global Tools.

Sprawdź autora i statystykiCheck the author and statistics

Ponieważ globalne narzędzia platformy .NET Core działają w pełni zaufane i są zwykle instalowane na ścieżce, mogą być bardzo wydajne.Since .NET Core Global Tools run in full trust and are generally installed on your path, they can be very powerful. Nie pobieraj narzędzi z osób, które nie są zaufane.Don't download tools from people you don't trust.

Jeśli narzędzie jest hostowane w usłudze NuGet, można sprawdzić autora i statystyk, wyszukując narzędzie.If the tool is hosted on NuGet, you can check the author and statistics by searching for the tool.

Instalowanie narzędzia globalnegoInstall a Global Tool

Aby zainstalować narzędzie globalne, należy użyć Narzędzia dotnet zainstaluj interfejs wiersza polecenia platformy .NET Core polecenie.To install a Global Tool, you use the dotnet tool install .NET Core CLI command. Poniższy przykład pokazuje, jak zainstalować narzędzie globalne w lokalizacji domyślnej:The following example shows how to install a Global Tool in the default location:

dotnet tool install -g dotnetsay

Jeśli nie można zainstalować narzędzia, zostaną wyświetlone komunikaty o błędach.If the tool can't be installed, error messages are displayed. Sprawdź, czy wybrane źródła danych są sprawdzane.Check that the feeds you expected are being checked.

Jeśli próbujesz zainstalować wersję wstępną lub określoną wersję narzędzia, możesz określić numer wersji w następującym formacie:If you're trying to install a pre-release version or a specific version of the tool, you can specify the version number using the following format:

dotnet tool install -g <package-name> --version <version-number>

Jeśli instalacja zakończy się pomyślnie, zostanie wyświetlony komunikat z poleceniem, które służy do wywoływania narzędzia i zainstalowanej wersji, podobnie jak w poniższym przykładzie:If installation is successful, a message is displayed showing the command used to call the tool and the version installed, similar to the following example:

You can invoke the tool using the following command: dotnetsay
Tool 'dotnetsay' (version '2.0.0') was successfully installed.

Narzędzia globalne można zainstalować w katalogu domyślnym lub w określonej lokalizacji.Global Tools can be installed in the default directory or in a specific location. Domyślne katalogi są następujące:The default directories are:

System operacyjnyOS ŚcieżkaPath
Linux/macOSLinux/macOS $HOME/.dotnet/tools
WindowsWindows %USERPROFILE%\.dotnet\tools

Te lokalizacje są dodawane do ścieżki użytkownika podczas pierwszego uruchomienia zestawu SDK, dzięki czemu globalne narzędzia mogą być wywoływane bezpośrednio.These locations are added to the user's path when the SDK is first run, so Global Tools installed there can be called directly.

Należy pamiętać, że globalne narzędzia to specyficzne dla użytkownika, a nie globalne maszyny.Note that the Global Tools are user-specific, not machine global. Specyficzne dla użytkownika oznacza, że nie można zainstalować narzędzia globalnego, które jest dostępne dla wszystkich użytkowników komputera.Being user-specific means you cannot install a Global Tool that is available to all users of the machine. Narzędzie jest dostępne tylko dla każdego profilu użytkownika, w którym zainstalowano narzędzie.The tool is only available for each user profile where the tool was installed.

Narzędzia globalne można także zainstalować w określonym katalogu.Global Tools can also be installed in a specific directory. Po zainstalowaniu w określonym katalogu użytkownik musi upewnić się, że polecenie jest dostępne, dołączając ten katalog w ścieżce, wywołując polecenie z określonym katalogiem lub wywołując narzędzie z w określonym katalogu.When installed in a specific directory, the user must ensure the command is available, by including that directory in the path, by calling the command with the directory specified, or calling the tool from within the specified directory. W takim przypadku interfejs wiersza polecenia platformy .NET Core nie dodaje automatycznie tej lokalizacji do zmiennej środowiskowej PATH.In this case, the .NET Core CLI doesn't add this location automatically to the PATH environment variable.

Korzystanie z narzędziaUse the tool

Po zainstalowaniu narzędzia można wywołać je za pomocą polecenia.Once the tool is installed, you can call it by using its command. Należy pamiętać, że polecenie nie może być takie samo jak nazwa pakietu.Note that the command may not be the same as the package name.

Jeśli polecenie jest dotnetsay, nastąpi wywołanie:If the command is dotnetsay, you call it with:

dotnetsay

Jeśli narzędzie ma być wyświetlane w kontekście monitu dotnet, nastąpiło zapisanie go w taki sposób, że jest on wywoływany jako dotnet <command>, na przykład:If the tool author wanted the tool to appear in the context of the dotnet prompt, they may have written it in a way that you call it as dotnet <command>, such as:

dotnet doc

Aby znaleźć narzędzia dołączone do zainstalowanego pakietu narzędzi globalnych, należy wyświetlić listę zainstalowanych pakietów przy użyciu polecenia programu dotnet .You can find which tools are included in an installed Global Tool package by listing the installed packages using the dotnet tool list command.

Możesz również wyszukać instrukcje dotyczące użycia w witrynie sieci Web narzędzia lub wpisując jedno z następujących poleceń:You can also look for usage instructions at the tool's website or by typing one of the following commands:

<command> --help
dotnet <command> --help

Inne polecenia interfejsu CLIOther CLI commands

Zestaw .NET Core SDK zawiera inne polecenia, które obsługują narzędzia platformy .NET Core.The .NET Core SDK contains other commands that support .NET Core Global Tools. Użyj dowolnego z dotnet tool poleceń z jedną z następujących opcji:Use any of the dotnet tool commands with one of the following options:

  • --global lub -g określa, że polecenie ma zastosowanie do narzędzi globalnych dostępnych dla użytkownika.--global or -g specifies that the command is applicable to user-wide Global Tools.
  • --tool-path określa niestandardową lokalizację dla narzędzi globalnych.--tool-path specifies a custom location for Global Tools.

Aby dowiedzieć się, które polecenia są dostępne dla narzędzi globalnych:To find out which commands are available for Global Tools:

dotnet tool --help

Aktualizacja narzędzia globalnego polega na odinstalowaniu i ponownym zainstalowaniu programu z najnowszą stabilną wersją.Updating a Global Tool involves uninstalling and reinstalling it with the latest stable version. Aby zaktualizować narzędzie globalne, użyj polecenia aktualizacji narzędzia dotnet :To update a Global Tool, use the dotnet tool update command:

dotnet tool update -g <packagename>

Usuń narzędzie globalne przy użyciu Narzędzia dotnet Uninstall:Remove a Global Tool using the dotnet tool uninstall:

dotnet tool uninstall -g <packagename>

Aby wyświetlić wszystkie narzędzia globalne aktualnie zainstalowane na komputerze wraz z ich wersjami i poleceniami, użyj polecenia z listy narzędzi dotnet :To display all of the Global Tools currently installed on the machine, along with their version and commands, use the dotnet tool list command:

dotnet tool list -g

Zobacz takżeSee also