Aracılığıyla paylaş


.NET .NET Aspire SDK

.NET .NET Aspire SDK'sı * için tasarlanmıştır. AppHost projeleri, .NET.NET Aspire düzenleyici olarak hizmet veren. Bu projeler, <IsAspireHost>true</IsAspireHost> özelliği kullanılarak ve proje dosyasındaki Aspire.AppHost.Sdk belirterek belirlenir. SDK, .NET.NET Aspire uygulamalarının geliştirilmesini basitleştiren bir dizi özellik sağlar.

Genel bakış

. AppHost.Sdk, ek bir MSBuild proje SDK'sı olarak uygulamaları oluşturmaya yöneliktir. Aspire.AppHost.Sdk bir üst düzey Project/Sdkile tanımlanır:

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

Yukarıdaki örnek proje, üst düzey SDK'yi Microsoft.NET.Sdk ve Aspire.AppHost.Sdk bir ekleme SDK'sı olarak tanımlar. bu projenin bir .NET.NET Aspire uygulama konağı olduğunu belirtmek için IsAspireHost özelliği true olarak ayarlanır. Proje ayrıca bir dizi Aspireile ilgili bağımlılığı içeren Aspire.Hosting.AppHost paketine başvurur.

SDK Özellikleri

.NET .NET Aspire SDK'sı çeşitli temel özellikler sağlar.

Proje referansları

.NET .NET Aspire uygulama konağı projesindeki her ProjectReference standart proje referansları olarak değerlendirilmez. Bunun yerine, uygulama konağı koordinesinin bir parçası olarak bu projeleri yürütmesini sağlar. Her proje referansı, projeyi IProjectMetadataolarak temsil eden bir class oluşturmak için bir jeneratörü tetikler. Bu meta veriler, oluşturulan Projects ad alanında adlandırılmış projeleri doldurmak için kullanılır. Aspire.Hosting.ProjectResourceBuilderExtensions.AddProject API'sini çağırdığınızda, oluşturulan sınıfı genel tür parametresi olarak geçirerek projeye başvurmak için Projects ad alanı kullanılır.

İpucu

Uygulama konağında bir projeye geleneksel şekilde başvurmanız gerekiyorsa, aşağıdaki örnekte gösterildiği gibi ProjectReference öğesi üzerindeki IsAspireProjectResource özniteliğini falseolarak ayarlayın.

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

Orchestrator bağımlılıkları

.NET .NET Aspire SDK'sı, .NET.NET Aspire pano ve geliştirici kontrol düzlemi (DCP) paketleri gibi diğer uygulama sunucusu bağımlılıklarına dinamik olarak başvurular ekler. Bu bağımlılıklar, uygulama konağı üzerinde oluşturulan platforma özgüdür.

Uygulama konağı projesi çalıştırıldığında, düzenleyici, uygulama konağına gerekli işlevselliği sağlamak için bu bağımlılıklara dayanır. Daha fazla bilgi için bkz. .NET.NET Aspire düzenlemeye genel bakış.