Bagikan melalui

Validasi paket

  • Artikel

Alat validasi paket memungkinkan Anda, sebagai pengembang pustaka, untuk memvalidasi bahwa paket Anda konsisten dan terbentuk dengan baik. Ini menyediakan pemeriksaan berikut:

  • Memvalidasi bahwa tidak ada perubahan yang melanggar di seluruh versi.
  • Memvalidasi bahwa paket memiliki sekumpulan API publik yang sama untuk semua implementasi khusus runtime yang berbeda.
  • Menangkap lubang penerapan apa pun.

Anda dapat menjalankan validasi paket baik sebagai tugas MSBuild atau menggunakan alat global Microsoft.DotNet.ApiCompat.Tool. Jika aplikasi Anda tidak dapat dikemas, gunakan validasi rakitan sebagai gantinya.

Aktifkan tugas MSBuild

Anda mengaktifkan validasi paket di proyek .NET Anda dengan mengatur EnablePackageValidation properti ke true.

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFrameworks>netstandard2.0;net6.0</TargetFrameworks>
    <EnablePackageValidation>true</EnablePackageValidation>
  </PropertyGroup>

</Project>

EnablePackageValidation menjalankan serangkaian pemeriksaan setelah Pack tugas. Ada beberapa pemeriksaan tambahan yang dapat dijalankan dengan mengatur properti MSBuild lainnya. Untuk informasi selengkapnya, lihat Properti validasi paket.

Jenis validator

Ada tiga validator berbeda yang memverifikasi paket Anda sebagai bagian Pack dari tugas:

  • Validator versi Garis Besar memvalidasi proyek pustaka Anda terhadap versi paket Anda yang dirilis sebelumnya dan stabil.
  • Validator runtime yang kompatibel memvalidasi bahwa rakitan implementasi khusus runtime Anda kompatibel satu sama lain dan dengan rakitan waktu kompilasi.
  • Validator kerangka kerja yang kompatibel memvalidasi bahwa kode yang dikompilasi terhadap satu kerangka kerja dapat berjalan terhadap semua kerangka kerja lainnya dalam paket multi-penargetan.

Menyembunyikan peringatan kompatibilitas

Untuk informasi tentang menekan peringatan kompatibilitas, lihat Cara menekan.