dotnet new install - příkaz k instalaci nového šablony v .NET

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

Jméno

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

Přehled

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

Popis

Příkaz dotnet new install nainstaluje balíček šablony z 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>. (Oddělovač :: dvojtečky byl ve prospěch znaku @ v sadě .NET 9.0.200 SDK vyřazen.) Ve výchozím nastavení dotnet new předá * 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, pokud argument určuje verzi a tato verze balíčku NuGet je už nainstalovaná, nebude přeinstalována. Pokud je argument PATH a už je nainstalovaný, nepřeinstaluje se.

Před .NET SDK 6.0.100 byly balíčky šablon spravovány jednotlivě pro každou verzi sady .NET SDK, včetně verzí oprav. Pokud například nainstalujete balíček šablony pomocí dotnet new --install v 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 dostupný také v sadě .NET SDK 6.0.101, .NET SDK 6.0.200 atd. Tyto balíčky šablon ale nebudou k dispozici ve verzích sady .NET SDK před sadou .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 .NET SDK, musíte ho nainstalovat pomocí dotnet new install v této verzi sady .NET SDK.

Poznámka

Počínaje sadou .NET 7 SDK se změnila syntaxe dotnet new:

  • Možnosti --list, --search, --installa --uninstall se staly list, search, installa uninstall podpříkazy.
  • Možnost --update-apply se stala podpříkazem update.
  • Pokud chcete použít --update-check, použijte podpříkaz update s možností --check-only.

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

Kromě toho je nyní k dispozici dokončování tabulátoru pro dotnet new. Podporuje dokončování pro nainstalované názvy šablon a možnosti, které poskytuje vybraná šablona. Pokud chcete aktivovat dokončování karet pro sadu .NET SDK, přečtěte si téma Povolení dokončování tabulátoru.

Příklady staré syntaxe:

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

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

Výstraha

Šablony můžou při aktivaci spouštět kód MSBuild a další libovolný kód. Neinstalujte ani nespousívejte nedůvěryhodné šablony .NET.

Argumenty

  • <PATH|NUGET_ID>

    Složka v systému souborů nebo identifikátor balíčku NuGet pro instalaci balíčku šablony z. dotnet new se pokusí nainstalovat balíček NuGet ze zdrojů NuGet dostupných pro aktuální pracovní adresář a zdroje zadané prostřednictvím možnosti --add-source. 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>. (Oddělovač :: dvojtečky byl ve prospěch znaku @ v sadě .NET 9.0.200 SDK vyřazen.)

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é lze balíček nainstalovat. Pokud je zadán --nuget-source, zdroj se přidá do seznamu zdrojů, které se mají zkontrolovat. Ke kontrole nakonfigurovaných zdrojů pro aktuální adresář použijte dotnet nuget list source. Další informace najdete v tématu běžné konfigurace NuGet.

    Poznámka

    Po iniciativě NuGet Https všudedotnet new postupně ukončuje informační kanály http. Pokud se předá informační kanál http, nebude se dotazovat na balíčky a zobrazí se upozornění. Možnost --force lze v případě potřeby použít k přepsání tohoto chování.

  • -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 když by přepsaly balíček šablony z jiného zdroje. K dispozici od sady .NET SDK 7.0.100.

  • -?|-h|--help

    Vytiskne popis použití příkazu.

  • --interactive

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

  • -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 v tématu LoggerVerbosity.

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é

  • Last updated on