Kurz: Instalace a použití globálního nástroje .NET pomocí .NET CLI

Článek
07/27/2023

Tento článek se týká sady ✔️ .NET Core 2.1 SDK a novějších verzí.

V tomto kurzu se naučíte, jak nainstalovat a používat globální nástroj. Použijete nástroj, který vytvoříte v prvním kurzu této série.

Požadavky

Dokončete první kurz této série.

Použití nástroje jako globálního nástroje

Nainstalujte nástroj z balíčku spuštěním příkazu dotnet tool install ve složce projektu microsoft.botsay :
```
dotnet tool install --global --add-source ./nupkg microsoft.botsay
```
Parametr --global sděluje rozhraní .NET CLI, aby nainstalovalo binární soubory nástroje do výchozího umístění, které se automaticky přidá do proměnné prostředí PATH.

Parametr --add-source říká rozhraní příkazového řádku .NET, aby dočasně použilo adresář ./nupkg jako další zdrojový kanál pro balíčky NuGet. Balíčku jste dali jedinečný název, abyste měli jistotu, že se bude nacházet jenom v adresáři ./nupkg , ne na Nuget.org webu.

Ve výstupu se zobrazí příkaz použitý k volání nástroje a nainstalovaná verze:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```
Poznámka

Ve výchozím nastavení architektura binárních souborů .NET, které se mají nainstalovat, představuje aktuálně spuštěnou architekturu operačního systému. Pokud chcete zadat jinou architekturu operačního systému, projděte si téma dotnet tool install, --arch option.
Vyvolání nástroje:
```
botsay hello from the bot
```
Poznámka

Pokud tento příkaz selže, možná budete muset otevřít nový terminál, aby se aktualizovala cesta.
Odeberte nástroj spuštěním příkazu dotnet tool uninstall :
```
dotnet tool uninstall -g microsoft.botsay
```

Použití nástroje jako globálního nástroje nainstalovaného ve vlastním umístění

Nainstalujte nástroj z balíčku.

Ve Windows:
```
dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg microsoft.botsay
```
V Linuxu nebo macOS:
```
dotnet tool install --tool-path ~/bin --add-source ./nupkg microsoft.botsay
```
Parametr --tool-path říká rozhraní .NET CLI, aby nainstalovalo binární soubory nástroje do zadaného umístění. Pokud adresář neexistuje, vytvoří se. Tento adresář se automaticky nepřidá do proměnné prostředí PATH.

Ve výstupu se zobrazí příkaz použitý k volání nástroje a nainstalovaná verze:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```

Vyvolání nástroje:

Ve Windows:

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

V Linuxu nebo macOS:

~/bin/botsay hello from the bot

Odeberte nástroj spuštěním příkazu dotnet tool uninstall :

Ve Windows:

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

V Linuxu nebo macOS:

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

Řešení potíží

Pokud se vám při sledování kurzu zobrazí chybová zpráva, přečtěte si téma Řešení potíží s používáním nástrojů .NET.

Další kroky

V tomto kurzu jste nainstalovali a použili nástroj jako globální nástroj. Další informace o tom, jak nainstalovat a používat globální nástroje, najdete v tématu Správa globálních nástrojů. Pokud chcete nainstalovat a používat stejný nástroj jako místní nástroj, přejděte k dalšímu kurzu.

Instalace a použití místních nástrojů