Bagikan melalui

.NET .NET Aspire SDK

  • Artikel

SDK .NET.NET Aspire dirancang untuk proyek *.AppHost, yang berfungsi sebagai orkestrator .NET.NET Aspire. Proyek-proyek ini ditunjuk menggunakan properti <IsAspireHost>true</IsAspireHost>, serta menentukan Aspire.AppHost.Sdk dalam file proyek. SDK menyediakan serangkaian fitur yang menyederhanakan pengembangan aplikasi .NET.NET Aspire.

Ikhtisar

📦 Aspire.AppHost.Sdk adalah SDK proyek MSBuild tambahan untuk membangun aplikasi .NET.NET Aspire. Aspire.AppHost.Sdk didefinisikan dengan Project/Sdksebagai tingkat tertinggi.

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

Contoh proyek sebelumnya mendefinisikan SDK tingkat atas sebagai Microsoft.NET.Sdk dan Aspire.AppHost.Sdk sebagai SDK aditif. Properti IsAspireHost diatur ke true untuk menunjukkan bahwa proyek ini adalah host aplikasi .NET.NET Aspire. Proyek ini juga mereferensikan paket Aspire.Hosting.AppHost yang membawa sejumlah dependensi terkait Aspire.

Fitur SDK

SDK .NET.NET Aspire menyediakan beberapa fitur utama.

Referensi proyek

Setiap dalam proyek host aplikasi tidak diperlakukan sebagai referensi proyek standar. Sebaliknya, mereka memungkinkan host aplikasi untuk menjalankan proyek-proyek ini sebagai bagian dari orkestrasinya. Setiap referensi proyek memicu generator untuk menghasilkan class yang menggambarkan proyek sebagai IProjectMetadata. Metadata ini digunakan untuk mengisi proyek bernama di namespace Projects yang dihasilkan. Saat Anda memanggil API Aspire.Hosting.ProjectResourceBuilderExtensions.AddProject, namespace Projects digunakan untuk mereferensikan proyek—meneruskan kelas yang dihasilkan sebagai parameter jenis generik.

Saran

Jika Anda perlu mereferensikan proyek dengan cara trandisional dalam host aplikasi, atur atribut IsAspireProjectResource pada elemen ProjectReference ke false, seperti yang ditunjukkan dalam contoh berikut:

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

Dependensi orkestrator

SDK .NET.NET Aspire menambahkan referensi secara dinamis ke dasbor .NET.NET Aspire dan dependensi host aplikasi lainnya, seperti paket sarana kontrol pengembang (DCP). Dependensi ini khusus untuk platform tempat host aplikasi dibangun.

Saat proyek host aplikasi berjalan, orkestrator bergantung pada dependensi ini untuk menyediakan fungsionalitas yang diperlukan ke host aplikasi. Untuk informasi selengkapnya, lihat gambaran umum orkestrasi .NET.NET Aspire.