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:

• Das Validierungssteuerelement der Baselineversion überprüft Ihr Bibliotheksprojekt anhand einer zuvor veröffentlichten, stabilen Version Ihres Pakets.
• Das Validierungssteuerelement für die kompatible Runtime überprüft, ob Ihre runtimespezifischen Implementierungsassemblys miteinander und mit den Kompilierzeitassemblys kompatibel sind.
• Das Validierungssteuerelement für kompatible Frameworks überprüft, ob der für ein Framework kompilierte Code für alle anderen in einem Paket mit mehreren Zielen ausgeführt werden kann.

Kompatibilitätswarnungen unterdrücken

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