Freigeben über


Paketüberprüfung

Mit Paketüberprüfungstools können Sie als Bibliotheksentwickler*in überprüfen, ob Ihre Pakete konsistent und wohlgeformt sind. Mit diesen Tools sind folgende Überprüfungen möglich:

  • Überprüfung, ob keine versionsübergreifenden Breaking Changes vorhanden sind
  • Überprüfung, ob das Paket über dieselben öffentlichen APIs für die verschieden laufzeitspezifischen Implementierungen verfügt.
  • Findet alle Lücken in der Anwendbarkeit.

Sie können die Paketüberprüfung entweder als MSBuild-Aufgabe oder mit dem globalen Tool Microsoft.DotNet.ApiCompat.Tool ausführen. Wenn Ihre App nicht gepackt werden kann, verwenden Sie stattdessen die Assemblyüberprüfung.

MSBuild-Aufgabe aktivieren

Aktivieren Sie die Paketüberprüfung in Ihrem .NET-Projekt, indem Sie die EnablePackageValidation-Eigenschaft auf true festlegen.

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

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

</Project>

EnablePackageValidation führt eine Reihe von Überprüfungen nach dem Task Pack aus. Es gibt einige zusätzliche Überprüfungen, die durch Festlegen anderer MSBuild-Eigenschaften ausgeführt werden können. Weitere Informationen finden Sie unter Eigenschaften der Paketüberprüfung.

Typen von Validierungssteuerelementen

Es gibt drei verschiedene Validierungssteuerelemente, die Ihr Paket als Teil der Pack-Aufgabe überprüfen:

Kompatibilitätswarnungen unterdrücken

Informationen zum Unterdrücken von Kompatibilitätswarnungen finden Sie unter Unterdrücken.