Шаблоны .NET.NET Aspire

Статья
12/15/2024

Существует ряд доступных шаблонов проектов .NET.NET Aspire. Эти шаблоны можно использовать для создания полных .NET Aspire решений или добавления отдельных проектов в существующие решения .NET Aspire.

Шаблоны .NET.NET Aspire доступны в 📦Aspireпакете NuGet ProjectTemplates.

Установка шаблонов .NET.NET Aspire

Чтобы установить шаблоны .NET Aspire в Visual Studio, их необходимо установить вручную, если вы не используете Visual Studio 17.12 или более поздней версии. Чтобы выполнять действия Visual Studio 17.9–17.11, следуйте этим шагам:

Откройте Visual Studio.
Перейдите к Tools>Диспетчер пакетов NuGet>Консоль диспетчера пакетов.
Выполните следующую команду, чтобы установить шаблоны:

dotnet new install Aspire.ProjectTemplates

Для Visual Studio версии 17.12 или более поздней версии автоматически устанавливаются шаблоны .NET Aspire.

Чтобы установить эти шаблоны, используйте команду dotnet new install, передавая идентификатор NuGet Aspire.ProjectTemplates.

dotnet new install Aspire.ProjectTemplates

Чтобы установить определенную версию, добавьте номер версии в имя пакета:

dotnet new install Aspire.ProjectTemplates::9.0.0

Совет

Если у вас уже установлена нагрузка .NET.NET Aspire, необходимо передать флаг --force для перезаписи существующих шаблонов. Вы можете смело удалить рабочую нагрузку .NET.NET Aspire.

Список шаблонов .NET.NET Aspire

Шаблоны .NET Aspire устанавливаются автоматически при установке Visual Studio 17.9 или более поздней версии. Чтобы узнать, какие шаблоны .NET.NET Aspire доступны, выберите Файл>Создать>Проект в Visual Studioи найдите "Aspire" в строке поиска (ALT+S). Вы увидите список доступных шаблонов проектов .NET.NET Aspire:

Чтобы просмотреть доступные шаблоны в с установленной программой C# DevKit, нажмите кнопку Create Project, если папка не открыта в обозревателе :

Затем найдите "Aspire" в строке поиска, чтобы просмотреть доступные шаблоны проектов .NET Aspire:

Чтобы убедиться, что установлены шаблоны .NET.NET Aspire, используйте команду dotnet new list, передав имя шаблона aspire:

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

Доступные шаблоны

Шаблоны .NET Aspire позволяют создавать приложения, предварительно настроенные с помощью структуры решений .NET Aspire и параметров по умолчанию. Эти проекты также предоставляют единый интерфейс отладки в разных ресурсах приложения.

.NET .NET Aspire шаблоны доступны в двух категориях: шаблоны решений и шаблоны проектов. Шаблоны решений создают новое решение .NET Aspire с несколькими проектами, а шаблоны проектов создают отдельные проекты, которые можно добавить в существующее решение .NET Aspire.

Шаблоны решений

Доступны следующие шаблоны решений .NET.NET Aspire, предположим, что решение называется AspireSample:

.NET .NET Aspire Пустое приложение: минимальный проект .NET.NET Aspire, который включает в себя следующее:
- AspireSample.AppHost: проект оркестратора, предназначенный для настройки и подключения различных проектов и служб вашего приложения.
- AspireSample.ServiceDefaults: совместный проект .NET.NET Aspire для управления конфигурациями, которые повторно используются в проектах, связанных с устойчивостью , обнаружением служб и телеметрией в вашем решении.

.NET .NET Aspire Starter App: помимо проектов .AppHost и .ServiceDefaults, Starter App .NET.NET Aspire также включает в себя следующее:
- AspireSample.ApiService: проект ASP.NET Core минимального API используется для предоставления данных фронтенду. Этот проект зависит от общего проекта AspireSample.ServiceDefaults.
- AspireSample.Web: проект приложения с конфигурациями службы по умолчанию, этот проект зависит от проекта AspireSample.ServiceDefaults.
- AspireSample.Test: либо тестовый проект MSTest, NUnitили xUnit со ссылками на проект AspireSample.AppHost и примером файла WebTests.cs, демонстрирующего интеграционный тест.

Шаблоны проектов

Доступны следующие .NET.NET Aspire шаблоны проектов:

.NET .NET Aspire App Host: автономный проект .AppHost, который можно использовать для оркестрации и управления различными проектами и службами вашего приложения.

.NET .NET Aspire тестовые проекты: эти шаблоны проектов используются для создания тестовых проектов для приложения .NET.NET Aspire, и они предназначены для проведения функциональных и интеграционных тестов. Тестовые проекты включают следующие шаблоны:
- MSTest: проект, содержащий интеграцию MSTest проекта .NET.NET Aspire AppHost.
- NUnit: проект, содержащий интеграцию NUnit с проектом .NET.NET Aspire AppHost.
- xUnit: проект, содержащий интеграцию xUnit.net проекта .NET.NET Aspire AppHost.
Дополнительные сведения о шаблонах тестов см. в разделе Тестирование в .NET.NET Aspire.

.NET .NET Aspire Настройки службы по умолчанию: автономный проект . ServiceDefaults, который можно использовать для управления конфигурациями, используемыми повторно в проектах вашего решения, связанных с устойчивостью, обнаружением служби телеметрией.

Важный

Шаблон проекта службы по умолчанию принимает зависимость FrameworkReference от Microsoft.AspNetCore.App. Это может быть не идеально подходит для некоторых типов проектов. Дополнительные сведения см. в разделе .NET.NET Aspireслужбы по умолчанию.

Создание решений и проектов с помощью шаблонов

Чтобы создать решение или проект .NET Aspire, используйте Visual Studio, Visual Studio Codeили интерфейс командной строки .NET, основываясь на доступных шаблонах. Изучите дополнительные шаблоны .NET.NET Aspire в репозитории образцов .NET.NET Aspire.

Чтобы создать проект .NET Aspire с помощью Visual Studio, найдите Aspire в окне нового проекта Visual Studio и выберите нужный шаблон.

Следуйте инструкциям, чтобы настроить проект или решение из шаблона, а затем выберите Создать.

Чтобы создать проект .NET Aspire с помощью Visual Studio Code, найдите Aspire в окне нового проекта Visual Studio Code и выберите нужный шаблон.

Выберите нужное местоположение, введите имя и выберите Создать.

Чтобы создать решение или проект .NET Aspire с использованием интерфейса командной строки .NET, воспользуйтесь командой dotnet new и укажите шаблон, который хотите создать. Рассмотрим следующие примеры:

Чтобы создать базовый проект хостинга приложения .NET.NET Aspire, с последней версией .NET:

dotnet new aspire-apphost

Чтобы создать стартовое приложение .NET.NET Aspire, которое является полным решением с примером пользовательского интерфейса и включённым API для поддержки:

dotnet new aspire-starter

Совет

.NET Aspire шаблоны по умолчанию используют последнюю версию .NET, даже если используется более ранняя версия интерфейса командной строки .NET. Чтобы вручную указать версию .NET, используйте параметр --framework <tfm>. Например, чтобы создать базовый проект хоста приложения .NET.NET Aspire для .NET 8:

dotnet new aspire-apphost --framework net8.0

См. также

.NET .NET Aspire SDK
.NET .NET Aspire настройка и инструменты
тестирование в .NET.NET Aspire

Поделиться через