Sdílet prostřednictvím

Příkaz dotnet tool install

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

Název

dotnet tool install – Nainstaluje na počítač zadaný nástroj .NET.

Synopse

dotnet tool install <PACKAGE_NAME> -g|--global
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

Popis

Příkaz dotnet tool install poskytuje způsob, jak na počítač nainstalovat nástroje .NET. Pokud chcete tento příkaz použít, zadejte jednu z následujících možností instalace:

  • Pokud chcete nainstalovat globální nástroj do výchozího umístění, použijte tuto --global možnost.
  • Pokud chcete nainstalovat globální nástroj do vlastního umístění, použijte tuto --tool-path možnost.
  • Pokud chcete nainstalovat místní nástroj, vymižte a --global využte --tool-path možnosti.

Výstraha

Ujistěte se, že je zadaný adresář s možností --tool-path zabezpečený. Nástroje nainstalované v tomto umístění se dají spustit přímo, takže použití nedůvěryhodné nebo sdílené cesty může představovat bezpečnostní rizika.

Umístění instalace

Globální nástroje

Globální nástroje se ve výchozím nastavení instalují do následujících adresářů při zadávání -g nebo --global možnosti:

Operační systém Cesta
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Spustitelné soubory se generují v těchto složkách pro každý globálně nainstalovaný nástroj, i když skutečné binární soubory nástrojů jsou vnořené hluboko do adresáře na stejné úrovni .store .

Poznámka:

V Linuxu po instalaci nástroje příkazového řádku s dotnet toolnástrojem lze nástroj spustit pouze z $HOME/.dotnet/tools cesty. Pokud chcete nástroj spustit z libovolného adresáře, aktualizujte proměnnou PATH prostředí. Pokud chcete, aby aktualizovaná PATH proměnná prostředí byla v prostředí trvalá, aktualizujte nastavení prostředí. Pro Bash, to je $HOME/.bashrc soubor.

--tool-path nářadí

Nástroje s explicitními cestami nástrojů se ukládají všude, kde jste zadali --tool-path parametr, na který má odkazovat. Ukládají se stejným způsobem jako globální nástroje: spustitelný binární soubor se skutečnými binárními soubory ve stejném .store adresáři.

Místní nástroje

Místní nástroje se ukládají do globálního adresáře NuGet, ať už jste to nastavili. Pro každý místní nástroj existují soubory $HOME/.dotnet/toolResolverCache shim, které ukazují na umístění, kde jsou nástroje v daném umístění.

Odkazy na místní nástroje se přidají do souboru dotnet-tools.json v adresáři .config v aktuálním adresáři. Pokud soubor manifestu ještě neexistuje, vytvoří se od verze .NET 10 automaticky. Můžete ho také vytvořit ručně spuštěním následujícího příkazu:

dotnet new tool-manifest

Další informace naleznete v tématu Instalace místního nástroje.

Argumenty

  • PACKAGE_NAME

    Název/ID balíčku NuGet, který obsahuje nástroj .NET k instalaci.

    Počínaje sadou .NET 10.0.100 SDK použijte název/ID a verzi oddělenou @ nástrojem .NET.

Možnosti

  • --allow-downgrade

    Povolte downgrade balíčku při instalaci nebo aktualizaci balíčku nástroje .NET. Potlačí upozornění "Požadovaná verze x.x.x je nižší než existující verze x.x.x.".

  • --allow-roll-forward

    K dispozici od sady .NET 9.0 SDK. Povolit nástroji používat novější verzi modulu runtime .NET, pokud modul runtime, na který cílí, není nainstalovaný.

  • -a|--arch <ARCHITECTURE>

    Určuje cílovou architekturu. Toto je zkratka pro nastavení identifikátoru runtime (RID), kde se zadaná hodnota zkombinuje s výchozím identifikátorem RID. Například na win-x64 počítači se zadáním --arch x86 identifikátoru RID nastaví na win-x86. Pokud použijete tuto možnost, tuto možnost nepoužívejte -r|--runtime . K dispozici od verze .NET 6 Preview 7.

  • --add-source <SOURCE>

    Přidá další zdroj balíčku NuGet, který se použije během instalace. Informační kanály jsou přístupné paralelně, ne postupně v určitém pořadí priorit. Pokud je stejný balíček a verze ve více informačních kanálech, nejrychlejší kanál vyhraje. Další informace najdete v tématu Co se stane při instalaci balíčku NuGet?.

  • --configfile <FILE>

    Konfigurační soubor NuGet (nuget.config), který se má použít. Pokud je zadáno, použijí se pouze nastavení z tohoto souboru. Pokud není zadáno, použije se hierarchie konfiguračních souborů z aktuálního adresáře. Další informace najdete v tématu Běžné konfigurace NuGet.

  • --create-manifest-if-needed

    K dispozici od sady .NET 8 SDK.

    Platí pro místní nástroje. Pokud chcete najít manifest, vyhledávací algoritmus vyhledá strom adresáře nebo dotnet-tools.json.config složku, která obsahuje dotnet-tools.json soubor.

    Pokud nelze najít manifest nástroje a --create-manifest-if-needed je tato možnost nastavená na false, dojde k CannotFindAManifestFile chybě.

    Pokud se manifest nástroje nenašel a --create-manifest-if-needed možnost je nastavená true (nebo v .NET 10 a novějších verzích, pokud není zadána), nástroj automaticky vytvoří manifest. Zvolí složku manifestu následujícím způsobem:

    • Procházěte strom adresáře hledáním adresáře, který má podsložku .git . Pokud se najde, vytvořte manifest v daném adresáři.
    • Pokud předchozí krok nenajde adresář, procházejte strom adresáře hledáním adresáře, který obsahuje .sln nějaký adresář nebo .git soubor. Pokud se najde, vytvořte manifest v daném adresáři.
    • Pokud žádný z předchozích dvou kroků nenajde adresář, vytvořte manifest v aktuálním pracovním adresáři.

    Další informace o umístění manifestů naleznete v tématu Instalace místního nástroje.

    Počínaje verzí .NET 10 se manifest vytvoří automaticky, pokud se nenajde žádný manifest nástrojů. Tato změna může být zásadní změnou. Můžete se odhlásit předáním --create-manifest-if-needed=false.

    Výstraha

    Nespousívejte příkazy nástroje ze složky Stažené soubory ani ze sdíleného umístění. Rozhraní příkazového řádku provede adresářový strom a vyhledá manifest nástroje, což může způsobit, že použije manifest, který neočekáváte. Vždy spouštějte příkazy nástrojů z důvěryhodného adresáře specifického pro projekt.

  • --disable-parallel

    Zabraňuje paralelnímu obnovení více projektů.

  • --framework <FRAMEWORK>

    Určuje cílovou architekturu pro instalaci nástroje. Ve výchozím nastavení se sada .NET SDK pokusí zvolit nejvhodnější cílovou architekturu.

  • -g|--global

    Určuje, že instalace je široká. Tuto možnost nejde kombinovat --tool-path . Vynechání instalace --global místního nástroje a --tool-path jeho nastavení.

  • --source <SOURCE>

    Určuje zdroj balíčků NuGet. Tento zdroj nahrazuje všechny zdroje balíčků NuGet.

  • -?|-h|--help

    Vytiskne popis použití příkazu.

  • --ignore-failed-sources

    Zacházet se selháním zdroje balíčku jako s upozorněními

  • --interactive

    Umožňuje příkazu zastavit a čekat na uživatelský vstup nebo akci. Například k dokončení ověřování.

  • --local

    Aktualizujte nástroj a manifest místního nástroje. Nelze kombinovat s --global možností ani s --tool-path možností.

  • --no-cache nebo --no-http-cache

    Neukávejte balíčky a požadavky HTTP do mezipaměti.

  • --prerelease

    Zahrnout předběžné balíčky.

  • --tool-manifest <PATH>

    Cesta k souboru manifestu

  • --tool-path <PATH>

    Určuje umístění pro instalaci globálního nástroje. CESTA může být absolutní nebo relativní. Pokud cesta neexistuje, pokusí se ho příkaz vytvořit. Vynechání instalace --global místního nástroje a --tool-path jeho nastavení.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], , m[inimal]n[ormal], d[etailed]a diag[nostic]. Další informace najdete na webu LoggerVerbosity.

  • --version <VERSION_NUMBER>

    Verze nástroje, která se má nainstalovat. Ve výchozím nastavení je nainstalovaná nejnovější stabilní verze balíčku. Tuto možnost použijte k instalaci verze Preview nebo starších verzí nástroje.

    Počínaje rozhraním .NET 8 --version Major.Minor.Patch odkazuje na konkrétní hlavní/podverzi/verzi opravy, včetně nevysazených verzí. Pokud chcete získat nejnovější verzi určité hlavní/podverze, použijte --version Major.Minor.*.

Příklady

  • dotnet tool install -g dotnetsay

    Nainstaluje dotnetsay jako globální nástroj do výchozího umístění.

  • dotnet tool install dotnetsay --tool-path c:\global-tools

    Nainstaluje dotnetsay jako globální nástroj do konkrétního adresáře Windows.

  • dotnet tool install dotnetsay --tool-path ~/bin

    Nainstaluje dotnetsay jako globální nástroj do konkrétního adresáře Linux/macOS.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Nainstaluje jako globální nástroj verzi 2.0.0 dotnetsay.

  • dotnet tool install -g dotnetsay@2.1.7

    Nainstaluje jako globální nástroj verzi 2.1.7 dotnetsay .

  • dotnet tool install dotnetsay

    Nainstaluje dotnetsay jako místní nástroj pro aktuální adresář.

  • dotnet tool install dotnetsay@2.1.7

    Nainstaluje verzi 2.1.7 dotnetsay jako místní nástroj pro aktuální adresář.

  • dotnet tool install -g dotnetsay --verbosity minimal

    Nainstaluje dotnetsay jako globální nástroj s minimálními podrobnostmi. Výchozí úroveň podrobností globálního nástroje je tichá.

  • dotnet tool install -g dotnetsay --allow-roll-forward

    Nainstaluje dotnetsay jako globální nástroj a umožňuje ho spouštět v novějších verzích .NET, pokud cílový modul runtime není k dispozici.

Viz také

  • Last updated on