Бөлісу құралы:

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

Эта статья относится к: ✔️ SDK для .NET Core 2.1 и более поздних версий.

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

Предпосылки

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

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

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

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

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

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

  1. Установите средство из пакета, выполнив команду установки средства dotnet в папке проекта microsoft.botsay :

    dotnet tool install --global --add-source ./nupkg microsoft.botsay

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

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

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

    You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.

    Замечание

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

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

    botsay hello from the bot

    Замечание

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

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

    dotnet tool uninstall -g microsoft.botsay

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

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

    В Windows:

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

    В Linux или macOS:

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

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

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

    You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.

  2. Запустите средство:

    В Windows:

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

    В Linux или macOS:

    ~/bin/botsay hello from the bot

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

    В Windows:

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

    В Linux или macOS:

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

Troubleshoot

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

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

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

Установка и использование локальных средств

  • Last updated on