dotnet new install

  • Článek

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

Name

dotnet new install – nainstaluje balíček šablony.

Synopse

dotnet new install <PATH|NUGET_ID>  [--interactive] [--add-source|--nuget-source <SOURCE>] [--force] 
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Description

Příkaz dotnet new install nainstaluje balíček šablony ze zadaného PATH nebo NUGET_ID . Pokud chcete nainstalovat konkrétní verzi nebo předběžnou verzi balíčku šablony, zadejte verzi ve formátu <package-name>::<package-version>. Ve výchozím nastavení dotnet new předává * pro verzi, která představuje nejnovější stabilní verzi balíčku. Další informace najdete v části Příklady .

Pokud už byla při spuštění tohoto příkazu nainstalovaná verze balíčku šablony, balíček šablony se aktualizuje na zadanou verzi. Pokud není zadána žádná verze, balíček se aktualizuje na nejnovější stabilní verzi. Počínaje sadou .NET SDK 6.0.100 platí, že pokud argument určuje verzi a tato verze balíčku NuGet už je nainstalovaná, nebude se přeinstalovat. Pokud je argument a PATH už je nainstalovaný, nebude se znovu instalovat.

Před verzí sady .NET SDK 6.0.100 se balíčky šablon spravovaly jednotlivě pro každou verzi sady .NET SDK, včetně verzí oprav. Pokud například nainstalujete balíček šablony pomocí v dotnet new --install sadě .NET SDK 5.0.100, nainstaluje se pouze pro sadu .NET SDK 5.0.100. Šablony z balíčku nebudou k dispozici v jiných verzích sady .NET SDK nainstalovaných na vašem počítači.

Počínaje sadou .NET SDK 6.0.100 jsou nainstalované balíčky šablon k dispozici v novějších verzích sady .NET SDK nainstalovaných na vašem počítači. Balíček šablony nainstalovaný v sadě .NET SDK 6.0.100 bude k dispozici také v sadě .NET SDK 6.0.101, .NET SDK 6.0.200 atd. Tyto balíčky šablon však nebudou k dispozici ve verzích sady .NET SDK starších než .NET SDK 6.0.100. Pokud chcete použít balíček šablony nainstalovaný v sadě .NET SDK 6.0.100 nebo novější ve starších verzích sady .NET SDK, musíte ho nainstalovat pomocí dotnet new install této verze sady .NET SDK.

Poznámka

Od sady .NET 7 SDK se dotnet new syntaxe změnila:

  • Z --listmožností , --search, --installa --uninstall se staly listpodpříkazy , searchinstall, a uninstall .
  • Možnost --update-apply se stala dílčím update příkazem.
  • Pokud chcete použít --update-check, použijte update podpříkaz s --check-only možností .

Další možnosti, které byly k dispozici dříve, jsou stále k dispozici pro použití s příslušnými dílčími příkazy. Samostatná nápověda pro každý podpříkaz je k dispozici prostřednictvím -h možnosti nebo --help : dotnet new <subcommand> --help obsahuje seznam všech podporovaných možností podpříkazu.

Kromě toho je teď k dispozici dokončování tabulátoru pro dotnet new. Podporuje dokončování názvů nainstalovaných šablon a možností, které vybraná šablona nabízí. Pokud chcete aktivovat dokončování tabulátoru pro sadu .NET SDK, přečtěte si téma Povolení dokončování karet.

Příklady staré syntaxe:

  • Nainstalujte nejnovější verzi balíčku šablony projektu webových úloh Azure:

    dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates

Argumenty

  • <PATH|NUGET_ID>

    Složka v systému souborů nebo identifikátor balíčku NuGet, ze které se má balíček šablony nainstalovat. dotnet new nástroj se pokusí nainstalovat balíček NuGet ze zdrojů NuGet dostupných pro aktuální pracovní adresář a ze zdrojů určených --add-source pomocí možnosti . Pokud chcete nainstalovat konkrétní verzi nebo předběžnou verzi balíčku šablony ze zdroje NuGet, zadejte verzi ve formátu <package-name>::<package-version>.

Možnosti

  • --add-source|--nuget-source <SOURCE>

    Ve výchozím nastavení dotnet new install používá hierarchii konfiguračních souborů NuGet z aktuálního adresáře k určení zdroje NuGet, ze které je možné balíček nainstalovat. Pokud --nuget-source je zadána hodnota , zdroj se přidá do seznamu zdrojů, které se mají zkontrolovat.
    Pokud chcete zkontrolovat nakonfigurované zdroje pro aktuální adresář, použijte dotnet nuget list source. Další informace najdete v tématu Běžné konfigurace NuGetu.

    Poznámka

    V návaznosti na iniciativu dotnet newNuGet Https Everywhere se informační kanály postupně ukončujíhttp. Pokud se http informační kanál předá, nebude dotazován na balíčky a zobrazí se upozornění. V --force případě potřeby lze toto chování přepsat pomocí možnosti .

  • -d|--diagnostics

    Povolí výstup diagnostiky. K dispozici od sady .NET SDK 7.0.100.

  • --force

    Umožňuje instalaci balíčků šablon ze zadaných zdrojů i v případě, že by přepsaly balíček šablony z jiného zdroje. K dispozici od sady .NET SDK 7.0.100.

  • -h|--help

    Vytiskne nápovědu pro příkaz k instalaci. K dispozici od sady .NET SDK 7.0.100.

  • --interactive

    Umožňuje příkaz zastavit a čekat na vstup nebo akci uživatele. Například k dokončení ověřování. K dispozici od sady .NET 5.0 SDK.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], m[inimal], n[ormal]a diag[nostic]. K dispozici od sady .NET SDK 7.0.100.

Příklady

  • Nainstalujte nejnovější verzi šablon SPA pro ASP.NET Core:

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates

  • Nainstalujte verzi 2.0 šablon SPA pro ASP.NET Core:

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0

  • Nainstalujte verzi 2.0 šablon SPA pro ASP.NET Core z vlastního zdroje NuGet pomocí interaktivního režimu:

    dotnet new --install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0 --add-source "https://api.my-custom-nuget.com/v3/index.json" --interactive

Viz také