Paketüberprüfung

Mit paketüberprüfungstools können Sie als Bibliotheksentwickler überprüfen, ob Ihre Pakete konsistent und wohlgeformt sind. Es stellt die folgenden Prüfungen bereit:

• Überprüft, dass keine kompatibilitätsbrüche zwischen den Versionen existieren.
• Überprüft, ob das Paket über den gleichen Satz öffentlicher APIs für alle verschiedenen laufzeitspezifischen Implementierungen verfügt.
• Fängt alle Anwendbarkeitslöcher auf.

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 packbar ist, verwenden Sie stattdessen die Assemblyüberprüfung .

MSBuild-Aufgabe aktivieren

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

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

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

</Project>

EnablePackageValidation führt eine Reihe von Prüfungen nach der Pack Aufgabe aus. Es gibt einige zusätzliche Überprüfungen, die ausgeführt werden können, indem andere MSBuild-Eigenschaften festgelegt werden. Weitere Informationen finden Sie unter Paketüberprüfungseigenschaften.

Validatortypen

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

• Der Validator der Basisversion überprüft Ihr Bibliotheksprojekt anhand einer zuvor veröffentlichten stabilen Version Ihres Pakets.
• Der kompatible Laufzeit-Validator überprüft, ob Ihre laufzeitspezifischen Implementierungsassemblys miteinander und mit den Kompilierungszeitassemblys kompatibel sind.
• Der Kompatible Framework-Validator überprüft, ob Code, der mit einem Framework kompiliert wurde, für alle anderen in einem Multi-Targeting-Paket ausgeführt werden kann.

Kompatibilitätswarnungen unterdrücken

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

Siehe auch

• Eigenschaften der Paketüberprüfung