szablony .NET.NET Aspire
Dostępnych jest wiele szablonów projektów .NET.NET Aspire. Te szablony umożliwiają tworzenie pełnych rozwiązań .NET Aspire lub dodawanie poszczególnych projektów do istniejących rozwiązań .NET Aspire.
Szablony .NET.NET Aspire są dostępne w 📦Aspire.ProjectTemplates pakietu NuGet.
Instalowanie szablonów .NET.NET Aspire
Aby zainstalować szablony .NET Aspire w Visual Studio, należy zainstalować je ręcznie, chyba że używasz Visual Studio 17.12 lub nowszej. W przypadku Visual Studio 17.9 do 17.11 wykonaj następujące kroki:
- Otwórz Visual Studio.
- Przejdź do Narzędzia>Menedżer pakietów NuGet>Konsola menedżera pakietów.
- Uruchom następujące polecenie, aby zainstalować szablony:
dotnet new install Aspire.ProjectTemplates
W przypadku Visual Studio 17.12 lub nowszego szablony .NET Aspire są instalowane automatycznie.
Aby zainstalować te szablony, użyj polecenia dotnet new install, przekazując identyfikator Aspire.ProjectTemplates NuGet.
dotnet new install Aspire.ProjectTemplates
Aby zainstalować określoną wersję, dołącz numer wersji do nazwy pakietu:
dotnet new install Aspire.ProjectTemplates::9.0.0
Napiwek
Jeśli masz już zainstalowane obciążenie .NET.NET Aspire, należy użyć flagi --force w celu zastąpienia istniejących szablonów. Możesz śmiało odinstalować pakiet zadań .NET.NET Aspire.
Wyświetlanie listy szablonów .NET.NET Aspire
Szablony .NET Aspire są instalowane automatycznie podczas instalowania Visual Studio wersji 17.9 lub nowszej. Aby zobaczyć, jakie szablony .NET.NET Aspire są dostępne, wybierz pozycję Plik>Nowy>Projekt w Visual Studioi wyszukaj ciąg "Aspire" na pasku wyszukiwania (Alt+S). Zostanie wyświetlona lista dostępnych szablonów projektów .NET.NET Aspire:
Aby wyświetlić dostępne szablony w programie
Następnie wyszukaj ciąg "Aspire" na pasku wyszukiwania, aby wyświetlić dostępne szablony projektów .NET Aspire:
Aby sprawdzić, czy szablony .NET.NET Aspire są zainstalowane, użyj polecenia dotnet new list, przekazując nazwę szablonu aspire:
dotnet new list aspire
Dane wyjściowe konsoli powinny wyglądać następująco:
dotnet new list aspire
These templates matched your input: 'aspire'
Template Name Short Name Language Tags
--------------------------------- ---------------------- -------- -------------------------------------------------------
.NET Aspire App Host aspire-apphost [C#] Common/.NET Aspire/Cloud
.NET Aspire Empty App aspire [C#] Common/.NET Aspire/Cloud/Web/Web API/API/Service
.NET Aspire Service Defaults aspire-servicedefaults [C#] Common/.NET Aspire/Cloud/Web/Web API/API/Service
.NET Aspire Starter App aspire-starter [C#] Common/.NET Aspire/Blazor/Web/Web API/API/Service/Cloud
.NET Aspire Test Project (MSTest) aspire-mstest [C#] Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
.NET Aspire Test Project (NUnit) aspire-nunit [C#] Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
.NET Aspire Test Project (xUnit) aspire-xunit [C#] Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
Dostępne szablony
Szablony .NET Aspire umożliwiają tworzenie nowych aplikacji wstępnie skonfigurowanych za pomocą struktury rozwiązań .NET Aspire i ustawień domyślnych. Te projekty zapewniają również ujednolicone środowisko debugowania w różnych zasobach aplikacji.
szablony .NET.NET Aspire są dostępne w dwóch kategoriach: szablony rozwiązań i szablony projektów. Szablony rozwiązań tworzą nowe rozwiązanie .NET Aspire z wieloma projektami, a szablony projektów tworzą poszczególne projekty, które można dodać do istniejącego rozwiązania .NET Aspire.
Szablony rozwiązań
Dostępne są następujące szablony rozwiązań .NET.NET Aspire, załóżmy, że rozwiązanie nosi nazwę AspireSample:
.NET .NET Aspire Empty App: minimalny projekt .NET.NET Aspire obejmujący następujące elementy:
- AspireSample.AppHost: projekt orkiestratora zaprojektowany pod kątem łączenia i konfigurowania różnych projektów i usług aplikacji.
- AspireSample.ServiceDefaults: projekt współdzielony .NET.NET Aspire do zarządzania konfiguracjami ponownie używanymi w projektach w twoim rozwiązaniu, związanych z odpornością , odnajdywaniem usługi i telemetrią .
.NET .NET Aspire aplikacja startowa: oprócz projektów .AppHost i .ServiceDefaults, aplikacja startowa .NET.NET Aspire obejmuje również następujące elementy:
- AspireSample.ApiService: minimalny projektASP.NET CoreAPI jest używany do udostępniania danych frontendowi. Ten projekt zależy od udostępnionego projektu AspireSample.ServiceDefaults.
AspireSample.Web : projekt aplikacjiz domyślnymi konfiguracjami usługi , ten projekt zależy od projektu AspireSample.ServiceDefaults - AspireSample.Test: Albo projekt testów z MSTest, NUnitlub xUnit z odniesieniami do projektów AspireSample.AppHost oraz przykładowy plik WebTests.cs demonstrujący test integracji.
Szablony projektów
Dostępne są następujące szablony projektów .NET.NET Aspire:
- .NET .NET Aspire Host aplikacji: autonomiczny . AppHost projekt, który może służyć do organizowania różnych projektów i usług aplikacji oraz zarządzania nimi.
.NET .NET Aspire projekty testowe: te szablony projektów są używane do tworzenia projektów testowych dla aplikacji .NET.NET Aspire i mają one reprezentować testy funkcjonalne i integracyjne. Projekty testowe obejmują następujące szablony:
- MSTest: projekt zawierający integrację MSTest projektu .NET.NET Aspire AppHost.
- NUnit: projekt zawierający integrację NUnit projektu .NET.NET Aspire AppHost.
- xUnit: projekt zawierający integrację xUnit.net projektu .NET.NET Aspire AppHost.
Aby uzyskać więcej informacji na temat szablonów testów, zobacz Testing in .NET.NET Aspire.
.NET .NET Aspire Domyślne ustawienia usługi: autonomiczny projekt .ServiceDefaults, który można wykorzystać do zarządzania konfiguracjami używanymi w projektach w twoim rozwiązaniu, związanymi z odpornością na awarie , odkrywaniem usług oraz zbieraniem danych telemetrycznych .
Ważny
Szablon projektu domyślnego usługi przyjmuje zależność
FrameworkReferenceodMicrosoft.AspNetCore.App. Może to nie być idealne dla niektórych typów projektów. Aby uzyskać więcej informacji, zobacz ustawienia domyślne usługi .NET.NET Aspire.
Tworzenie rozwiązań i projektów przy użyciu szablonów
Aby utworzyć rozwiązanie lub projekt .NET Aspire, użyj Visual Studio, Visual Studio Codelub interfejsu wiersza polecenia .NET i bazuj na dostępnych szablonach. Zapoznaj się z dodatkowymi szablonami .NET.NET Aspire w repozytorium przykładów .NET.NET Aspire.
Aby utworzyć projekt .NET Aspire przy użyciu Visual Studio, wyszukaj Aspire w oknie Visual Studio nowego projektu i wybierz odpowiedni szablon.
Postępuj zgodnie z monitami, aby skonfigurować projekt lub rozwiązanie z szablonu, a następnie wybierz pozycję Utwórz.
Aby utworzyć projekt .NET Aspire przy użyciu Visual Studio Code, wyszukaj Aspire w oknie Visual Studio Code nowego projektu i wybierz odpowiedni szablon.
Wybierz żądaną lokalizację, wprowadź nazwę i wybierz Utwórz.
Aby utworzyć rozwiązanie .NET Aspire lub projekt przy użyciu interfejsu wiersza polecenia .NET, użyj polecenia dotnet new i wskaż, który szablon chcesz utworzyć. Rozważmy następujące przykłady:
Aby utworzyć podstawowy projekt .NET.NET Aspire host aplikacji przeznaczony dla najnowszej wersji .NET:
dotnet new aspire-apphost
Aby utworzyć aplikację startową .NET.NET Aspire, która jest pełnym rozwiązaniem z przykładowym interfejsem użytkownika i interfejsem API tworzenia kopii zapasowych:
dotnet new aspire-starter
Napiwek
Domyślnie, szablony .NET Aspire używają najnowszej wersji .NET, nawet jeśli korzysta się ze starszej wersji CLI .NET. Aby ręcznie określić wersję .NET, użyj opcji --framework <tfm>, np. aby utworzyć podstawowy host aplikacji .NET.NET Aspire przeznaczony dla projektu .NET 8:
dotnet new aspire-apphost --framework net8.0
Zobacz też
- .NET .NET Aspire zestaw SDK
- .NET .NET Aspire konfiguracja i narzędzia
- Testowanie w .NET.NET Aspire
