Bagikan melalui


Menggunakan MSBuild API

MSBuild menyediakan permukaan API publik sehingga program Anda dapat melakukan build dan memeriksa proyek. Versi terbaru API MSBuild dapat ditemukan dalam paket NuGet berikut:

Nama paket Deskripsi
Microsoft.Build Berisi rakitan Microsoft.Build yang digunakan untuk membuat, mengedit, dan mengevaluasi proyek MSBuild.
Microsoft.Build.Framework Berisi rakitan kerangka kerja MSBuild umum yang digunakan oleh rakitan MSBuild lainnya.
Microsoft.Build.Runtime Memberikan salinan lengkap MSBuild yang dapat dieksekusi. Referensikan paket ini hanya jika aplikasi Anda perlu memuat proyek atau menjalankan build dalam proses tanpa memerlukan penginstalan MSBuild. Berhasil mengevaluasi proyek menggunakan paket ini memerlukan agregasi komponen tambahan (seperti kompilator) ke dalam direktori aplikasi.
Microsoft.Build.Tasks.Core Berisi rakitan Microsoft.Build.Tasks yang mengimplementasikan tugas MSBuild yang umum digunakan.
Microsoft.Build.Utilities.Core Berisi rakitan Microsoft.Build.Utilities yang digunakan untuk menerapkan tugas MSBuild kustom.

Selain itu, NuGet juga menghosting perakitan warisan, Microsoft.Build.Engine, yang tidak digunakan lagi.

Ada beberapa versi berbeda dari MSBuild API, dan untuk versi 15 dan 16, ada dua bentuk rakitan yang berbeda dalam paket NuGet, satu dikompilasi dengan .NET Framework, dan yang lain dikompilasi dengan .NET Core, yang merupakan subset dari permukaan .NET Framework API. MSBuild versi .NET Core digunakan saat Anda memanggil dotnet perintah, dan saat menggunakan MSBuild pada sistem Mac dan Linux.

Dokumentasi untuk MSBuild API dapat ditemukan dengan menggunakan .NET API Browser, atau dengan menelusuri namespace layanan dalam daftar berikut.

Namespace Berlaku Pada Deskripsi
Microsoft.Build.Construction Semua Berisi jenis yang digunakan model objek MSBuild untuk membangun akar proyek dengan nilai yang tidak dievaluasi. Setiap akar proyek sesuai dengan proyek atau file target.
Microsoft.Build.Definition Semua Berisi kelas ProjectOptions, yang mendukung konstruksi proyek.
Microsoft.Build.Evaluation Semua Berisi jenis yang digunakan model objek MSBuild untuk mengevaluasi proyek. Setiap proyek dikaitkan dengan satu atau beberapa akar proyek.
Microsoft.Build.Evaluation.Context Semua EvaluationContext Berisi kelas , yang digunakan untuk menyimpan status evaluasi di seluruh panggilan.
Microsoft.Build.Exceptions Semua Berisi jenis pengecualian yang mungkin dilemparkan selama proses build.
Microsoft.Build.Execution Semua Berisi jenis yang digunakan model objek MSBuild untuk membangun proyek.
Microsoft.Build.Framework Semua Berisi jenis yang menentukan bagaimana tugas dan pencatat berinteraksi dengan mesin MSBuild.
Microsoft.Build.Framework.Profiler Semua Berisi jenis yang mendukung pembuatan profil performa.
Microsoft.Build.Framework.XamlTypes .NET Framework saja Berisi kelas yang digunakan untuk mewakili jenis XAML yang diurai dari file, aturan, dan sumber lainnya.
Microsoft.Build.Globbing Semua Berisi kelas yang mendukung pemrosesan wildcard.
Microsoft.Build.Globbing.Extensions Semua Mengandung tipe yang mendukung ekstensi untuk pemrosesan wildcard.
Microsoft.Build.Graph Semua Berisi jenis yang mendukung sakelar -graph MSBuild.
Microsoft.Build.Logging Semua Berisi tipe yang digunakan untuk mencatat kemajuan build.
Microsoft.Build.ObjectModelRemoting Semua Berisi jenis yang mendukung remoting di MSBuild.
Microsoft.Build.Tasks Semua Berisi implementasi semua tugas pengiriman dengan MSBuild.
Microsoft.Build.Tasks.Deployment.Bootstrapper .NET Framework saja Berisi kelas yang digunakan secara internal oleh MSBuild.
Microsoft.Build.Tasks.Deployment.ManifestUtilities .NET Framework saja Berisi kelas yang digunakan MSBuild.
Microsoft.Build.Tasks.Hosting Semua Berisi kelas yang digunakan secara internal oleh MSBuild.
Microsoft.Build.Tasks.Xaml .NET Framework saja Berisi kelas yang terkait dengan tugas build XAML.
Microsoft.Build.Utilities Semua Berisi kelas pembantu yang dapat Anda gunakan untuk membuat pencatat dan tugas MSBuild Anda sendiri.

Dalam tabel sebelumnya, semua di kolom Berlaku Untuk berarti tipe-tipe di dalam namespace tersedia baik di versi .NET Framework dan versi .NET Core dari MSBuild API.

Pencari Lokasi MSBuild

MSBuild Locator adalah API yang dapat Anda gunakan untuk menemukan MSBuild pada komputer. Anda dapat menggunakannya dalam pengembangan alat build, saat Anda ingin menemukan versi MSBuild yang diinstal.

NuGetPackage ada di Microsoft.Build.Locator dan dokumentasi referensi ada di Microsoft.

Untuk informasi selengkapnya tentang MSBuildLocator, lihat Menemukan dan menggunakan versi MSBuild.