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

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

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

  1. Откройте Visual Studio.
  2. Перейдите к Tools>Диспетчер пакетов NuGet>Консоль диспетчера пакетов.
  3. Выполните следующую команду, чтобы установить шаблоны:
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.3.0

Совет

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

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

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

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

Visual Studio: шаблоны .NET Aspire.

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

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

Visual Studio Code: шаблоны .NET Aspire.

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

Чтобы создать решение или проект .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

Перед запуском приложения необходимо доверять сертификату ASP.NET Corelocalhost. Выполните следующую команду:

dotnet dev-certs https --trust

Дополнительные сведения см. в статье Устранение неполадок с ненадежным сертификатом localhost в .NET Aspire. Подробные сведения об устранении неполадок с сертификатами localhost на Linuxсм. в статье ASP.NET Core: проблема с репозиторием GitHub #32842.

См. также