Kurz: Instalace a použití globálního nástroje .NET pomocí rozhraní příkazového řádku .NET

Tento článek se vztahuje na: ✔️ .NET Core 2.1 SDK a novější verze

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.
• .NET 10.0.100 SDK nebo novější (pro dnx) – volitelné, ale doporučuje se.

Spuštění nástroje bez instalace (doporučeno)

Počínaje rozhraním .NET 10.0.100 můžete spouštět nástroje .NET bez trvalé instalace pomocí dnx:

1. Spusťte nástroj přímo pomocí dnxu (zjednodušená syntaxe):

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

   Parametr --add-source říká rozhraní příkazového řádku .NET, aby používalo adresář ./nupkg jako další zdrojový kanál pro balíčky NuGet, pokud nástroj není k dispozici v NuGet.org.

Použití nástroje jako globálního nástroje (tradiční instalace)

Pokud dáváte přednost trvalé instalaci pro časté použití:

1. 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 říká rozhraní příkazového řádku .NET, aby nainstaloval 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žívalo adresář ./nupkg jako další zdrojový kanál pro balíčky NuGet. Balíček jste dali jedinečný název, abyste měli jistotu, že bude nalezen pouze v adresáři ./nupkg , ne na webu Nuget.org.

   Výstup zobrazuje 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, viz dotnet tool install, volba --arch.

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

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

   dotnet tool uninstall -g microsoft.botsay
   

Použijte nástroj jako globální nástroj nainstalovaný na vlastním umístění

1. Nainstalujte nástroj z balíčku.

   V systému 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 určuje rozhraní příkazového řádku .NET k instalaci binárních souborů 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.

   Výstup zobrazuje 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.
   

2. Vyvolání nástroje:

   Na Windows:

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

   V Linuxu nebo macOS:

   ~/bin/botsay hello from the bot
   

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

Troubleshoot

Pokud se 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 instalaci a používání globálních nástrojů naleznete 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žívání místních nástrojů