Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Det finns ett antal Aspire projektmallar tillgängliga för dig. Du kan använda dessa mallar för att skapa fullständiga Aspire lösningar eller lägga till enskilda projekt i befintliga Aspire lösningar.
Mallarna Aspire är tillgängliga i 📦Aspire. ProjectTemplates NuGet-paket .
Tillgängliga mallar
Med Aspire mallar kan du skapa nya appar som är förkonfigurerade med Aspire-lösningsstrukturen och standardinställningarna. De här projekten ger också en enhetlig felsökningsupplevelse för de olika resurserna i din app.
Aspire mallar är tillgängliga i två kategorier: lösningsmallar och projektmallar. Lösningsmallar skapar en ny Aspire lösning med flera projekt, medan projektmallar skapar enskilda projekt som kan läggas till i en befintlig Aspire lösning.
Lösningsmallar
Aspire Följande lösningsmallar är tillgängliga, anta att lösningen heter AspireSample:
Aspire Tom app: Ett minimalt 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 Aspire delat projekt för att hantera konfigurationer som återanvänds i projekt i din lösning som rör motståndskraft, tjänstidentifiering och telemetri.
Aspire Startapp: Utöver . AppHost och . ServiceDefaults-projekt , startappen Aspire innehåller även följande:
- AspireSample.ApiService: Ett minimaltASP.NET Core API-projekt används för att tillhandahålla data till klientdelen. Det här projektet är beroende av det delade Projektet AspireSample.ServiceDefaults .
- AspireSample.Web: Ett ASP.NET CoreBlazor appprojekt med standardtjänstkonfigurationer Aspire , det här projektet beror på projektet AspireSample.ServiceDefaults .
- AspireSample.Test: Antingen ett MSTest-, NUnit- eller xUnit-testprojekt med projektreferenser till AspireSample.AppHost och ett exempel WebTests.cs fil som demonstrerar ett integrationstest.
Projektmallar
Aspire Följande projektmallar är tillgängliga:
- Aspire AppHost: En fristående . AppHost-projekt som kan användas för att samordna och hantera de olika projekten och tjänsterna i din app.
Aspire Testprojekt: Dessa projektmallar används för att skapa testprojekt för din 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 Aspire AppHost-projekt.
- NUnit: Ett projekt som innehåller NUnit-integrering av ett Aspire AppHost-projekt.
- xUnit: Ett projekt som innehåller xUnit.net integrering av ett Aspire AppHost-projekt.
Mer information om testmallarna finns i Testa i Aspire.
Aspire Standardinställningar för tjänsten: En fristående . ServiceDefaults-projekt som kan användas för att hantera konfigurationer som återanvänds i projekt i din lösning som rör motståndskraft, tjänstidentifiering och telemetri.
Viktig
Standardprojektmallen för tjänsten har ett
FrameworkReferenceberoende avMicrosoft.AspNetCore.App. Detta kanske inte är idealiskt för vissa projekttyper. Mer information finns i Aspire standardinställningar för tjänsten.
Installera mallarna Aspire
Om du vill installera 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 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.4.0
Skapa lösningar och projekt med hjälp av mallar
Om du vill skapa en lösning eller ett Aspire projekt använder du Visual Studio, Visual Studio Codeeller .NET CLI och baserar den på tillgängliga mallar. Utforska ytterligare Aspire mallar i exempellagringsplatsenAspire.
Om du vill skapa ett 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 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 lösning eller ett Aspire projekt med hjälp av .NET CLI använder du det nya dotnet-kommandot och anger vilken mall du vill skapa. Tänk på följande exempel:
Så här skapar du ett grundläggande Aspire AppHost-projekt som riktar sig mot den senaste .NET versionen:
dotnet new aspire-apphost
Så här skapar du en Aspire startapp, som är en fullständig lösning med ett exempel på användargränssnittet och säkerhetskopierings-API:et:
dotnet new aspire-starter
Tips
Aspire mallar använder som standard den senaste .NET versionen, även när du använder en tidigare version av .NET CLI. Om du vill ange .NET versionen manuellt använder du --framework <tfm> alternativet, t.ex. för att skapa ett grundläggande Aspire AppHost-projekt med mål .NET 8:
dotnet new aspire-apphost --framework net8.0
Du måste lita på ASP.NET Corelocalhost certifikatet innan du kör appen. Kör följande kommando:
dotnet dev-certs https --trust
För mer information, se Felsökning av osäkert localhost certifikat i Aspire. Detaljerad information om hur du felsöker localhost-certifikat på Linux finns i ASP.NET Core: GitHub ärende i lagringsplatsen #32842.