templat .NET.NET Aspire
Ada sejumlah templat proyek .NET.NET Aspire tersedia untuk Anda. Anda dapat menggunakan templat ini untuk membuat solusi .NET Aspire penuh, atau menambahkan proyek individual ke solusi .NET Aspire yang ada.
Templat .NET.NET Aspire tersedia di 📦Aspire. ProjectTemplates paket NuGet.
Templat yang tersedia
Templat .NET Aspire memungkinkan Anda membuat aplikasi baru yang telah dikonfigurasi sebelumnya dengan struktur solusi .NET Aspire dan pengaturan default. Proyek-proyek ini juga memberikan pengalaman penelusuran kesalahan terpadu di berbagai sumber daya aplikasi Anda.
.NET .NET Aspire templat tersedia dalam dua kategori: templat solusi dan templat proyek. Templat solusi membuat solusi .NET Aspire baru dengan beberapa proyek, sementara templat proyek membuat proyek individual yang dapat ditambahkan ke solusi .NET Aspire yang ada.
Templat solusi
Templat solusi .NET.NET Aspire berikut tersedia, asumsikan solusi diberi nama AspireSample:
.NET .NET Aspire Aplikasi Kosong : Proyek .NET.NET Aspire minimal yang mencakup hal-hal berikut:
- AspireSample.AppHost: Proyek orkestrator yang dirancang untuk menyambungkan dan mengonfigurasi berbagai proyek dan layanan aplikasi Anda.
- AspireSample.ServiceDefaults: Proyek bersama .NET.NET Aspire untuk mengelola konfigurasi yang digunakan kembali di seluruh proyek dalam solusi Anda yang terkait dengan ketahanan, penemuan layanan, dan telemetri.
.NET .NET Aspire Starter App: Selain . AppHost dan . ServiceDefaults proyek, .NET.NET Aspire Starter App juga mencakup hal berikut:
- AspireSample.ApiService: Proyek ASP.NET Core digunakan untuk menyediakan data ke frontend. Proyek ini tergantung pada proyek bersama AspireSample.ServiceDefaults.
- AspireSample.Web: Proyek ASP.NET CoreBlazor dengan konfigurasi layanan .NET.NET Aspire default, proyek ini bergantung pada proyekAspireSample.ServiceDefaults.
- AspireSample.Test: Salah satu proyek pengujian MSTest, NUnit, atau xUnit dengan referensi proyek ke AspireSample.AppHost dan file contoh WebTests.cs yang menunjukkan pengujian integrasi.
Templat Proyek
Templat proyek .NET.NET Aspire berikut ini tersedia:
- .NET .NET Aspire App Host: Proyek .AppHost mandiri yang dapat digunakan untuk mengatur dan mengelola berbagai proyek dan layanan dari aplikasi Anda.
.NET .NET Aspire Proyek pengujian: Templat proyek ini digunakan untuk membuat proyek pengujian untuk aplikasi .NET.NET Aspire Anda, dan dimaksudkan untuk mewakili pengujian fungsi dan integrasi. Proyek pengujian mencakup templat berikut:
- MSTest: Proyek yang berisi integrasi MSTest dari proyek .NET.NET Aspire AppHost.
- NUnit: Proyek yang berisi integrasi NUnit dari proyek .NET.NET Aspire AppHost.
- xUnit : Proyek yang berisi integrasi xUnit.net proyek AppHost .NET.NET Aspire.
Untuk informasi selengkapnya tentang templat pengujian, lihat Pengujian di .NET.NET Aspire.
.NET .NET Aspire Pengaturan Bawaan Layanan: Sebuah proyek mandiri bernama .ServiceDefaults yang dapat digunakan untuk mengelola konfigurasi yang digunakan kembali di seluruh proyek dalam solusi Anda terkait dengan resiliensi, penemuan layanan, dan telemetri.
Penting
Templat proyek default layanan memiliki dependensi
FrameworkReference
padaMicrosoft.AspNetCore.App
. Ini mungkin tidak ideal untuk beberapa jenis proyek. Untuk informasi selengkapnya, lihat default layanan .NET.NET Aspire.
Membuat solusi dan proyek menggunakan templat
Untuk membuat solusi atau proyek .NET Aspire, gunakan Visual Studio, Visual Studio Code, atau CLI .NET, dan dasarkan pada templat yang tersedia. Jelajahi templat tambahan .NET.NET Aspire dalam repositori sampel .NET.NET Aspire.
Untuk membuat proyek .NET Aspire menggunakan Visual Studio, cari Aspire di jendela proyek baru Visual Studio dan pilih templat yang Anda inginkan.
Ikuti perintah untuk mengonfigurasi proyek atau solusi Anda dari templat, lalu pilih Buat.
Untuk membuat proyek .NET Aspire menggunakan Visual Studio Code, cari Aspire di jendela proyek baru Visual Studio Code dan pilih templat yang Anda inginkan.
Pilih lokasi yang diinginkan, masukkan nama, dan pilih Buat.
Untuk membuat solusi atau proyek .NET Aspire menggunakan CLI .NET, gunakan perintah baru dotnet dan tentukan templat mana yang ingin Anda buat. Pertimbangkan contoh berikut:
Untuk membuat proyek host aplikasi dasar .NET.NET Aspire yang menargetkan versi .NET terbaru:
dotnet new aspire-apphost
Untuk membuat aplikasi starter .NET.NET Aspire ini, yang merupakan solusi lengkap dengan antarmuka pengguna sampel dan API pendukung termasuk:
dotnet new aspire-starter
Saran
.NET Aspire template secara default menggunakan versi .NET terbaru, meskipun menggunakan versi CLI .NET yang lebih lama. Untuk menentukan versi .NET secara manual, gunakan opsi --framework <tfm>
, misalnya untuk membuat host aplikasi .NET.NET Aspire dasar proyek yang menargetkan .NET 8:
dotnet new aspire-apphost --framework net8.0
Lihat juga
.NET Aspire