Sdílet prostřednictvím

dotnet tool install

  • Článek

Tento článek se vztahuje na: ✔️ .NET Core 3.1 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] [-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] [-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] [-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 --tool-path využte --global možnosti.

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 .

--tool-path Nástroje

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řte ho --create-manifest-if-needed pomocí možnosti nebo 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.

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

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

  • --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

    Platí pro místní nástroje. K dispozici od sady .NET 8 SDK. 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 se manifest nástroje nenašel a --create-manifest-if-needed možnost je nastavená na false, dojde k CannotFindAManifestFile chybě.

    Pokud se manifest nástroje nenajde a --create-manifest-if-needed možnost je nastavená na true, 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.

  • --disable-parallel

    Zabránění 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í.

  • -?|-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

    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í, kam se má nástroj Global Tool nainstalovat. 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], , n[ormal]m[inimal], 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.

    Od verze .NET 8.0 --version Major.Minor.Patch odkazuje na konkrétní hlavní/podverzi/verzi opravy, včetně nezasílaný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 dotnetsay

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

  • dotnet tool install -g --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á.

Viz také