Sdílet prostřednictvím

dotnet new <TEMPLATE>

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

Název

dotnet new – Vytvoří nový projekt, konfigurační soubor nebo řešení na základě zadané šablony.

Synopse

dotnet new <TEMPLATE> [--dry-run] [--force] [-lang|--language {"C#"|"F#"|VB}]
    [-n|--name <OUTPUT_NAME>] [-f|--framework <FRAMEWORK>] [--no-update-check]
    [-o|--output <OUTPUT_DIRECTORY>] [--project <PROJECT_PATH>]
    [-d|--diagnostics] [--verbosity <LEVEL>] [Template options]

dotnet new -h|--help

Popis

Příkaz dotnet new vytvoří projekt .NET nebo jiné artefakty založené na šabloně.

Příkaz zavolá modul šablony, který vytvoří artefakty na disku na základě zadané šablony a možností.

Poznámka:

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

  • Z --list, , --search--installa --uninstall možnosti se staly list, searchinstall, a uninstall podpříkazy.
  • Možnost --update-apply se stala update podpříkazem.
  • Chcete-li 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 dostupné pro použití s příslušnými dílčími příkazy. Samostatná nápověda pro jednotlivé podpříkazy je k dispozici prostřednictvím -h možnosti nebo --help možnosti: 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.

Dokončování tabulátoru

Od sady .NET SDK 7.0.100 je k dispozici dokončování tabulátoru .dotnet new Podporuje dokončování pro nainstalované názvy šablon a také dokončení pro 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.

Implicitní obnovení

Nemusíte spouštětdotnet restore, protože se spouští implicitně všemi příkazy, které vyžadují obnovení, například dotnet new, , dotnet build, dotnet run, dotnet testdotnet publisha dotnet pack. Pokud chcete zakázat implicitní obnovení, použijte tuto --no-restore možnost.

Příkaz dotnet restore je stále užitečný v určitých scénářích, kdy explicitní obnovení dává smysl, například sestavení kontinuální integrace ve službě Azure DevOps Services nebo v systémech sestavení, které potřebují explicitně řídit, kdy dojde k obnovení.

Informace o správě informačních kanálů NuGet najdete v dotnet restore dokumentaci.

Argumenty

  • TEMPLATE

    Šablona, která vytvoří instanci při vyvolání příkazu. Každá šablona může mít konkrétní možnosti, které můžete předat. Další informace najdete v tématu Možnosti šablony.

    Spuštěním můžete dotnet new list zobrazit seznam všech nainstalovaných šablon.

    Příkaz search by se měl použít k hledání šablon v NuGet.org.

    Seznam šablon, které se dodávají se sadou .NET SDK, najdete v tématu Předinstalované šablony.

Možnosti

  • --dry-run

    Zobrazí souhrn toho, co by se stalo, kdyby se daný příkaz spustil, pokud by výsledkem vytvoření šablony.

  • --force

    Vynutí generování obsahu, i když by se změnily existující soubory. To se vyžaduje, když zvolená šablona přepíše existující soubory ve výstupním adresáři.

  • -?|-h|--help

    Vytiskne popis použití příkazu.

  • -lang|--language {C#|F#|VB}

    Jazyk šablony, který se má vytvořit. Jazyk, který je přijat, se liší podle šablony (viz výchozí hodnoty v oddílu argumentů ). Některé šablony nejsou platné.

    Poznámka:

    Některá prostředí se interpretují # jako speciální znak. V těchto případech uzavřete hodnotu parametru jazyka do uvozovek. Například dotnet new console -lang "F#".

  • -n|--name <OUTPUT_NAME>

    Název vytvořeného výstupu. Pokud není zadán žádný název, použije se název aktuálního adresáře.

  • -f|--framework <FRAMEWORK>

    Určuje cílovou architekturu. Očekává moniker cílové architektury (TFM). Příklady: net6.0, net7.0-macos. Tato hodnota se projeví v souboru projektu.

  • -no-update-check

    Zakáže kontrolu aktualizací balíčků šablon při vytváření instance šablony. K dispozici od sady .NET SDK 6.0.100. Při vytváření instance šablony z balíčku šablony, který byl nainstalován pomocí dotnet new --install, dotnet new zkontroluje, jestli pro šablonu existuje aktualizace. Počínaje rozhraním .NET 6 nejsou provedeny žádné kontroly aktualizací pro výchozí šablony .NET. Pokud chcete aktualizovat výchozí šablony .NET, nainstalujte verzi opravy sady .NET SDK.

  • -o|--output <OUTPUT_DIRECTORY>

    Umístění pro umístění vygenerovaného výstupu Výchozí je aktuální adresář.

  • --project <PROJECT_PATH>

    Projekt, do kterého je šablona přidána. Tento projekt se používá k vyhodnocení kontextu. Pokud není zadaný, použije se projekt v aktuálních nebo nadřazených adresářích. K dispozici od sady .NET SDK 7.0.100.

  • -d|--diagnostics

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

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

Možnosti šablony

Každá šablona může mít definované další možnosti. Další informace naleznete v tématu .NET výchozí šablony pro dotnet new.

Příklady

  • Vytvoření projektu konzolové aplikace jazyka C#:

    dotnet new console

  • V aktuálním adresáři vytvořte projekt konzolové aplikace jazyka F#:

    dotnet new console --language "F#"

  • V zadaném adresáři vytvořte projekt knihovny tříd .NET Standard 2.0:

    dotnet new classlib --framework "netstandard2.0" -o MyLibrary

  • V aktuálním adresáři vytvořte nový projekt ASP.NET Core C# MVC bez ověřování:

    dotnet new mvc -au None

  • Vytvořte nový projekt xUnit:

    dotnet new xunit

  • V aktuálním adresáři vytvořte global.json s nastavením verze sady SDK na 8.0.101:

    dotnet new globaljson --sdk-version 8.0.101 --roll-forward latestFeature

  • Zobrazit nápovědu pro šablonu konzolové aplikace jazyka C#:

    dotnet new console -h

  • Zobrazit nápovědu pro šablonu konzolové aplikace jazyka F#:

    dotnet new console --language "F#" -h

Viz také

  • Last updated on