.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/Sdk
definiá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.
Borravaló
Ha az alkalmazás gazdagépen tradicionális módon kell hivatkoznia egy projektre, állítsa a ProjectReference
elem IsAspireProjectResource
attribútumát false
értékre, ahogyan az az alábbi példában látható.
<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.