Учебник. Установка и использование глобального средства .NET с помощью интерфейса командной строки .NET

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

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

Предварительные требования

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

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

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

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

    Параметр --add-source настраивает временное использование каталога ./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
    

Устранение неполадок

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

Следующие шаги

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

Tutorial: Install and use a .NET Core local tool using the .NET Core CLI (Учебник. Установка и использование локального средства .NET Core с помощью NET Core CLI.)