.NET .NET Aspire SDK

A .NET.NET Aspire SDK *.AppHostprojektekhez készült, amelyek .NET.NET Aspire vezénylőként szolgálnak. Ezek a projektek a <IsAspireHost>true</IsAspireHost> tulajdonság használatával vannak meghatározva, valamint a Aspire.AppHost.Sdk meghatározásával a projektfájlban. Az SDK számos olyan funkciót biztosít, amelyek leegyszerűsítik .NET.NET Aspire alkalmazások fejlesztését.

Áttekintés

A 📦Aspire. Az AppHost.Sdk egy additív MSBuild project SDK.NET.NET Aspire alkalmazásoklétrehozásához. A Aspire.AppHost.Sdk-t egy felső szintű Project/Sdkdefiniálja.

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

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

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

Az előző példaprojekt a legfelső szintű SDK-t Microsoft.NET.Sdk, a Aspire.AppHost.Sdk pedig additív SDK-ként határozza meg. A IsAspireHost tulajdonság értéke true, jelezve, hogy ez a projekt egy .NET.NET Aspire alkalmazásgazda. A projekt a Aspire.Hosting.AppHost csomagra is hivatkozik, amely számos Aspirekapcsolódó függőséget hoz létre.

SDK-funkciók

A .NET.NET Aspire SDK számos kulcsfontosságú funkciót kínál.

Projekthivatkozások

A .NET.NET Aspire alkalmazásgazda projekt-ben lévő ProjectReference nem minősül standard projekthivatkozásnak. Ehelyett engedélyezik, hogy a alkalmazásgazda hajtsa végre ezeket a projekteket a vezénylés részeként. Minden projekthivatkozás aktivál egy generátort, amely létrehoz egy class-t, ami a projektet IProjectMetadata-ként jelöli. Ez a metaadatok a létrehozott Projects névtérben lévő elnevezett projektek feltöltésére szolgálnak. Amikor meghívja a Aspire.Hosting.ProjectResourceBuilderExtensions.AddProject API-t, a Projects névtér használatával hivatkozik a projektre – a generált osztályt általános típusú paraméterként adja át.

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

Orchestrátor függőségek

A .NET.NET Aspire SDK dinamikusan ad hozzá hivatkozásokat az .NET.NET Aspire irányítópult és más alkalmazásgazda függőségeihez, például a fejlesztői vezérlősík -csomagokhoz. Ezek a függőségek arra a platformra vonatkoznak, amelyekre az alkalmazásgazda épül.

Az alkalmazásgazda projekt futtatásakor a vezénylő ezekre a függőségekre támaszkodik, hogy biztosítsa a szükséges funkciókat az alkalmazásgazda számára. További információkért lásd a .NET.NET Aspire orchestráció áttekintését.