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

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

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

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

Шаблоны .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.

dotnet new aspire-apphost

dotnet new aspire-starter

dotnet new aspire-apphost --framework net8.0

См. также

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