.NET .NET Aspire SDK
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/Sdk
sebagai 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 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.
.NET Aspire