šablony .NET.NET Aspire

Článek
12/13/2024

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.

Instalace šablon .NET.NET Aspire

Pokud chcete šablony .NET Aspire nainstalovat do Visual Studio, musíte je nainstalovat ručně, pokud nepoužíváte Visual Studio 17.12 nebo novější. Pro Visual Studio 17.9 až 17.11 postupujte takto:

Otevřete Visual Studio.
Přejděte na Tools>Správce balíčků NuGet>konzoly Správce balíčků.
Spuštěním následujícího příkazu nainstalujte šablony:

dotnet new install Aspire.ProjectTemplates

Pro Visual Studio 17.12 nebo novější se šablony .NET Aspire nainstalují automaticky.

Pokud chcete tyto šablony nainstalovat, použijte příkaz dotnet new install a předejte identifikátor NuGet Aspire.ProjectTemplates.

dotnet new install Aspire.ProjectTemplates

Pokud chcete nainstalovat konkrétní verzi, připojte číslo verze k názvu balíčku:

dotnet new install Aspire.ProjectTemplates::9.0.0

Spropitné

Pokud už máte nainstalovanou .NET.NET Aspire úlohu, musíte předat příznak --force pro přepsání existujících šablon. Klidně odinstalujte pracovní zátěž .NET.NET Aspire.

Zobrazení seznamu šablon .NET.NET Aspire

Šablony .NET Aspire se nainstalují automaticky při instalaci Visual Studio 17.9 nebo novější. Pokud chcete zjistit, jaké .NET.NET Aspire šablony jsou k dispozici, vyberte Soubor>Nový>Projekt v Visual Studioa na panelu hledání vyhledejte "Aspire" (Alt+S). Zobrazí se seznam dostupných šablon projektů .NET.NET Aspire:

Pokud chcete zobrazit dostupné šablony v Visual Studio Code s nainstalovanou sadou C# DevKit, vyberte tlačítko Vytvořit .NET Project, když není v zobrazení Explorer otevřena žádná složka:

Pak na panelu hledání vyhledejte "Aspire", abyste viděli dostupné šablony projektů .NET Aspire:

Pokud chcete ověřit, že jsou nainstalované šablony .NET.NET Aspire, použijte příkaz dotnet new list a předejte název šablony aspire:

dotnet new list aspire

Výstup konzoly by měl vypadat takto:

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

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 aplikace s výchozími konfiguracemi služby závisí na projektu AspireSample.ServiceDefaults.
- AspireSample.Test:MSTest , NUnitnebo xUnit testovací projekt s odkazy na projekt s odkazy 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í s odolností, objevováním služeba telemetrií.

Důležitý

Výchozí šablona projektu služby přebírá FrameworkReference závislost na Microsoft.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

Sdílet prostřednictvím