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

Статья
07/27/2023

Эта статья относится к следующему. ✔️ SDK для .NET Core 2.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.
Вызовите средство:
```
botsay hello from the bot
```
Примечание

Если эта команда не сработает, для обновления PATH может потребоваться открыть новый терминал.
Удалите средство, выполнив команду dotnet tool uninstall:
```
dotnet tool uninstall -g microsoft.botsay
```

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

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

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.
```

Вызовите средство:

Windows:

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

В Linux или macOS.

~/bin/botsay hello from the bot

Удалите средство, выполнив команду 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.)

Поделиться через