pakiet SDK .NET.NET Aspire

Zestaw SDK .NET.NET Aspire jest przeznaczony dla projektów *.AppHost, które pełnią rolę orkiestratora .NET.NET Aspire. Projekty te są oznaczane przy użyciu właściwości <IsAspireHost>true</IsAspireHost> oraz przez określenie Aspire.AppHost.Sdk w pliku projektu. Zestaw SDK udostępnia zestaw funkcji, które upraszczają tworzenie aplikacji .NET.NET Aspire.

Przegląd

📦 Aspire. AppHost.Sdk to zestawu SDK projektu MSBuild do tworzenia aplikacji .NET.NET Aspire. Aspire.AppHost.Sdk jest definiowana przy użyciu Project/Sdknajwyższego poziomu:

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

Powyższy przykładowy projekt definiuje główny zestaw SDK jako Microsoft.NET.Sdk i Aspire.AppHost.Sdk jako dodatkowy zestaw SDK. Właściwość IsAspireHost jest ustawiona na true, aby wskazać, że ten projekt jest hostem aplikacji .NET.NET Aspire. Projekt odwołuje się również do pakietu Aspire.Hosting.AppHost, który zawiera wiele Aspire- powiązanych zależności.

Funkcje zestawu SDK

Zestaw SDK .NET.NET Aspire udostępnia kilka kluczowych funkcji.

Referencje projektowe

Każda ProjectReference w projekcie hosta aplikacji .NET.NET Aspire nie jest traktowana jako standardowe referencje projektowe. Zamiast tego umożliwiają hostowi aplikacji wykonywanie tych projektów jako część jej orkiestracji. Każda referencja do projektu wyzwala generator do stworzenia class, który reprezentuje projekt jako IProjectMetadata. Te metadane służą do wypełniania nazwanych projektów w wygenerowanej przestrzeni nazw Projects. Podczas wywoływania interfejsu API Aspire.Hosting.ProjectResourceBuilderExtensions.AddProject przestrzeń nazw Projects jest używana do odwoływania się do projektu — przekazując wygenerowaną klasę jako parametr typu ogólnego.

Napiwek

Jeśli musisz odwołać się do projektu w sposób tradycyjny na hoście aplikacji, ustaw atrybut IsAspireProjectResource w elemencie ProjectReference na false, jak pokazano w poniższym przykładzie:

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

Zależności programu Orchestrator

Zestaw SDK .NET.NET Aspire dynamicznie dodaje odwołania do pulpitu nawigacyjnego .NET.NET Aspire i innych zależności hosta aplikacji, takich jak pakiety płaszczyzny sterowania dla dewelopera (DCP). Te zależności są specyficzne dla platformy, na którą jest oparty host aplikacji.

Po uruchomieniu projektu hosta aplikacji, orkiestrator opiera się na tych zależnościach w celu dostarczania niezbędnej funkcjonalności do hosta aplikacji. Aby uzyskać więcej informacji, zobacz omówienie orkiestracji .NET.NET Aspire.