Partilhar via

.NET .NET Aspire SDK

  • Artigo

O SDK .NET.NET Aspire destina-se a *. AppHost projetos, que servem como o .NET.NET Aspire orquestrador. Esses projetos são designados usando a propriedade <IsAspireHost>true</IsAspireHost>, bem como especificando o Aspire.AppHost.Sdk no arquivo de projeto. O SDK fornece um conjunto de recursos que simplificam o desenvolvimento de aplicativos .NET.NET Aspire.

Visão geral

O . O AppHost.Sdk é um SDK de projeto MSBuild para criar aplicativos . O Aspire.AppHost.Sdk é definido com um Project/Sdkde nível mais elevado:

<Project Sdk="Microsoft.NET.Sdk">

    <Sdk Name="Aspire.AppHost.Sdk" Version="9.0.0" />
    
    <PropertyGroup>
        <OutputType>Exe</OutputType>
        <TargetFramework>net9.0</TargetFramework>
        <IsAspireHost>true</IsAspireHost>
        <!-- Omitted for brevity -->
    </PropertyGroup>
    
    <ItemGroup>
        <PackageReference Include="Aspire.Hosting.AppHost" Version="9.0.0" />
    </ItemGroup>

    <!-- Omitted for brevity -->
</Project>

O projeto de exemplo anterior define o SDK de nível superior como Microsoft.NET.Sdk e o Aspire.AppHost.Sdk como um SDK aditivo. A propriedade IsAspireHost é definida como true para indicar que este projeto é um host de aplicativo .NET.NET Aspire. O projeto também faz referência ao pacote Aspire.Hosting.AppHost que traz uma série de dependências relacionadas à Aspire.

Recursos do SDK

O .NET.NET Aspire SDK fornece vários recursos importantes.

Referências do projeto

Cada ProjectReference no .NET.NET Aspire aplicativo host projeto não é tratada como referências de projeto padrão. Em vez disso, eles permitem que o anfitrião do aplicativo ,, execute esses projetos como parte da sua orquestração. Cada referência de projeto aciona um gerador para criar um class que representa o projeto como um IProjectMetadata. Esses metadados são usados para preencher os projetos nomeados no namespace Projects gerado. Quando você chama a API Aspire.Hosting.ProjectResourceBuilderExtensions.AddProject, o namespace Projects é usado para fazer referência ao projeto — passando a classe gerada como um parâmetro de tipo genérico.

Dica

Se você precisar fazer referência a um projeto de forma trandicional dentro do host do aplicativo, defina o atributo IsAspireProjectResource no elemento ProjectReference como false, conforme mostrado no exemplo a seguir:

<ProjectReference Include="..\MyProject\MyProject.csproj" IsAspireProjectResource="false" />

Dependências do orquestrador

O SDK do .NET.NET Aspire adiciona dinamicamente referências ao painel .NET.NET Aspire e a outras dependências do host do aplicativo, como os pacotes do plano de controlo do desenvolvedor (DCP). Essas dependências são específicas da plataforma na qual o host do aplicativo é criado.

Quando o projeto do host da aplicação é executado, o orquestrador recorre a estas dependências para fornecer a funcionalidade necessária ao host da aplicação. Para obter mais informações, consulte .NET.NET Aspire visão geral da orquestração.