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

Aspire Шаблоны

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

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

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

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

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

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

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

  • Aspire Пустое приложение: минимальный Aspire проект, который включает в себя следующее:

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

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

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

  • Aspire Тестовые проекты: эти шаблоны проектов используются для создания тестовых проектов для приложения Aspire , и они предназначены для представления функциональных и интеграции тестов. Тестовые проекты включают следующие шаблоны:

    • MSTest: проект, содержащий интеграцию Aspire MSTest проекта AppHost.
    • NUnit: проект, содержащий интеграцию Aspire NUnit проекта AppHost.
    • xUnit: проект, содержащий xUnit.net интеграцию Aspire проекта AppHost.

    Дополнительные сведения о шаблонах тестов см. в Aspireразделе "Тестирование".

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

    Важный

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

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

Чтобы установить шаблоны 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 или более поздней версии автоматически устанавливаются шаблоны Aspire.

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

dotnet new install Aspire.ProjectTemplates

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

dotnet new install Aspire.ProjectTemplates::9.4.0

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

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

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

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

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

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

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

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

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

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

dotnet new aspire-apphost

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

dotnet new aspire-starter

Совет

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

dotnet new aspire-apphost --framework net8.0

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

dotnet dev-certs https --trust

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

См. также

  • Last updated on