Paketverifiering

Med verktyg för paketverifiering kan du som biblioteksutvecklare verifiera att paketen är konsekventa och välformulerade. Den innehåller följande kontroller:

• Verifierar att det inte finns några icke-bakåtkompatibla ändringar i olika versioner.
• Verifierar att paketet har samma uppsättning offentliga API:er för alla olika körningsspecifika implementeringar.
• Fångar eventuella tillämplighetshål.

Du kan köra paketverifiering antingen som en MSBuild-uppgift eller med hjälp av det globala verktyget Microsoft.DotNet.ApiCompat.Tool. Om din app inte är packbar använder du sammansättningsverifiering i stället.

Aktivera MSBuild-uppgift

Du aktiverar paketverifiering i .NET-projektet genom att ange EnablePackageValidation egenskapen till true.

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

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

</Project>

EnablePackageValidation kör en serie kontroller efter Pack aktiviteten. Det finns några ytterligare kontroller som kan köras genom att ange andra MSBuild-egenskaper. Mer information finns i Egenskaper för paketverifiering.

Valideringstyper

Det finns tre olika validatorer som verifierar paketet som en del av Pack uppgiften:

• Validatorn för originalversion validerar biblioteksprojektet mot en tidigare utgiven, stabil version av paketet.
• Den kompatibla körningsverifieraren verifierar att dina körningsspecifika implementeringssammansättningar är kompatibla med varandra och med kompileringstidssammansättningarna.
• Validatorn Kompatibelt ramverk verifierar att kod som kompilerats mot ett ramverk kan köras mot alla andra i ett paket med flera mål.

Ignorera kompatibilitetsvarningar

Information om hur du undertrycker kompatibilitetsvarningar finns i Så här utelämnar du.