šablony .NET.NET Aspire
K dispozici je celá řada .NET.NET Aspire šablon projektů. Pomocí těchto šablon můžete vytvářet úplná .NET Aspire řešení nebo přidávat jednotlivé projekty do existujících .NET Aspire řešení.
Šablony .NET.NET Aspire jsou k dispozici v 📦Aspire. ProjectTemplates balíčku NuGet.
Dostupné šablony
Šablony .NET Aspire umožňují vytvářet nové aplikace předem nakonfigurované se strukturou řešení .NET Aspire a výchozím nastavením. Tyto projekty také poskytují jednotné prostředí ladění napříč různými prostředky vaší aplikace.
.NET .NET Aspire šablony jsou k dispozici ve dvou kategoriích: šablony řešení a šablony projektů. Šablony řešení vytvářejí nové řešení .NET Aspire s více projekty, zatímco šablony projektů vytvářejí jednotlivé projekty, které je možné přidat do existujícího řešení .NET Aspire.
Šablony řešení
K dispozici jsou následující .NET.NET Aspire šablony řešení, předpokládejme, že řešení má název AspireSample:
.NET .NET Aspire Prázdná aplikace: Minimální .NET.NET Aspire projekt, který obsahuje následující:
- AspireSample.AppHost: Projekt orchestrátoru navržený pro připojení a konfiguraci různých projektů a služeb vaší aplikace.
- AspireSample.ServiceDefaults: Sdílený projekt .NET.NET Aspire ke správě konfigurací, které se znovu používají napříč projekty ve vašem řešení související s odolností, zjišťováním službya telemetrií.
.NET .NET Aspire úvodní aplikace: Kromě projektů .AppHost a .ServiceDefaults obsahuje úvodní aplikace .NET.NET Aspire také následující:
- AspireSample.ApiService: K poskytování dat front-endu se používá ASP.NET Core minimální projekt rozhraní API. Tento projekt závisí na sdíleném projektu AspireSample.ServiceDefaults.
AspireSample.Web : Tento projekt aplikaces výchozími konfiguracemi služby závisí na projektu .AspireSample.ServiceDefaults - AspireSample.Test: Buď testovací projekt MSTest, NUnit nebo xUnit s projektem odkazujícím na AspireSample.AppHost a ukázkový soubor WebTests.cs demonstrující integrační test.
Šablony projektů
K dispozici jsou následující .NET.NET Aspire šablony projektů:
- .NET .NET Aspire App Host: Samostatný . AppHost projektu, který se dá použít k orchestraci a správě různých projektů a služeb vaší aplikace.
.NET .NET Aspire projekty testování: Tyto šablony projektů slouží k vytváření testovacích projektů pro vaši .NET.NET Aspire aplikaci a jsou určené k reprezentaci funkčních a integračních testů. Mezi testovací projekty patří následující šablony:
- MSTest: Projekt, který obsahuje integraci MSTest projektu .NET.NET Aspire AppHost.
- NUnit: Projekt, který obsahuje integraci NUnit projektu .NET.NET Aspire AppHost.
- xUnit: Projekt, který obsahuje xUnit.net integraci projektu .NET.NET Aspire AppHost.
Další informace o testovacích šablonách naleznete v tématu Testování v .NET.NET Aspire.
Výchozí nastaveníslužby
: Samostatný projekt .ServiceDefaults , který lze použít ke správě konfigurací, které se opakovaně využívají v různých projektech ve vašem řešení, související sodolností ,objevováním služeb atelemetrií .Důležitý
Výchozí šablona projektu služby využívá
FrameworkReference
závislost naMicrosoft.AspNetCore.App
. To nemusí být ideální pro některé typy projektů. Další informace o výchozím nastavení služby najdete v tématech .NET.NET Aspire.
Vytváření řešení a projektů pomocí šablon
Pokud chcete vytvořit .NET Aspire řešení nebo projekt, použijte Visual Studio, Visual Studio Codenebo rozhraní příkazového řádku .NET a založte ho na dostupných šablonách. Prozkoumejte další .NET.NET Aspire šablony v .NET.NET Aspire ukázkách úložišti.
Pokud chcete vytvořit .NET Aspire projekt pomocí Visual Studio, vyhledejte Aspire v okně Visual Studio novém projektu a vyberte požadovanou šablonu.
Podle pokynů nakonfigurujte projekt nebo řešení ze šablony a pak vyberte Vytvořit.
Pokud chcete vytvořit .NET Aspire projekt pomocí Visual Studio Code, vyhledejte Aspire v okně Visual Studio Code novém projektu a vyberte požadovanou šablonu.
Vyberte požadované umístění, zadejte název a vyberte Vytvořit.
Pokud chcete vytvořit .NET Aspire řešení nebo projekt pomocí .NET CLI, použijte příkaz dotnet new a zadejte šablonu, kterou chcete vytvořit. Podívejte se na následující příklady:
Chcete-li vytvořit základní projekt hostitele aplikace .NET.NET Aspire, který cílí na nejnovější verzi .NET:
dotnet new aspire-apphost
Pokud chcete vytvořit .NET.NET Aspire startovací aplikaci, což je úplné řešení s ukázkovým uživatelským rozhraním a podpůrným API:
dotnet new aspire-starter
Tip
.NET Aspire šablony standardně používají nejnovější verzi .NET, i když používáte starší verzi .NET rozhraní příkazového řádku. Pokud chcete ručně zadat verzi .NET, použijte možnost --framework <tfm>
, například pro vytvoření základního hostitele aplikace projektu .NET.NET Aspire zaměřeného na .NET 8:
dotnet new aspire-apphost --framework net8.0