.NET .NET Aspire mallar

Artikel
12/16/2024

Det finns ett antal .NET.NET Aspire projektmallar tillgängliga för dig. Du kan använda dessa mallar för att skapa fullständiga .NET Aspire lösningar eller lägga till enskilda projekt i befintliga .NET Aspire lösningar.

De .NET.NET Aspire mallarna är tillgängliga i 📦Aspire. ProjectTemplates NuGet-paket.

Installera .NET.NET Aspire-mallarna

Om du vill installera .NET Aspire mallar i Visual Studiomåste du installera dem manuellt om du inte använder Visual Studio 17.12 eller senare. Följ dessa steg för Visual Studio 17.9 till 17.11:

Öppna Visual Studio.
Gå till Tools>NuGet Package Manager>Package Manager Console.
Kör följande kommando för att installera mallarna:

dotnet new install Aspire.ProjectTemplates

För Visual Studio 17.12 eller senare installeras .NET Aspire-mallarna automatiskt.

Om du vill installera dessa mallar använder du kommandot dotnet new install genom att ange Aspire.ProjectTemplates NuGet-identifierare.

dotnet new install Aspire.ProjectTemplates

Om du vill installera en viss version lägger du till versionsnumret i paketnamnet:

dotnet new install Aspire.ProjectTemplates::9.0.0

Tips

Om du redan har arbetsbelastningen .NET.NET Aspire installerad måste du använda flaggan --force för att skriva över befintliga mallar. Du kan gärna avinstallera arbetsuppgiften .NET.NET Aspire.

Visa en lista över .NET.NET Aspire mallar

.NET Aspire-mallarna installeras automatiskt när du installerar Visual Studio 17.9 eller senare. Om du vill se vilka .NET.NET Aspire mallar som är tillgängliga väljer du File>New>Project i Visual Studiooch söker efter "Aspire" i sökfältet (Alt+S). Du ser en lista över tillgängliga .NET.NET Aspire projektmallar:

Om du vill visa tillgängliga mallar i Visual Studio Code med C# DevKit installerat väljer du knappen Skapa .NET Project när ingen mapp öppnas i Explorer vy:

Sök sedan efter "Aspire" i sökfältet för att se tillgängliga .NET Aspire projektmallar:

Om du vill kontrollera att .NET.NET Aspire mallar är installerade använder du kommandot dotnet new list och skickar aspire mallnamn:

dotnet new list aspire

Konsolens utdata bör se ut så här:

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

Tillgängliga mallar

Med .NET Aspire mallar kan du skapa nya appar som är förkonfigurerade med .NET Aspire-lösningsstrukturen och standardinställningarna. De här projekten ger också en enhetlig felsökningsupplevelse för de olika resurserna i din app.

.NET .NET Aspire mallar finns i två kategorier: lösningsmallar och projektmallar. Lösningsmallar skapar en ny .NET Aspire lösning med flera projekt, medan projektmallar skapar enskilda projekt som kan läggas till i en befintlig .NET Aspire lösning.

Lösningsmallar

Följande .NET.NET Aspire lösningsmallar är tillgängliga, förutsätter att lösningen heter AspireSample:

.NET .NET Aspire Empty App: Ett minimalt .NET.NET Aspire projekt som innehåller följande:
- AspireSample.AppHost: Ett orchestrator-projekt som är utformat för att ansluta och konfigurera de olika projekten och tjänsterna i din app.
- AspireSample.ServiceDefaults: Ett .NET.NET Aspire delat projekt för att hantera konfigurationer som återanvänds i projekt i din lösning som rör motståndskraft, tjänstidentifieringoch telemetri.

.NET .NET Aspire Starter App: Förutom . AppHost och . ServiceDefaults projekt innehåller .NET.NET Aspire Starter-appen även följande:
- AspireSample.ApiService: Ett ASP.NET Core minimalt API--projekt används för att tillhandahålla data till klientdelen. Det här projektet beror på den delade AspireSample.ServiceDefaults projektet.
- AspireSample.Web: Ett ASP.NET CoreBlazor Applikation-projekt med standardkonfigurationer för .NET.NET Aspire tjänstekonfigurationer: det här projektet beror på AspireSample.ServiceDefaults projektet.
- AspireSample.Test: Antingen ett MSTest, NUniteller xUnit testprojekt med projektreferenser till AspireSample.AppHost och ett exempel WebTests.cs fil som visar ett integrationstest.

Projektmallar

Följande .NET.NET Aspire projektmallar är tillgängliga:

.NET .NET Aspire App Host: Ett fristående .AppHost-projekt som kan användas för att orkestrera och hantera de olika projekten och tjänsterna i din app.

.NET .NET Aspire Test projects: Dessa projektmallar används för att skapa testprojekt för din .NET.NET Aspire app och de är avsedda att representera funktionella tester och integreringstester. Testprojekten innehåller följande mallar:
- MSTest: Ett projekt som innehåller MSTest-integrering av ett .NET.NET Aspire AppHost-projekt.
- NUnit: Ett projekt som innehåller NUnit-integrering av ett .NET.NET Aspire AppHost-projekt.
- xUnit: Ett projekt som innehåller xUnit.net integrering av ett .NET.NET Aspire AppHost-projekt.
Mer information om testmallarna finns i Testing in .NET.NET Aspire.

.NET .NET Aspire Service Defaults: En fristående .ServiceDefaults-projekt som kan användas för att hantera konfigurationer som återanvänds i projekten inom din lösning relaterade till motståndskraft, tjänsteupptäcktoch telemetri.

Viktig

Standardprojektmallen för tjänsten har ett FrameworkReference beroende av Microsoft.AspNetCore.App. Detta kanske inte är idealiskt för vissa projekttyper. För mer information, se standardvärden för .NET.NET Aspire tjänst.

Skapa lösningar och projekt med hjälp av mallar

Om du vill skapa en .NET Aspire lösning eller ett projekt använder du Visual Studio, Visual Studio Codeeller .NET CLI och baserar den på tillgängliga mallar. Utforska fler .NET.NET Aspire mallar i förvaringsplatsen för .NET.NET Aspire exempel.

Om du vill skapa ett .NET Aspire projekt med hjälp av Visual Studiosöker du efter Aspire i det Visual Studio nya projektfönstret och väljer önskad mall.

Följ anvisningarna för att konfigurera projektet eller lösningen från mallen och välj sedan Skapa.

Om du vill skapa ett .NET Aspire projekt med hjälp av Visual Studio Codesöker du efter Aspire i det Visual Studio Code nya projektfönstret och väljer önskad mall.

Välj önskad plats, ange ett namn och välj Skapa.

Om du vill skapa en .NET Aspire lösning eller ett projekt med hjälp av .NET CLI använder du kommandot dotnet new och anger vilken mall du vill skapa. Tänk på följande exempel:

Så här skapar du ett grundläggande .NET.NET Aspire-appvärdsprojekt som riktar sig mot den senaste versionen av .NET.

dotnet new aspire-apphost

För att skapa en .NET.NET Aspire startapp, som är en heltäckande lösning med ett exempel på användargränssnitt och stöd-API:

dotnet new aspire-starter

Tips

.NET Aspire mallar använder som standard den senaste .NET versionen, även när du använder en tidigare version av .NET CLI. Om du manuellt vill ange .NET-versionen, använd alternativet --framework <tfm>, t.ex. för att skapa ett grundläggande .NET.NET Aspire appvärd-projekt med inriktning på .NET 8:

dotnet new aspire-apphost --framework net8.0

Dela via