Руководство. Установка и использование глобального средства .NET с помощью .NET CLI

эта статья применяется к: ✔️ SDK .NET 8 и более поздним версиям

В этом руководстве показано, как установить и использовать глобальное средство. Используемое средство — это средство, создаваемое в первом руководстве этой серии.

Предпосылки

• Выполните первое руководство по этой серии.
• SDK .NET 10.0.100 или более поздней версии (для dnx) — необязателен, но рекомендуется.

Запуск средства без установки (рекомендуется)

Начиная с .NET 10.0.100, вы можете запускать средства .NET без постоянной установки с помощью dnx:

1. Запустите средство непосредственно с помощью dnx (упрощенного синтаксиса):

   dnx dotnet-env --add-source ./nupkg
   

   Параметр --add-source сообщает интерфейсу командной строки .NET использовать каталог ./nupkg в качестве дополнительного исходного веб-канала пакетов NuGet, если средство недоступно в NuGet.org.

Используйте инструмент как глобальный инструмент (традиционная установка)

Если вы предпочитаете постоянную установку для частого использования:

1. Установите средство из пакета, выполнив команду dotnet tool install в папке проекта dotnet-env:

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

   Параметр --global указывает .NET CLI устанавливать двоичные файлы инструментов в место по умолчанию, автоматически добавляемое в переменную среды PATH.

   Параметр --add-source сообщает .NET CLI временно использовать каталог ./nupkg в качестве дополнительного источника для пакетов NuGet. Вы предоставили пакету уникальное имя, чтобы убедиться, что он найден только в каталоге ./nupkg , а не в NuGet.org.

   В выходных данных показана команда, используемая для вызова средства и установленной версии:

   You can invoke the tool using the following command: dotnet-env
   Tool 'dotnet-env' (version '1.0.0') was successfully installed.
   

   Замечание

   По умолчанию архитектура двоичных файлов .NET для установки представляет архитектуру операционной системы. Чтобы указать другую архитектуру ОС, см. dotnet tool install --arch.

2. Вызов инструмента:

   dotnet-env
   

   Замечание

   Если команда завершается ошибкой, откройте новый терминал, чтобы обновить PATH переменную среды.

3. Удалите инструмент, выполнив команду dotnet tool uninstall.

   dotnet tool uninstall -g dotnet-env
   

Использование средства в качестве глобального инструмента, установленного в заданном пользователем месте

1. Установите средство из пакета.

   В Windows:

   dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg dotnet-env
   

   В Linux или macOS:

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

   Параметр --tool-path указывает .NET CLI на установку двоичных файлов данного средства в указанном расположении. Если каталог не существует, он создается. Каталог не добавляется PATH в переменную среды автоматически.

   В выходных данных показана команда, используемая для вызова средства и установленной версии:

   You can invoke the tool using the following command: dotnet-env
   Tool 'dotnet-env' (version '1.0.0') was successfully installed.
   

2. Вызов инструмента:

   В Windows:

   c:\dotnet-tools\dotnet-env
   

   В Linux или macOS:

   ~/bin/dotnet-env
   

3. Удалите инструмент, выполнив команду dotnet tool uninstall.

   В Windows:

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

   В Linux или macOS:

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

Troubleshoot

Если вы получите сообщение об ошибке при выполнении руководства, см. статью "Устранение неполадок с использованием средства .NET".

Дальнейшие шаги

В этом руководстве вы установили и использовали средство в качестве глобального инструмента. Дополнительные сведения об установке и использовании глобальных средств см. в статье "Управление глобальными инструментами". Чтобы установить и использовать то же средство, что и локальный инструмент, перейдите к следующему руководству.