dotnet new

Ten artykuł dotyczy: ✔️ zestawu .NET Core 2.0 SDK i jego nowszych wersji

Nazwa

dotnet new — Tworzy nowy projekt, plik konfiguracji lub rozwiązanie na podstawie określonego szablonu.

Streszczenie

dotnet new <TEMPLATE> [--dry-run] [--force] [-lang|--language {"C#"|"F#"|VB}]
    [-n|--name <OUTPUT_NAME>] [--no-update-check] [-o|--output <OUTPUT_DIRECTORY>] [Template options]

dotnet new -h|--help

Opis

Polecenie dotnet new tworzy projekt .NET lub inne artefakty na podstawie szablonu.

Polecenie wywołuje aparat szablonów, aby utworzyć artefakty na dysku na podstawie określonego szablonu i opcji.

Niejawne przywracanie

Nie trzeba uruchamiać programu dotnet restore , ponieważ jest on uruchamiany niejawnie przez wszystkie polecenia, które wymagają wykonania przywracania, takie jak,,,, dotnet new dotnet build dotnet run dotnet test dotnet publish i dotnet pack . Aby wyłączyć Przywracanie niejawne, użyj --no-restore opcji.

dotnet restorePolecenie jest nadal przydatne w niektórych scenariuszach, w których jawne jest przywracanie, takie jak kompilacje ciągłej integracji w Azure DevOps Services lub w systemach kompilacji, które muszą jawnie kontrolować po wystąpieniu przywracania.

Informacje o sposobach zarządzania źródłami danych NuGet znajdują się w dotnet restore dokumentacji.

Argumenty

  • TEMPLATE

    Szablon do wystąpienia podczas wywoływania polecenia. Każdy szablon może mieć określone opcje, które można przekazać. Aby uzyskać więcej informacji, zobacz Opcje szablonu.

    Możesz uruchomić program dotnet new --list , aby wyświetlić listę wszystkich zainstalowanych szablonów.

    Począwszy od zestawu SDK platformy .NET Core 3.0 i kończąc na zestawie .NET Core 5.0.300 SDK, interfejs wiersza polecenia wyszukuje szablony w NuGet.org po wywołaniu polecenia w następujących dotnet new warunkach:

    • Jeśli interfejs wiersza polecenia nie może znaleźć dopasowania szablonu podczas wywołania metody , nie dotnet new jest nawet częściowy.
    • Jeśli jest dostępna nowsza wersja szablonu. W takim przypadku projekt lub artefakt zostanie utworzony, ale interfejs wiersza polecenia ostrzega o zaktualizowanej wersji szablonu.

    Począwszy od zestawu .NET Core 5.0.300 SDK, należy użyć opcji do wyszukiwania szablonów w NuGet.org. --search

    W poniższej tabeli przedstawiono szablony, które są wstępnie instalowane z zestawem SDK platformy .NET. Domyślny język szablonu jest wyświetlany w nawiasach kwadratowych. Kliknij link z krótką nazwą, aby wyświetlić opcje określonego szablonu.

Szablony Krótka nazwa Język Tagi Wprowadzono
Aplikacja konsoli console [C#], F#, VB Common/Console 1.0
Biblioteka klas classlib [C#], F#, VB Wspólne/biblioteka 1.0
Aplikacja WPF wpf [C#], VB Common/WPF 3.0 (5.0 dla VB)
Biblioteka klas WPF wpflib [C#], VB Common/WPF 3.0 (5.0 dla VB)
Biblioteka kontrolek niestandardowych WPF wpfcustomcontrollib [C#], VB Common/WPF 3.0 (5.0 dla VB)
Biblioteka kontrolek użytkownika WPF wpfusercontrollib [C#], VB Common/WPF 3.0 (5.0 dla VB)
Windows Aplikacja formularzy (WinForms) winforms [C#], VB Common/WinForms 3.0 (5.0 dla VB)
Windows Biblioteka klas formularzy (WinForms) winformslib [C#], VB Common/WinForms 3.0 (5.0 dla VB)
Usługa procesu roboczego worker [C#] Wspólne/Proces roboczy/Sieć Web 3.0
Test jednostkowy Project mstest [C#], F#, VB Test/MSTest 1.0
Testowe testy NUnit 3 Project nunit [C#], F#, VB Test/NUnit 2.1.400
Element testowy NUnit 3 nunit-test [C#], F#, VB Test/NUnit 2,2
Test xUnit Test Project xunit [C#], F#, VB Test/xUnit 1.0
Razor, składnik razorcomponent [C#] Sieć Web/ASP.NET 3.0
Strona Razor page [C#] Sieć Web/ASP.NET 2.0
MVC ViewImports viewimports [C#] Sieć Web/ASP.NET 2.0
Widok MVCStart viewstart [C#] Sieć Web/ASP.NET 2.0
Blazor Aplikacja serwera blazorserver [C#] Sieć Web/Blazor 3.0
BlazorWebAssemblyAplikacja blazorwasm [C#] Sieć Web/Blazor/WebAssembly 3.1.300
ASP.NET Core Pusty web [C#], F # Sieć Web/puste 1.0
ASP.NET Core Aplikacja internetowa (Model-View-Controller) mvc [C#], F # Sieć Web/MVC 1.0
ASP.NET Core Aplikacja internetowa webapp, razor [C#] Web/MVC/Razor Pages 2.2, 2.0
ASP.NET Core z Angular angular [C#] Web/MVC/SPA 2.0
ASP.NET Core z React.js react [C#] Web/MVC/SPA 2.0
ASP.NET Core z React.js i Redux reactredux [C#] Web/MVC/SPA 2.0
Biblioteka klas Razor razorclasslib [C#] Biblioteka klas Web/Razor/Library/Razor 2.1
Internetowy interfejs API platformy ASP.NET Core webapi [C#], F # Web/WebAPI 1.0
ASP.NET Core usługi gRPC grpc [C#] Sieć Web/gRPC 3.0
dotnet gitignore file gitignore Config 3.0
plik global.json globaljson Config 2.0
NuGet Config nugetconfig Config 1.0
Plik manifestu narzędzia lokalnego Dotnet tool-manifest Config 3.0
Konfiguracja sieci Web webconfig Config 1.0
Plik rozwiązania sln Rozwiązanie 1.0
Plik buforu protokołu proto Sieć Web/gRPC 3.0
Plik EditorConfig editorconfig(dotnet-new-sdk-templates.md#editorconfig) Config 6.0

Opcje

  • --dry-run

    Przedstawia podsumowanie tego, co się stanie w przypadku uruchomienia danego polecenia w przypadku utworzenia szablonu. Dostępne od wersji .NET Core 2.2 SDK.

  • --force

    Wymusza wygenerowanie zawartości, nawet jeśli zmieniłoby to istniejące pliki. Jest to wymagane, gdy wybrany szablon zastąpi istniejące pliki w katalogu wyjściowym.

  • -?|-h|--help

    Drukuje pomoc dla polecenia. Można go wywołać dla samego dotnet new polecenia lub dla dowolnego szablonu. Na przykład dotnet new mvc --help.

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

    Język szablonu do utworzenia. Język akceptowany różni się w zależności od szablonu (zobacz ustawienia domyślne w sekcji argumentów). Nieprawidłowy w przypadku niektórych szablonów.

    Uwaga

    Niektóre powłoki są # interpretowane jako znak specjalny. W takich przypadkach należy ująć wartość parametru języka w cudzysłów. Na przykład dotnet new console -lang "F#".

  • -n|--name <OUTPUT_NAME>

    Nazwa utworzonych danych wyjściowych. Jeśli nie określono nazwy, używana jest nazwa bieżącego katalogu.

  • -no-update-check

    Wyłącza sprawdzanie aktualizacji pakietu szablonu podczas wystąpienia szablonu. Dostępne od wersji .NET 6.0.100 SDK. Podczas wystąpienia szablonu z pakietu szablonu, który został zainstalowany przy użyciu programu , program sprawdza, czy istnieje dotnet new --install dotnet new aktualizacja szablonu. Począwszy od programu .NET 6, nie są sprawdzane żadne aktualizacje szablonów domyślnych .NET. Aby zaktualizować szablony domyślne platformy .NET, zainstaluj wersję poprawkową zestawu .NET SDK.

  • -o|--output <OUTPUT_DIRECTORY>

    Lokalizacja do umieszczenie wygenerowanych danych wyjściowych. Ustawieniem domyślnym jest bieżący katalog.

Opcje szablonu

Każdy szablon może mieć zdefiniowane dodatkowe opcje. Aby uzyskać więcej informacji, zobacz .NET default templates for dotnet new .

Przykłady

  • Utwórz projekt aplikacji konsolowej C#:

    dotnet new console
    
  • Utwórz projekt aplikacji konsolowej F# w bieżącym katalogu:

    dotnet new console --language "F#"
    
  • Utwórz projekt biblioteki .NET Standard 2.0 w określonym katalogu:

    dotnet new classlib --framework "netstandard2.0" -o MyLibrary
    
  • Utwórz nowy projekt ASP.NET Core MVC języka C# w bieżącym katalogu bez uwierzytelniania:

    dotnet new mvc -au None
    
  • Utwórz nowy projekt xUnit:

    dotnet new xunit
    
  • Utwórz kod global.json w bieżącym katalogu, ustawiając wersję zestawu SDK na 3.1.101:

    dotnet new globaljson --sdk-version 3.1.101
    
  • Pokaż pomoc dla szablonu aplikacji konsolowej C#:

    dotnet new console -h
    
  • Pokaż pomoc dla szablonu aplikacji konsolowej F#:

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

Zobacz też