Dela via


Aspire Mallar

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:

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 FrameworkReference beroende av Microsoft.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:

  1. Öppna Visual Studio.
  2. Gå till Tools>NuGet Package Manager>Package Manager Console.
  3. 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.

Visual Studio: Aspire mallar.

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.

Visual Studio Code: Aspire mallar.

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.

Se även