.NET .NET Aspire SDK

Sada .NET.NET Aspire SDK je určena pro projekty *.AppHost, které slouží jako orchestrátor .NET.NET Aspire. Tyto projekty jsou určeny pomocí vlastnosti <IsAspireHost>true</IsAspireHost> a také určují Aspire.AppHost.Sdk v souboru projektu. Sada SDK poskytuje sadu funkcí, které zjednodušují vývoj aplikací .NET.NET Aspire.

Přehled

📦 Aspire. AppHost.Sdk je doplňková sada SDK projektu MSBuild pro vytváření aplikací .NET.NET Aspire. Aspire.AppHost.Sdk je definován pomocí nejvyšší úrovně Project/Sdk:

<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>

Předchozí ukázkový projekt definuje sadu SDK nejvyšší úrovně jako Microsoft.NET.Sdk a Aspire.AppHost.Sdk jako doplňkovou sadu SDK. Vlastnost IsAspireHost je nastavená na true označující, že tento projekt je hostitelem aplikace .NET.NET Aspire. Projekt také odkazuje na balíček Aspire.Hosting.AppHost, který přináší řadu závislostí souvisejících s Aspire.

Funkce sady SDK

Sada .NET.NET Aspire SDK poskytuje několik klíčových funkcí.

Odkazy na projekt

Každý ProjectReference v hostitelském projektu aplikace .NET.NET Aspire se nepočítá jako standardní odkaz na projekt. Místo toho umožňují hostiteli aplikace tyto projekty spouštět v rámci orchestrace. Každý odkaz na projekt aktivuje generátor, který vytvoří class představující projekt jako IProjectMetadata. Toto metadat slouží k naplnění pojmenovaných projektů ve vygenerovaném jmenném prostoru Projects. Při volání rozhraní Aspire.Hosting.ProjectResourceBuilderExtensions.AddProject API se k odkazování na projekt použije obor názvů Projects – předá vygenerovanou třídu jako parametr obecného typu.

Tip

Pokud potřebujete odkazovat na projekt v rámci hostitele aplikace, nastavte atribut IsAspireProjectResource prvku ProjectReference na false, jak je znázorněno v následujícím příkladu:

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

Závislosti orchestrátoru

Sada .NET.NET Aspire SDK dynamicky přidává odkazy na řídicí panel .NET.NET Aspire a další závislosti hostitele aplikací, jako jsou balíčky roviny řízení pro vývojáře (DCP). Tyto závislosti jsou specifické pro platformu, na které je hostitel aplikace postaven.

Při spuštění hostitelského projektu aplikace orchestrátor spoléhá na tyto závislosti, aby hostiteli aplikace poskytl potřebné funkce. Další informace naleznete v části .NET.NET Aspire Přehled orchestrace.