şablonları .NET.NET Aspire

Kullanabileceğiniz bir dizi .NET.NET Aspire proje şablonu vardır. Bu şablonları kullanarak tam .NET Aspire çözümleri oluşturabilir veya mevcut .NET Aspire çözümlerine tek tek projeler ekleyebilirsiniz.

.NET .NET Aspire şablonları 📦Aspireiçinde kullanılabilir. ProjectTemplates NuGet paketi.

.NET .NET Aspire şablonlarını yükleme

dotnet new install Aspire.ProjectTemplates

dotnet new install Aspire.ProjectTemplates

dotnet new install Aspire.ProjectTemplates::9.0.0

.NET .NET Aspire şablonlarını listeleme

dotnet new list aspire

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

Kullanılabilir şablonlar

.NET Aspire şablonları, .NET Aspire çözümleri yapısı ve varsayılan ayarlarıyla önceden yapılandırılmış yeni uygulamalar oluşturmanıza olanak sağlar. Bu projeler, uygulamanızın farklı kaynakları arasında birleştirilmiş bir hata ayıklama deneyimi de sağlar.

.NET .NET Aspire şablonları iki kategoride kullanılabilir: çözüm şablonları ve proje şablonları. Çözüm şablonları birden çok projeyle yeni bir .NET Aspire çözümü oluştururken, proje şablonları mevcut bir .NET Aspire çözümüne eklenebilecek tek tek projeler oluşturur.

Çözüm şablonları

Aşağıdaki .NET.NET Aspire çözüm şablonları kullanılabilir, çözümün AspireSampleolarak adlandırıldığını varsayın:

• .NET .NET Aspire Boş Uygulama: Aşağıdakileri içeren en az .NET.NET Aspire proje:

  • AspireSample.AppHost: Uygulamanızın farklı projelerini ve hizmetlerini bağlamak ve yapılandırmak için tasarlanmış bir düzenleyici projesi.
  • AspireSample.ServiceDefaults: dayanıklılık, hizmet bulmave telemetriile ilgili olarak çözümünüzdeki projeler arasında yeniden kullanılan yapılandırmaları yönetmek için paylaşılan .NET.NET Aspire bir projedir.

• .NET .NET Aspire Başlangıç Uygulaması: AppHost ve ServiceDefaults projelerine ek olarak, .NET.NET Aspire Başlangıç Uygulaması ayrıca aşağıdakileri içerir:

  • AspireSample.ApiService: Ön uçta veri sağlamak için ASP.NET Core Minimal API projesi kullanılır. Bu proje, paylaşılan AspireSample.ServiceDefaultsprojesine bağlıdır.
  • AspireSample.Web: Varsayılan hizmet yapılandırmalarına sahip bir App projesi olan bu proje, aspireSample.ServiceDefaults projesine bağlıdır.
  • AspireSample.Test: Ya MSTest, NUnitya da xUnit test projesi ve AspireSample.AppHost'e proje başvuruları ile tümleştirme testini gösteren örnek bir WebTests.cs dosyası.

Proje şablonları

Aşağıdaki .NET.NET Aspire proje şablonları kullanılabilir:

• .NET .NET Aspire Uygulama Konağı: Tek başına . AppHost, uygulamanızın farklı proje ve hizmetlerini düzenleme ve yönetme amacıyla kullanılabilecek bir proje.

• .NET .NET Aspire Test projeleri: Bu proje şablonları, .NET.NET Aspire uygulamanız için test projeleri oluşturmak için kullanılır ve işlevsel ve tümleştirme testlerini temsil etmeye yöneliktir. Test projeleri aşağıdaki şablonları içerir:

  • MSTest: .NET.NET Aspire AppHost projesinin MSTest tümleştirmesini içeren bir proje.
  • NUnit: .NET.NET Aspire AppHost projesinin NUnit tümleştirmesini içeren bir proje.
  • xUnit: .NET.NET Aspire AppHost projesinin xUnit.net tümleştirmesini içeren bir proje.

  Test şablonları hakkında daha fazla bilgi için 'te Testine bakın.

• .NET .NET Aspire Hizmet Varsayılanları: Tek başına . ServiceDefaults, dayanıklılık, hizmet bulmave telemetri izlemeile ilgili çözümünüzdeki projelerde yapılandırmaların yeniden kullanımını yönetmek için kullanılabilecek bir projedir.

  Önemli

  Hizmet varsayılan proje şablonu, Microsoft.AspNetCore.Appüzerinde FrameworkReference bağımlılığı alır. Bu, bazı proje türleri için ideal olmayabilir. Daha fazla bilgi için bkz. .NET.NET Aspire hizmet varsayılanları.

Şablonları kullanarak çözüm ve proje oluşturma

.NET Aspire bir çözüm veya proje oluşturmak için Visual Studio, Visual Studio Codeveya .NET CLI kullanın ve bunu kullanılabilir şablonlara dayandırın. .NET .NET Aspire örnekleri deposundaki ek .NET.NET Aspire şablonlarını keşfedin.

dotnet new aspire-apphost

dotnet new aspire-starter

dotnet new aspire-apphost --framework net8.0

Ayrıca bkz.

• .NET .NET Aspire SDK
• .NET .NET Aspire kurulum ve araçlar ve süreçler
• 'da Testi