.NET .NET Aspire sablonok

Cikk
12/15/2024

Számos .NET.NET Aspire projektsablon érhető el. Ezekkel a sablonokkal teljes .NET Aspire megoldásokat hozhat létre, vagy egyéni projekteket adhat hozzá a meglévő .NET Aspire megoldásokhoz.

A .NET.NET Aspire sablonok a 📦Aspire.ProjectTemplates NuGet-csomagban érhetők el.

A .NET.NET Aspire-sablonok telepítése

A .NET Aspire-sablonok Visual Studiovaló telepítéséhez manuálisan kell telepítenie őket, kivéve, ha Visual Studio 17.12 vagy újabb verziót használ. A Visual Studio 17.9-tól 17.11-ig kövesse az alábbi lépéseket:

Nyissa meg Visual Studio.
Nyissa meg Eszközök>NuGet Package Manager>Csomagkezelő konzol.
Futtassa a következő parancsot a sablonok telepítéséhez:

dotnet new install Aspire.ProjectTemplates

A Visual Studio 17.12 vagy későbbi verziói esetén a .NET Aspire-sablonok telepítése automatikusan megtörténik.

A sablonok telepítéséhez használja a dotnet új telepítési parancsot, amely a Aspire.ProjectTemplates NuGet-azonosítót adja meg.

dotnet new install Aspire.ProjectTemplates

Egy adott verzió telepítéséhez fűzze hozzá a verziószámot a csomag nevéhez:

dotnet new install Aspire.ProjectTemplates::9.0.0

Borravaló

Ha már telepítve van a .NET.NET Aspire feladatkészlet, meg kell adnia a --force jelzőt a meglévő sablonok felülírásához. Nyugodtan távolítsa el a .NET.NET Aspire számítási feladatot.

A .NET.NET Aspire-sablonok listázása

A .NET Aspire-sablonok a 17.9-Visual Studio vagy újabb telepítésekor automatikusan települnek. Ha meg szeretné tekinteni, hogy milyen .NET.NET Aspire sablonok érhetők el, válassza Fájl>Új>Projekt lehetőséget a Visual Studio, és keresse meg a "Aspire" kifejezést a keresősávon (Alt+S). Megjelenik az elérhető .NET.NET Aspire projektsablonok listája:

Ha meg szeretné tekinteni a Visual Studio Code elérhető sablonjait a telepített C# DevKittel, válassza a .NET Project létrehozása gombot, ha a Explorer nézetben nem nyílik meg mappa:

Ezután keressen rá a "Aspire" kifejezésre a keresősávban az elérhető .NET Aspire projektsablonok megtekintéséhez:

A .NET.NET Aspire-sablonok telepítésének ellenőrzéséhez használja a dotnet új lista parancsot, amely a aspire sablon nevét adja meg:

dotnet new list aspire

A konzol kimenetének a következőképpen kell kinéznie:

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

Elérhető sablonok

A .NET Aspire sablonok lehetővé teszik, hogy a .NET Aspire-megoldások struktúrájával és alapértelmezett beállításaival előre konfigurált új alkalmazásokat hozzon létre. Ezek a projektek egységes hibakeresési élményt nyújtanak az alkalmazás különböző erőforrásai között.

.NET .NET Aspire sablonok két kategóriában érhetők el: megoldássablonok és projektsablonok. A megoldássablonok új .NET Aspire megoldást hoznak létre több projekttel, míg a projektsablonok egyéni projekteket hoznak létre, amelyek hozzáadhatók egy meglévő .NET Aspire-megoldáshoz.

Megoldássablonok

A következő .NET.NET Aspire megoldássablonok érhetők el, feltételezve, hogy a megoldás neve AspireSample:

.NET .NET Aspire Üres alkalmazás: Egy minimális .NET.NET Aspire projekt, amely a következőket tartalmazza:
- AspireSample.AppHost: Az alkalmazás különböző projektjeinek és szolgáltatásainak összekapcsolására és konfigurálására tervezett vezénylőprojekt.
- AspireSample.ServiceDefaults: Egy .NET.NET Aspire megosztott projekt, amely a megoldásban lévő projektekben újra felhasználható konfigurációkat kezeli a rugalmassági, szolgáltatásfelderítésiés telemetriai.

.NET .NET Aspire Starter App: A .AppHost és .ServiceDefaults projektek mellett a .NET.NET Aspire Starter App a következőket is tartalmazza:
- AspireSample.ApiService: A rendszer egy ASP.NET Core minimális API projekt segítségével szolgáltat adatokat a frontendnek. Ez a projekt az AspireSample.ServiceDefaults projekttől függ.
- AspireSample.Web: Egy ASP.NET CoreBlazor alkalmazás projekt alapértelmezett .NET.NET Aspire szolgáltatáskonfigurációkkal, ez a projekt az AspireSample.ServiceDefaults projekttől függ.
- AspireSample.Test: Vagy egy MSTest, NUnit, vagy xUnit tesztprojektet az AspireSample.AppHost projekthivatkozásaival, valamint egy WebTests.cs integrációs tesztet bemutató példafájllal.

Projektsablonok

A következő .NET.NET Aspire projektsablonok érhetők el:

.NET .NET Aspire alkalmazásgazda: Egy önálló .AppHost projekt, amely az alkalmazás különböző projektjeinek és szolgáltatásainak vezénylésére és kezelésére használható.

.NET .NET Aspire Projektek tesztelése: Ezek a projektsablonok a .NET.NET Aspire alkalmazás tesztprojektjeinek létrehozására szolgálnak, és funkcionális és integrációs tesztek megjelenítésére szolgálnak. A tesztprojektek a következő sablonokat tartalmazzák:
- MSTest: Egy .NET.NET Aspire AppHost-projekt MSTest-integrációját tartalmazó projekt.
- NUnit: Egy .NET.NET Aspire AppHost-projekt NUnit-integrációját tartalmazó projekt.
- xUnit: Egy .NET.NET Aspire AppHost-projekt xUnit.net integrációját tartalmazó projekt.
A tesztsablonokkal kapcsolatos további információkért lásd: Tesztelés .NET.NET Aspire.

.NET .NET Aspire szolgáltatás alapértelmezései: Önálló . ServiceDefaults projekt, amely rugalmassági, szolgáltatásfelderítésiés telemetriaikapcsolódó projektekben újra felhasználható konfigurációk kezelésére használható.

Fontos

A szolgáltatás alapértelmezett projektsablonja FrameworkReference típusú függőséget vesz fel a Microsoft.AspNetCore.App-re. Előfordulhat, hogy ez nem ideális egyes projekttípusokhoz. További információ: .NET.NET Aspire szolgáltatás alapértelmezései.

Megoldások és projektek létrehozása sablonok használatával

.NET Aspire megoldás vagy projekt létrehozásához használja a Visual Studio, Visual Studio Codevagy a .NET parancssori felületet, és az elérhető sablonok alapján készítse el. További .NET.NET Aspire sablonokat is megismerhet a .NET.NET Aspire minták adattárban.

Ha .NET Aspire projektet szeretne létrehozni Visual Studiohasználatával, keressen Aspire az Visual Studio új projektablakban, és válassza ki a kívánt sablont.

Kövesse az utasításokat a projekt vagy megoldás sablonból való konfigurálásához, majd válassza a létrehozása lehetőséget.

Ha .NET Aspire projektet szeretne létrehozni Visual Studio Codehasználatával, keressen Aspire az Visual Studio Code új projektablakban, és válassza ki a kívánt sablont.

Válassza ki a kívánt helyet, adjon meg egy nevet, majd válassza a létrehozása lehetőséget.

Ha .NET Aspire megoldást vagy projektet szeretne létrehozni a .NET parancssori felülettel, használja a dotnet új parancsát, és adja meg, hogy melyik sablont szeretné létrehozni. Vegye figyelembe a következő példákat:

Alapszintű .NET.NET Aspire alkalmazásgazda projekt létrehozásához a legújabb .NET verziót célozza:

dotnet new aspire-apphost

Egy .NET.NET Aspire kezdőalkalmazás létrehozása, amely egy teljes körű megoldás, amely tartalmaz egy minta felhasználói felületet és egy háttér API-t:

dotnet new aspire-starter

Borravaló

.NET Aspire sablonok alapértelmezés szerint a legújabb .NET verziót használják, még akkor is, ha a .NET parancssori felület egy korábbi verzióját használják. A .NET verziójának manuális megadásához használja a --framework <tfm> beállítást, például hozzon létre egy alapszintű .NET.NET Aspire alkalmazásgazda 8-.NET célprojektet:

dotnet new aspire-apphost --framework net8.0

Megosztás a következőn keresztül: