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 8 SDK a novější verze

V tomto kurzu se dozvíte, jak nainstalovat a používat globální nástroj. Nástroj, který používáte, je 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 dotnet-env --add-source ./nupkg
   

   Parametr --add-source říká rozhraní příkazového řádku .NET, aby používal 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 dotnet-env :

   dotnet tool install --global --add-source ./nupkg dotnet-env
   

   Parametr --global určuje rozhraní příkazového řádku .NET, 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ží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 se nachází jenom v adresáři ./nupkg , ne v 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: dotnet-env
   Tool 'dotnet-env' (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:

   dotnet-env
   

   Poznámka:

   Pokud příkaz selže, otevřete nový terminál a aktualizujte proměnnou PATH prostředí.

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

   dotnet tool uninstall -g dotnet-env
   

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 dotnet-env
   

   V Linuxu nebo macOS:

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

   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. Adresář se automaticky nepřidá do PATH proměnné prostředí.

   Výstup zobrazuje příkaz použitý k volání nástroje a nainstalované verze:

   You can invoke the tool using the following command: dotnet-env
   Tool 'dotnet-env' (version '1.0.0') was successfully installed.
   

2. Vyvolání nástroje:

   V systému Windows:

   c:\dotnet-tools\dotnet-env
   

   V Linuxu nebo macOS:

   ~/bin/dotnet-env
   

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

   V systému Windows:

   dotnet tool uninstall --tool-path c:\dotnet-tools dotnet-env
   

   V Linuxu nebo macOS:

   dotnet tool uninstall --tool-path ~/bin dotnet-env
   

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ů 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žívání místních nástrojů