modelli .NET.NET Aspire

Articolo
12/16/2024

Sono disponibili diversi modelli di progetto .NET.NET Aspire. È possibile usare questi modelli per creare soluzioni .NET Aspire complete o aggiungere singoli progetti alle soluzioni .NET Aspire esistenti.

I modelli di .NET.NET Aspire sono disponibili nel 📦Aspire. ProjectTemplates pacchetto NuGet.

Installare i modelli di .NET.NET Aspire

Per installare i modelli di .NET Aspire in Visual Studio, è necessario installarli manualmente, a meno che non si usi Visual Studio 17.12 o versione successiva. Per Visual Studio da 17.9 a 17.11, seguire questa procedura:

Aprire Visual Studio.
Vai a Strumenti >Gestione pacchetti NuGet>Console di gestione pacchetti.
Eseguire il comando seguente per installare i modelli:

dotnet new install Aspire.ProjectTemplates

Per Visual Studio 17.12 o versione successiva, i modelli di .NET Aspire vengono installati automaticamente.

Per installare questi modelli, utilizzare il comando dotnet new install, fornendo l'identificatore NuGet Aspire.ProjectTemplates.

dotnet new install Aspire.ProjectTemplates

Per installare una versione specifica, aggiungere il numero di versione al nome del pacchetto:

dotnet new install Aspire.ProjectTemplates::9.0.0

Suggerimento

Se hai già installato il carico di lavoro .NET.NET Aspire, devi passare il flag --force per sovrascrivere i modelli esistenti. Si può tranquillamente disinstallare il carico di lavoro .NET.NET Aspire.

Elencare i modelli di .NET.NET Aspire

I modelli di .NET Aspire vengono installati automaticamente quando si installa Visual Studio 17.9 o versione successiva. Per visualizzare i modelli di .NET.NET Aspire disponibili, selezionare File>Nuovo>Progetto in Visual Studioe cercare "Aspire" nella barra di ricerca (ALT+S). Verrà visualizzato un elenco dei modelli di progetto .NET.NET Aspire disponibili:

Per visualizzare i modelli disponibili in Visual Studio Code con il C# DevKit installato, selezionare il pulsante Crea progetto .NET quando non viene aperta alcuna cartella nella vista Explorer.

Cercare quindi "Aspire" nella barra di ricerca per visualizzare i modelli di progetto .NET Aspire disponibili:

Per verificare che i modelli di .NET.NET Aspire siano installati, usare il comando dotnet new list, passando il nome del modello aspire:

dotnet new list aspire

L'output della console dovrebbe essere simile al seguente:

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

Modelli disponibili

I modelli di .NET Aspire consentono di creare nuove app preconfigurati con la struttura delle soluzioni .NET Aspire e le impostazioni predefinite. Questi progetti offrono anche un'esperienza di debug unificata tra le diverse risorse dell'app.

.NET .NET Aspire modelli sono disponibili in due categorie: modelli di soluzione e modelli di progetto. I modelli di soluzione creano una nuova soluzione .NET Aspire con più progetti, mentre i modelli di progetto creano singoli progetti che possono essere aggiunti a una soluzione .NET Aspire esistente.

Modelli di soluzione

Sono disponibili i modelli di soluzione .NET.NET Aspire seguenti, si supponga che la soluzione sia denominata AspireSample:

.NET .NET Aspire'app vuota: un progetto di .NET.NET Aspire minimo che include quanto segue:
- AspireSample.AppHost: un progetto di orchestratore progettato per connettere e configurare i diversi progetti e servizi della tua app.
- AspireSample.ServiceDefaults: un progetto condiviso .NET.NET Aspire per gestire le configurazioni riutilizzate nei progetti nella soluzione correlata alla resilienza, 'individuazione del servizioe dati di telemetria.

.NET .NET Aspire Starter App: oltre ai progetti .AppHost e .ServiceDefaults, l'app .NET.NET Aspire Starter App include anche quanto segue:
- AspireSample.ApiService: un progetto ASP.NET Core API minimale viene usato per fornire dati al frontend. Questo progetto dipende dal progetto condiviso AspireSample.ServiceDefaults.
- AspireSample.Web: progetto di app con configurazioni di servizio predefinite, questo progetto dipende dal progetto AspireSample.ServiceDefaults.
- AspireSample.Test: un progetto di test MSTest, NUnito xUnit con riferimenti di progetto al AspireSample.AppHost e un file di esempio WebTests.cs che illustra un test di integrazione.

Modelli di progetto

Sono disponibili i modelli di progetto .NET.NET Aspire seguenti:

.NET .NET Aspire App Host: un progetto .AppHost autonomo che può essere usato per orchestrare e gestire i diversi progetti e servizi della tua app.

.NET .NET Aspire progetti di test: questi modelli di progetto vengono usati per creare progetti di test per l'app .NET.NET Aspire e sono destinati a rappresentare test funzionali e di integrazione. I progetti di test includono i modelli seguenti:
- MSTest: progetto che contiene l'integrazione MSTest di un progetto AppHost .NET.NET Aspire.
- NUnit: progetto che contiene l'integrazione NUnit di un progetto AppHost .NET.NET Aspire.
- Un progetto xUnit: un progetto che contiene l'integrazione di xUnit.net di un progetto AppHost .NET.NET Aspire.
Per altre informazioni sui modelli di test, vedere Testing in .NET.NET Aspire.

impostazioni predefinite del servizio .NET.NET Aspire: un progetto autonomo ServiceDefaults che può essere utilizzato per gestire le configurazioni riutilizzate nei vari progetti della vostra soluzione relativi a resilienza, individuazione del servizio e dati di telemetria .

Importante

Il modello di progetto predefinito del servizio accetta una dipendenza FrameworkReference da Microsoft.AspNetCore.App. Questo potrebbe non essere ideale per alcuni tipi di progetto. Per altre informazioni, vedere impostazioni predefinite del servizio .NET.NET Aspire.

Creare soluzioni e progetti usando modelli

Per creare una soluzione o un progetto .NET Aspire, usare Visual Studio, Visual Studio Codeo l'interfaccia della riga di comando di .NET e basarla sui modelli disponibili. Esplora ulteriori modelli .NET.NET Aspire nel repository di esempi .NET.NET Aspire.

Per creare un progetto di .NET Aspire usando Visual Studio, cercare Aspire nella finestra Visual Studio nuovo progetto e selezionare il modello desiderato.

Seguire le istruzioni per configurare il progetto o la soluzione dal modello e quindi selezionare Crea.

Per creare un progetto di .NET Aspire usando Visual Studio Code, cercare Aspire nella finestra Visual Studio Code nuovo progetto e selezionare il modello desiderato.

Selezionare il percorso desiderato, inserire un nome e selezionare Crea.

Per creare una soluzione o un progetto .NET Aspire usando l'interfaccia della riga di comando di .NET, usare il comando dotnet new e specificare il modello da creare. Si considerino gli esempi seguenti:

Per creare un progetto host dell'app .NET.NET Aspire di base destinato alla versione .NET più recente:

dotnet new aspire-apphost

Per creare un'app iniziale .NET.NET Aspire, che è una soluzione completa con un'interfaccia utente di esempio e un'API di backup inclusa:

dotnet new aspire-starter

Consiglio

I modelli di .NET Aspire predefiniti usano la versione .NET più recente, anche quando si utilizza una versione precedente dell'interfaccia della riga di comando di .NET. Per specificare manualmente la versione di .NET, usare l'opzione --framework <tfm>, ad esempio per creare un host dell'app .NET.NET Aspire di base progetto destinato a .NET 8:

dotnet new aspire-apphost --framework net8.0

Condividi tramite